Как настроить уведомления в Telegram от Icinga2

Настраиваем канал для получения уведомлений о проблемах с хостами и сервисами в Telegram

Шаг 1. Создание бота в Telgram

Добавляем бота под названием BotFather и отправляем ему команду /newbot, выбираем имя, которое будет отображаться в списке контактов и адрес. Например, «My Alert Checker» с адресом «MyPrivateBot».

Если адрес не занят, а имя введено правильно, BotFather пришлет в ответ сообщение с токеном — «ключом» для доступа к созданному боту. Его нужно сохранить и никому не показывать.

Шаг 2. Создание канала

Создаём канал с любым названием и адресом, и переходим в его настройки.

Необходимо добавить в список администраторов созданного нами бота — именно он будет публиковать уведомления в канал.

Шаг 3. Идентификация чата

Отправим в чат любое сообщение, чтобы отследить ID-канала для отправки уведомлений.

После того, как отправили сообщение, выполним curl-запрос, подставив ранее полученный токен для бота.

curl --silent "https://api.telegram.org/bot${TOKEN}/getUpdates"

# curl --silent "https://api.telegram.org/bot521924663:AAH7t61mNpKLOToyIsPm3vFOJ3GNaD9-LSI/getUpdates"
{"ok":true,"result":[{"update_id":731268716,
"channel_post":{"message_id":4,"chat":{"id":-1001348922431,"title":"My Alert Checker","type":"channel"},"date":1516122930,"text":"ferfe"}}]}

Получаем ID канала - -1001348922431.

Шаг 4. Настройка Icinga2 для отправки уведомлений в Telegram

Внесем правки в конфигурационные файлы Icinga2.

Добавим нового пользователя

В конфигурационный файл users.conf добавим нового пользователя и впишем полученный ID канала:

object User "mytestuser" {
  import "generic-user"

  display_name = "Test User"

  // The telegram chat ID
  vars.telegram_chat_id = "-1001348922431"
}

Создадим правила уведомления в Telegram

Создаем новые правила уведомления в конфигурационном файле notifications.conf и указываем пользователя, который будет получать уведомления:

apply Notification "telegram-icingaadmin" to Host {
  import "mail-host-notification"
  command = "telegram-host-notification"

  users = [ "mytestuser" ]

  assign where host.name
}

apply Notification "telegram-icingaadmin" to Service {
  import "mail-service-notification"
  command = "telegram-service-notification"

  users = [ "mytestuser" ]

  assign where host.name
}

Добавим скрипт для отправки уведомлений

Создаем скрипт telegram-host-notification.sh в директории scripts для отправки уведомлений по хостам.

#!/bin/sh
if [ -n "$ICINGAWEB2_URL" ]; then
    HOSTDISPLAYNAME="<a href=\"$ICINGAWEB2_URL/host/show?host=$HOSTNAME\">$HOSTDISPLAYNAME</a>"
fi
template=$(cat <<TEMPLATE
<strong>$NOTIFICATIONTYPE</strong> - $HOSTDISPLAYNAME is $HOSTSTATE

Host: $HOSTALIAS
Address: $HOSTADDRESS
Date/Time: $LONGDATETIME

<pre>$HOSTOUTPUT</pre>
TEMPLATE
)
if [ -n "$NOTIFICATIONCOMMENT" ]; then
    template="$template
Comment: ($NOTIFICATIONAUTHORNAME) $NOTIFICATIONCOMMENT
"
fi

/usr/bin/curl --silent --output /dev/null \
    --data-urlencode "chat_id=${TELEGRAM_CHAT_ID}" \
    --data-urlencode "text=${template}" \
    --data-urlencode "parse_mode=HTML" \
    --data-urlencode "disable_web_page_preview=true" \
    "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage"

Создаем скрипт telegram-service-notification.sh в директории scripts для отправки уведомлений по сервисам.

#!/bin/sh
if [ -n "$ICINGAWEB2_URL" ]; then
    HOSTDISPLAYNAME="<a href=\"$ICINGAWEB2_URL/host/show?host=$HOSTNAME\">$HOSTDISPLAYNAME</a>"
    SERVICEDISPLAYNAME="<a href=\"$ICINGAWEB2_URL/service/show?host=$HOSTNAME&service=$SERVICEDESC\">$SERVICEDISPLAYNAME</a>"
fi
template=$(cat <<TEMPLATE
<strong>$NOTIFICATIONTYPE</strong> $HOSTDISPLAYNAME - $SERVICEDISPLAYNAME is $SERVICESTATE

Address: $HOSTADDRESS
Date/Time: $LONGDATETIME

<pre>$SERVICEOUTPUT</pre>
TEMPLATE
)

if [ -n "$NOTIFICATIONCOMMENT" ]; then
  template="$template

Comment: ($NOTIFICATIONAUTHORNAME) $NOTIFICATIONCOMMENT
"
fi

/usr/bin/curl --silent --output /dev/null \
    --data-urlencode "chat_id=${TELEGRAM_CHAT_ID}" \
    --data-urlencode "text=${template}" \
    --data-urlencode "parse_mode=HTML" \
    --data-urlencode "disable_web_page_preview=true" \
    "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage"

Создаем команды для отправки уведомлений

Команды будут выполнять соответствующий скрипт, который вытягивает информацию о проблеме с хостом или сервисом, и curl-запросом отправляет это в Telegram. Определяем собственную конфигурацию команд в файле commands.conf:

object NotificationCommand "telegram-host-notification" {
  import "plugin-notification-command"

  command = [ SysconfDir + "/icinga2/scripts/telegram-host-notification.sh" ]

  env = {
    NOTIFICATIONTYPE = "$notification.type$"
    HOSTNAME = "$host.name$"
    HOSTALIAS = "$host.display_name$"
    HOSTADDRESS = "$address$"
    HOSTSTATE = "$host.state$"
    LONGDATETIME = "$icinga.long_date_time$"
    HOSTOUTPUT = "$host.output$"
    NOTIFICATIONAUTHORNAME = "$notification.author$"
    NOTIFICATIONCOMMENT = "$notification.comment$"
    HOSTDISPLAYNAME = "$host.display_name$"
    TELEGRAM_BOT_TOKEN = BOT_TOKEN_MUST_BE_HERE
    TELEGRAM_CHAT_ID = "$user.vars.telegram_chat_id$"

    // optional
    ICINGAWEB2_URL = "https://icinga.example.com/icingaweb2"
  }
}

object NotificationCommand "telegram-service-notification" {
  import "plugin-notification-command"

  command = [ SysconfDir + "/icinga2/scripts/telegram-service-notification.sh" ]

  env = {
    NOTIFICATIONTYPE = "$notification.type$"
    SERVICEDESC = "$service.name$"
    HOSTNAME = "$host.name$"
    HOSTALIAS = "$host.display_name$"
    HOSTADDRESS = "$address$"
    SERVICESTATE = "$service.state$"
    LONGDATETIME = "$icinga.long_date_time$"
    SERVICEOUTPUT = "$service.output$"
    NOTIFICATIONAUTHORNAME = "$notification.author$"
    NOTIFICATIONCOMMENT = "$notification.comment$"
    HOSTDISPLAYNAME = "$host.display_name$"
    SERVICEDISPLAYNAME = "$service.display_name$"
    TELEGRAM_BOT_TOKEN = BOT_TOKEN_MUST_BE_HERE
    TELEGRAM_CHAT_ID = "$user.vars.telegram_chat_id$"

    // optional
    ICINGAWEB2_URL = "https://icinga.example.com/icingaweb2"
  }
}

Перезагружаем сервис и проверяем работу бота. Для примера отключу веб-сервер.

Troubleshooting

Если уведомления не приходят - сперва проверьте правильность всех настроек.
Попробуйте выполнить команду из консоли:

К примеру:

# curl --silent --data-urlencode "chat_id=-1001348922431" --data-urlencode "text=Hello world" "https://api.telegram.org/bot521924663:AAH7t61mNpKLOToyIsPm3vFOJ3GNaD9-LSI/sendMessage"
{"ok":true,"result":{"message_id":5,"chat":{"id":-1001348922431,"title":"My Alert Checker","type":"channel"},"date":1516124394,"text":"Hello world"}}