Каналы

Канал – место, куда уходят уведомления об инцидентах: почта, Telegram или вебхук. Каналы собраны на странице Уведомления → Каналы, заводит и настраивает их администратор. Редактор видит готовые каналы и выбирает их в правилах.

В таблице – название, тип и статус. В конце строки – «Проверить» и «Удалить», у канала Telegram ещё и «Топик».

Добавить канал

Кнопка «+ Добавить канал» открывает окно «Новый канал»: название, тип и поля этого типа.

• Email: кому, от кого, SMTP-сервер без порта, порт (по умолчанию 587), логин и пароль при необходимости. STARTTLS используется, если сервер его объявляет. Адреса – по одному, без имени.
• Telegram: токен бота, Chat ID (у групп вида -100…) и, если нужно, топик.
• Webhook: URL, на который уйдёт POST с JSON. Только http и https. Адрес внутренней сети не принимается ни при сохранении, ни при отправке, в том числе после редиректа.

Секреты не показываются повторно

Токен бота и пароль SMTP после сохранения нельзя ни посмотреть, ни поправить. Чтобы изменить их, удалите канал и создайте заново.

Топик Telegram

Если чат разбит на темы, укажите топик: номер темы или ссылку на любое сообщение из неё, например 5162 или https://t.me/c/1234567890/5162/7006. Пустое поле – сообщения идут в общий чат.

Топик меняется без пересоздания канала: кнопка «Топик» в строке.

Проверить канал

Кнопка «Проверить» отправляет в канал пробное сообщение и сразу говорит, чем кончилось: «пробное сообщение отправлено» или причина отказа человеческим языком. Самые частые:

Сообщение	Что делать
чат не найден	проверьте Chat ID и что бот добавлен в чат
боту нельзя писать в этот чат	дайте боту право отправлять сообщения
в этом чате нет такого топика	проверьте номер топика
топик закрыт / топик удалён	откройте топик или выберите другой
бота нет в чате	добавьте бота в чат
Telegram не принял токен бота	пересоздайте канал с верным токеном
адрес вебхука не ответил за 10 секунд	проверьте адрес и доступность сервера
адрес вебхука ведёт во внутреннюю сеть	туда уведомления не отправляются, нужен публичный адрес
почтовый сервер не принимает соединения	проверьте адрес и порт

Пробное сообщение в Telegram начинается строкой [TEST] Имя канала – channel check и помечено, что это не инцидент.

Проблема доступа к Telegram – в поддержку

Сообщения «сервер Netelum не достучался до Telegram», «не смог соединиться с Telegram» или «не нашёл адрес Telegram» с припиской «серверу нужен прокси для Telegram», а также «прокси для Telegram на сервере Netelum не отвечает» означают, что дело не в канале, а в доступе платформы к Telegram. Пересоздавать канал не нужно – обратитесь в поддержку.

Проверяйте канал сразу после создания: иначе о неверном токене вы узнаете только на первом настоящем инциденте.

Выключить и удалить

Кнопка в колонке «Статус» выключает канал. Выключенный канал не получает ничего.

«Удалить» убирает канал и снимает его со всех правил.

Если в аккаунте нет ни одного включённого канала, на странице Инциденты висит предупреждение: инциденты открываются, но никуда не отправляются.

Доставка

Уведомления идут по одному на событие и канал. Пока по объекту идёт окно обслуживания, уведомления по нему не отправляются. Неудачная отправка не повторяется: сломанный канал виден на странице инцидента в блоке «Доставки». Если доставка не удалась из-за сбоя платформы, она дошлёт сама: горящий инцидент – всегда, в том числе в канал, привязанный позже, закрытый – в течение часа.

Что приходит

Текст уведомления начинается со строки [WARNING] Имя правила – OPENED (или [CRITICAL] …). Вместо OPENED бывает:

• RESOLVED – условие перестало нарушаться;
• ESCALATED – инцидент поднят до «Критично»: истёк срок сертификата или домена, у «Приложения у многих» или у свёртки затронутых стало не меньше второго порога;
• OFFLINE – устройство перестало отчитываться, это не выздоровление;
• CLOSED – правило удалили или перенацелили, либо новый маршрут BGP принят как обычный.

Дальше строками – приложение (application:), группа устройств (group:), устройство (device:) или тест (test:), значение метрики (value:) и показание. В теме письма – имя правила и событие. У инцидентов BGP, DNS, сроков и лицензии вместо имени правила стоит заголовок инцидента.

Вебхук получает JSON с полями event (opened, escalated, resolved, offline, rule_changed, rule_deleted, adopted), severity, ruleName, testId, value, device, reading и text – той же строкой, что уходит в Telegram и в письмо. У «Приложения у многих» добавляется application, у группового инцидента свёртки – объект group: по чему свёрнуто, подпись группы и список устройств.

Уведомление о жалобе сотрудника устроено по-своему: письмо с цитатой жалобы и ссылкой на слепок, в вебхуке – объект complaint. Подробнее – в разделе Жалоба сотрудника.