charts.d/postfix.chart.sh

   1 # no need for shebang - this file is loaded from charts.d.plugin
   2
   3 # the postqueue command
   4 # if empty, it will use the one found in the system path
   5 postfix_postqueue=
   6
   7 # how frequently to collect queue size
   8 postfix_update_every=15
   9
  10 postfix_priority=60000
  11
  12 postfix_check() {
  13         # this should return:
  14         #  - 0 to enable the chart
  15         #  - 1 to disable the chart
  16
  17         # try to find the postqueue executable
  18         if [ -z "$postfix_postqueue" -o ! -x "$postfix_postqueue" ]
  19         then
  20                 postfix_postqueue="`which postqueue 2>/dev/null`"
  21         fi
  22
  23         if [ -z "$postfix_postqueue" -o ! -x  "$postfix_postqueue" ]
  24         then
  25                 error "cannot find postqueue. Please set 'postfix_postqueue=/path/to/postqueue' in $confd/postfix.conf"
  26                 return 1
  27         fi
  28
  29         return 0
  30 }
  31
  32 postfix_create() {
  33 cat <<EOF
  34 CHART postfix_local.qemails '' "Postfix Queue Emails" "emails" queue postfix.queued.emails line $((postfix_priority + 1)) $postfix_update_every
  35 DIMENSION emails '' absolute 1 1
  36 CHART postfix_local.qsize '' "Postfix Queue Emails Size" "emails size in KB" queue postfix.queued.size area $((postfix_priority + 2)) $postfix_update_every
  37 DIMENSION size '' absolute 1 1
  38 EOF
  39
  40         return 0
  41 }
  42
  43 postfix_update() {
  44         # the first argument to this function is the microseconds since last update
  45         # pass this parameter to the BEGIN statement (see bellow).
  46
  47         # do all the work to collect / calculate the values
  48         # for each dimension
  49         # remember: KEEP IT SIMPLE AND SHORT
  50
  51         # 1. execute postqueue -p
  52         # 2. get the line that begins with --
  53         # 3. match the 2 numbers on the line and output 2 lines like these:
  54         #    local postfix_q_size=NUMBER
  55         #    local postfix_q_emails=NUMBER
  56         # 4. then execute this a script with the eval
  57         #
  58         # be very carefull with eval:
  59         # prepare the script and always egrep at the end the lines that are usefull, so that
  60         # even if something goes wrong, no other code can be executed
  61         postfix_q_emails=0
  62         postfix_q_size=0
  63
  64         eval "$(run $postfix_postqueue -p |\
  65                 grep "^--" |\
  66                 sed -e "s/-- \([0-9]\+\) Kbytes in \([0-9]\+\) Requests.$/local postfix_q_size=\1\nlocal postfix_q_emails=\2/g" |\
  67                 egrep "^local postfix_q_(emails|size)=[0-9]+$")"
  68
  69         # write the result of the work.
  70         cat <<VALUESEOF
  71 BEGIN postfix_local.qemails $1
  72 SET emails = $postfix_q_emails
  73 END
  74 BEGIN postfix_local.qsize $1
  75 SET size = $postfix_q_size
  76 END
  77 VALUESEOF
  78
  79         return 0
  80 }