plugins.d/alarm-notify.sh

   1 #!/usr/bin/env bash
   2
   3 # (C) Costa Tsaousis
   4 # pushover support by Jan Arnold
   5
   6 me="${0}"
   7
   8 # -----------------------------------------------------------------------------
   9 # parse command line parameters
  10
  11 recipient="${1}"   # the recepient of the email
  12 hostname="${2}"    # the hostname this event refers to
  13 unique_id="${3}"   # the unique id of this event
  14 alarm_id="${4}"    # the unique id of the alarm that generated this event
  15 event_id="${5}"    # the incremental id of the event, for this alarm
  16 when="${6}"        # the timestamp this event occured
  17 name="${7}"        # the name of the alarm, as given in netdata health.d entries
  18 chart="${8}"       # the name of the chart (type.id)
  19 family="${9}"      # the family of the chart
  20 status="${10}"     # the current status : UNITIALIZED, UNDEFINED, CLEAR, WARNING, CRITICAL
  21 old_status="${11}" # the previous status: UNITIALIZED, UNDEFINED, CLEAR, WARNING, CRITICAL
  22 value="${12}"      # the current value
  23 old_value="${13}"  # the previous value
  24 src="${14}"        # the line number and file the alarm has been configured
  25 duration="${15}"   # the duration in seconds the previous state took
  26 non_clear_duration="${16}" # the total duration in seconds this is non-clear
  27 units="${17}"      # the units of the value
  28 info="${18}"       # a short description of the alarm
  29
  30 # -----------------------------------------------------------------------------
  31 # screen statuses we don't need to send a notification
  32
  33 # don't do anything if this is not WARNING, CRITICAL or CLEAR
  34 if [ "${status}" != "WARNING" -a "${status}" != "CRITICAL" -a "${status}" != "CLEAR" ]
  35 then
  36     echo >&2 "${me}: not sending notification for ${status} on '${chart}.${name}'"
  37     exit 1
  38 fi
  39
  40 # don't do anything if this is CLEAR, but it was not WARNING or CRITICAL
  41 if [ "${old_status}" != "WARNING" -a "${old_status}" != "CRITICAL" -a "${status}" = "CLEAR" ]
  42 then
  43     echo >&2 "${me}: not sending notification for ${status} on '${chart}.${name}' (last status was ${old_status})"
  44     exit 1
  45 fi
  46
  47 # -----------------------------------------------------------------------------
  48 # load configuration
  49
  50 # needed commands
  51 # if empty they will be searched in the system path
  52 curl=
  53 sendmail=
  54
  55 # enable / disable features
  56 SEND_EMAIL="YES"
  57 SEND_PUSHOVER="YES"
  58
  59 # pushover configs
  60 PUSHOVER_APP_TOKEN=
  61 DEFAULT_RECIPIENT_PUSHOVER=
  62 declare -A role_recipients_pushover=()
  63
  64 # email configs
  65 DEFAULT_RECIPIENT_EMAIL="root"
  66 declare -A role_recipients_email=()
  67
  68 if [ -f "${NETDATA_CONFIG_DIR}/health_alarm_notify.conf" ]
  69     then
  70     source "${NETDATA_CONFIG_DIR}/health_alarm_notify.conf"
  71 fi
  72
  73 # -----------------------------------------------------------------------------
  74 # find the exact recipient per method
  75
  76 to_email="${role_recipients_email[${recipient}]}"
  77 [ -z "${to_email}" ] && to_email="${DEFAULT_RECIPIENT_EMAIL}"
  78 [ -z "${to_email}" ] && to_email="root"
  79
  80 to_pushover="${role_recipients_pushover[${recipient}]}"
  81 [ -z "${to_pushover}" ] && to_pushover="${DEFAULT_RECIPIENT_EMAIL}"
  82 [ -z "${to_pushover}" ] && SEND_PUSHOVER="NO"
  83
  84 # -----------------------------------------------------------------------------
  85 # verify the delivery methods supported
  86
  87 [ -z "${PUSHOVER_APP_TOKEN}" ] && SEND_PUSHOVER="NO"
  88
  89 if [ "${SEND_PUSHOVER}" = "YES" -a -z "${curl}" ]
  90     then
  91     curl="$(which curl 2>/dev/null || command -v curl 2>/dev/null)"
  92     [ -z "${curl}" ] && SEND_PUSHOVER="NO"
  93 fi
  94
  95 if [ "${SEND_EMAIL}" = "YES" -a -z "${sendmail}" ]
  96     then
  97     sendmail="$(which sendmail 2>/dev/null || command -v sendmail 2>/dev/null)"
  98     [ -z "${sendmail}" ] && SEND_EMAIL="NO"
  99 fi
 100
 101 # check that we have at least a method enabled
 102 if [ "${SEND_EMAIL}" != "YES" -a "${SEND_PUSHOVER}" != "YES" ]
 103     then
 104     echo >&2 "I don't have a means to send a notification. Sorry!"
 105     exit 1
 106 fi
 107
 108 # -----------------------------------------------------------------------------
 109 # get the system hostname
 110
 111 [ -z "${hostname}" ] && hostname="${NETDATA_HOSTNAME}"
 112 [ -z "${hostname}" ] && hostname="${NETDATA_REGISTRY_HOSTNAME}"
 113 [ -z "${hostname}" ] && hostname="$(hostname 2>/dev/null)"
 114
 115 # -----------------------------------------------------------------------------
 116 # get the date the alarm happened
 117
 118 date="$(date --date=@${when} 2>/dev/null)"
 119 [ -z "${date}" ] && date="$(date 2>/dev/null)"
 120
 121 # -----------------------------------------------------------------------------
 122 # convert a duration in seconds, to a human readable duration
 123 # using DAYS, MINUTES, SECONDS
 124
 125 duration4human() {
 126     local s="${1}" d=0 h=0 m=0 ds="day" hs="hour" ms="minute" ss="second"
 127     d=$(( s / 86400 ))
 128     s=$(( s - (d * 86400) ))
 129     h=$(( s / 3600 ))
 130     s=$(( s - (h * 3600) ))
 131     m=$(( s / 60 ))
 132     s=$(( s - (m * 60) ))
 133
 134     if [ ${d} -gt 0 ]
 135     then
 136         [ ${m} -ge 30 ] && h=$(( h + 1 ))
 137         [ ${d} -gt 1 ] && ds="days"
 138         [ ${h} -gt 1 ] && hs="hours"
 139         if [ ${h} -gt 0 ]
 140         then
 141             echo "${d} ${ds} and ${h} ${hs}"
 142         else
 143             echo "${d} ${ds}"
 144         fi
 145     elif [ ${h} -gt 0 ]
 146     then
 147         [ ${s} -ge 30 ] && m=$(( m + 1 ))
 148         [ ${h} -gt 1 ] && hs="hours"
 149         [ ${m} -gt 1 ] && ms="minutes"
 150         if [ ${m} -gt 0 ]
 151         then
 152             echo "${h} ${hs} and ${m} ${ms}"
 153         else
 154             echo "${h} ${hs}"
 155         fi
 156     elif [ ${m} -gt 0 ]
 157     then
 158         [ ${m} -gt 1 ] && ms="minutes"
 159         [ ${s} -gt 1 ] && ss="seconds"
 160         if [ ${s} -gt 0 ]
 161         then
 162             echo "${m} ${ms} and ${s} ${ss}"
 163         else
 164             echo "${m} ${ms}"
 165         fi
 166     else
 167         [ ${s} -gt 1 ] && ss="seconds"
 168         echo "${s} ${ss}"
 169     fi
 170 }
 171
 172 # -----------------------------------------------------------------------------
 173 # email sender
 174
 175 send_email() {
 176     if [ "${SEND_EMAIL}" = "YES" ]
 177         then
 178
 179         "${sendmail}" -t
 180
 181         if [ $? -eq 0 ]
 182         then
 183             echo >&2 "${me}: Sent notification email for ${status} on '${chart}.${name}'"
 184             return 0
 185         else
 186             echo >&2 "${me}: FAILED to send notification email for ${status} on '${chart}.${name}'"
 187             return 1
 188         fi
 189     fi
 190
 191     return 1
 192 }
 193
 194 # -----------------------------------------------------------------------------
 195 # pushover sender
 196
 197 send_pushover() {
 198     local apptoken="${1}" usertoken="${2}" title="${3}" message="${4}" httpcode
 199
 200     if [ "${SEND_PUSHOVER}" = "YES" -a ! -z "${apptoken}" -a ! -z "${usertoken}" -a ! -z "${title}" -a ! -z "${message}" ]
 201         then
 202
 203         httpcode=$(${curl} --write-out %{http_code} --silent --output /dev/null \
 204             --form-string "token=${apptoken}" \
 205             --form-string "user=${usertoken}" \
 206             --form-string "html=1" \
 207             --form-string "title=${title}" \
 208             --form-string "message=${message}" \
 209             https://api.pushover.net/1/messages.json)
 210
 211         if [ "${httpcode}" == "200" ]
 212         then
 213             echo >&2 "${me}: Sent notification push for ${status} on '${chart}.${name}'"
 214             return 0
 215         else
 216             echo >&2 "${me}: FAILED to send notification push for ${status} on '${chart}.${name}' with HTTP error code ${httpcode}."
 217             return 1
 218         fi
 219     fi
 220
 221     return 1
 222 }
 223
 224
 225 # -----------------------------------------------------------------------------
 226 # prepare the content of the notification
 227
 228 # description of the alarm
 229 [ ! -z "${info}" ] && info=" <small><br/>${info}</small>"
 230
 231 # the url to send the user on click
 232 goto_url="${NETDATA_REGISTRY_URL}/goto-host-from-alarm.html?machine_guid=${NETDATA_REGISTRY_UNIQUE_ID}&chart=${chart}&family=${family}"
 233
 234 # the severity of the alarm
 235 severity="${status}"
 236
 237 # the time the alarm was raised
 238 raised_for="<br/><small>(was ${old_status,,} for $(duration4human ${duration}))</small>"
 239
 240 # the key status message
 241 status_message="status unknown"
 242
 243 # the color of the alarm
 244 color="grey"
 245
 246 # the alarm value
 247 alarm="${name//_/ } = ${value} ${units}"
 248
 249 # prepare the title based on status
 250 case "${status}" in
 251         CRITICAL)
 252         status_message="is critical"
 253         color="#ca414b"
 254         ;;
 255
 256     WARNING)
 257         status_message="needs attention"
 258         color="#caca4b"
 259                 ;;
 260
 261         CLEAR)
 262         status_message="recovered"
 263                 color="#77ca6d"
 264
 265                 # don't show the value when the status is CLEAR
 266                 # for certain alarms, this value might not have any meaning
 267                 alarm="${name}"
 268                 ;;
 269 esac
 270
 271 if [ "${status}" = "CLEAR" ]
 272 then
 273     severity="Recovered from ${old_status}"
 274     if [ $non_clear_duration -gt $duration ]
 275     then
 276         raised_for="<br/><small>(had issues for $(duration4human ${non_clear_duration}))</small>"
 277     fi
 278
 279 elif [ "${old_status}" = "WARNING" -a "${status}" = "CRITICAL" ]
 280 then
 281     severity="Escalated to ${status}"
 282     if [ $non_clear_duration -gt $duration ]
 283     then
 284         raised_for="<br/><small>(has issues for $(duration4human ${non_clear_duration}))</small>"
 285     fi
 286
 287 elif [ "${old_status}" = "CRITICAL" -a "${status}" = "WARNING" ]
 288 then
 289     severity="Demoted to ${status}"
 290     if [ $non_clear_duration -gt $duration ]
 291     then
 292         raised_for="<br/><small>(has issues for $(duration4human ${non_clear_duration}))</small>"
 293     fi
 294
 295 else
 296     raised_for=
 297 fi
 298
 299
 300 # -----------------------------------------------------------------------------
 301 # send the pushover
 302
 303 send_pushover "${PUSHOVER_APP_TOKEN}" "${to_pushover}" "${hostname} ${status_message} - ${chart}.${name}" "<font size="5" color=\"${color}\"><b>${hostname} ${status_message}</b></font>
 304
 305 <b>${alarm}</b>${info}
 306
 307 Chart: ${chart}
 308 Family: ${family}
 309 Severity: ${severity}
 310 Time: ${date}
 311 ${raised_for}
 312 <a href=\"${goto_url}\">View Netdata</a>
 313
 314 <small>The source of this alarm is line ${src}</small>"
 315
 316 SENT_PUSHOVER=$?
 317
 318 # -----------------------------------------------------------------------------
 319 # send the email
 320
 321 cat <<EOF | send_email
 322 To: ${to_email}
 323 Subject: ${hostname} ${status_message} - ${chart}.${name}
 324 Content-Type: text/html
 325
 326 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 327 <html xmlns="http://www.w3.org/1999/xhtml" style="font-family: 'Helvetica Neue', 'Helvetica', Helvetica, Arial, sans-serif; box-sizing: border-box; font-size: 14px; margin: 0; padding: 0;">
 328 <body style="font-family:'Helvetica Neue','Helvetica',Helvetica,Arial,sans-serif;font-size:14px;width:100%!important;min-height:100%;line-height:1.6;background:#f6f6f6;margin:0;padding:0">
 329 <table>
 330     <tbody>
 331     <tr>
 332         <td style="vertical-align:top;" valign="top"></td>
 333         <td width="700" style="vertical-align:top;display:block!important;max-width:700px!important;clear:both!important;margin:0 auto;padding:0" valign="top">
 334             <div style="max-width:700px;display:block;margin:0 auto;padding:20px">
 335                 <table width="100%" cellpadding="0" cellspacing="0"
 336                        style="background:#fff;border:1px solid #e9e9e9">
 337                     <tbody>
 338                     <tr>
 339                         <td bgcolor="#eee"
 340                             style="padding: 5px 20px 5px 20px;background-color:#eee;">
 341                             <div style="font-size:20px;color:#777;font-weight: bold;">netdata notification</div>
 342                         </td>
 343                     </tr>
 344                     <tr>
 345                         <td bgcolor="${color}"
 346                             style="font-size:16px;vertical-align:top;font-weight:400;text-align:center;margin:0;padding:10px;color:#ffffff;background:${color}!important;border:1px solid ${color};border-top-color:${color}" align="center" valign="top">
 347                             <h1 style="font-weight:400;margin:0">${hostname} ${status_message}</h1>
 348                         </td>
 349                     </tr>
 350                     <tr>
 351                         <td style="vertical-align:top" valign="top">
 352                             <div style="margin:0;padding:20px;max-width:700px">
 353                                 <table width="100%" cellpadding="0" cellspacing="0" style="max-width:700px">
 354                                     <tbody>
 355                                     <tr>
 356                                         <td style="font-size:18px;vertical-align:top;margin:0;padding:0 0 20px"
 357                                             align="left" valign="top">
 358                                             <span>${chart}</span>
 359                                             <span style="display:block;color:#666666;font-size:12px;font-weight:300;line-height:1;text-transform:uppercase">Chart</span>
 360                                         </td>
 361                                     </tr>
 362                                     <tr style="margin:0;padding:0">
 363                                         <td style="font-size:18px;vertical-align:top;margin:0;padding:0 0 20px"
 364                                             align="left" valign="top">
 365                                             <span><b>${alarm}</b>${info}</span>
 366                                             <span style="display:block;color:#666666;font-size:12px;font-weight:300;line-height:1;text-transform:uppercase">Alarm</span>
 367                                         </td>
 368                                     </tr>
 369                                     <tr>
 370                                         <td style="font-size:18px;vertical-align:top;margin:0;padding:0 0 20px"
 371                                             align="left" valign="top">
 372                                             <span>${family}</span>
 373                                             <span style="display:block;color:#666666;font-size:12px;font-weight:300;line-height:1;text-transform:uppercase">Family</span>
 374                                         </td>
 375                                     </tr>
 376                                     <tr style="margin:0;padding:0">
 377                                         <td style="font-size:18px;vertical-align:top;margin:0;padding:0 0 20px"
 378                                             align="left" valign="top">
 379                                             <span>${severity}</span>
 380                                             <span style="display:block;color:#666666;font-size:12px;font-weight:300;line-height:1;text-transform:uppercase">Severity</span>
 381                                         </td>
 382                                     </tr>
 383                                     <tr style="margin:0;padding:0">
 384                                         <td style="font-size:18px;vertical-align:top;margin:0;padding:0 0 20px"
 385                                             align="left" valign="top"><span>${date}</span>
 386                                             <span>${raised_for}</span> <span
 387                                                     style="display:block;color:#666666;font-size:12px;font-weight:300;line-height:1;text-transform:uppercase">Time</span>
 388                                         </td>
 389                                     </tr>
 390                                     <!--
 391                                     <tr style="margin:0;padding:0">
 392                                         <td style="font-size:18px;vertical-align:top;margin:0;padding:0 0 20px">
 393                                             <a href="${goto_url}" style="font-size:14px;color:#ffffff;text-decoration:none;line-height:1.5;font-weight:bold;text-align:center;display:inline-block;text-transform:capitalize;background:#35568d;border-width:1px;border-style:solid;border-color:#2b4c86;margin:0;padding:10px 15px" target="_blank">View Netdata</a>
 394                                         </td>
 395                                     </tr>
 396                                     -->
 397                                     <tr style="text-align:center;margin:0;padding:0">
 398                                         <td style="font-size:11px;vertical-align:top;margin:0;padding:10px 0 0 0;color:#666666"
 399                                             align="center" valign="bottom">The source of this alarm is line <code>${src}</code>
 400                                         </td>
 401                                     </tr>
 402                                     <tr style="text-align:center;margin:0;padding:0">
 403                                         <td style="font-size:12px;vertical-align:top;margin:0;padding:20px 0 0 0;color:#666666;border-top:1px solid #f0f0f0"
 404                                             align="center" valign="bottom">Sent by
 405                                             <a href="https://mynetdata.io/" target="_blank">netdata</a>, the real-time performance monitoring.
 406                                         </td>
 407                                     </tr>
 408                                     </tbody>
 409                                 </table>
 410                             </div>
 411                         </td>
 412                     </tr>
 413                     </tbody>
 414                 </table>
 415             </div>
 416         </td>
 417     </tr>
 418     </tbody>
 419 </table>
 420 </body>
 421 </html>
 422 EOF
 423
 424 SENT_EMAIL=$?
 425
 426 # -----------------------------------------------------------------------------
 427 # let netdata know
 428
 429 # we did send somehting
 430 [ ${SENT_EMAIL} -eq 0 -o ${SENT_PUSHOVER} -eq 0 ] && exit 0
 431
 432 # we did not send anything
 433 exit 1