charts.d/postfix.chart.sh

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