Назад в блог

Уведомления Uptime Kuma на телефон: громко при падении, тихо при восстановлении

Уведомления Uptime Kuma на телефон: громко при падении, тихо при восстановлении

Uptime Kuma хорошо замечает, что что-то упало. А вот куда попадает это уведомление, отдельный вопрос. Чаще всего его отправляют в групповой чат Telegram, канал Discord или папку с письмами, рядом со всем остальным, что весь день вибрирует в телефоне. Сообщение «восстановлено» звучит точно так же, как «упало», поэтому через пару беспокойных ночей люди отключают канал и перестают его читать.

Это руководство отправляет уведомления Uptime Kuma в Pocket Alert как push-уведомления с разными приоритетами. Падение монитора приходит с приоритетом high, и такое уведомление пробивается через Фокусирование на iPhone. Восстановление приходит с приоритетом low: оно появляется в ленте, когда вы на неё смотрите, и никого не будит. Всё делается через встроенный тип уведомлений Webhook в Uptime Kuma, так что ничего дополнительно устанавливать не нужно.

Всё, что описано ниже, проверено на Uptime Kuma 2.5.8, запущенном в Docker.

Что понадобится

  • Uptime Kuma 2.x. Большая часть также работает на 1.23.x, различия описаны в конце.
  • Приложение Pocket Alert на телефоне и аккаунт. Если его нет, зарегистрируйтесь: для начала достаточно бесплатного тарифа.
  • API-ключ из раздела API Keys (маршрут 1) или вебхук из раздела Webhooks (маршрут 2).

Два способа подключения

Webhook-уведомление Uptime Kuma может отправлять данные на любой URL, либо в собственном JSON, либо в теле, которое вы напишете сами. Поэтому есть два маршрута:

Маршрут 1: API Pocket AlertМаршрут 2: URL вебхука Pocket Alert
URL отправкиhttps://api.pocketalert.app/v1/messageshttps://p4a.me/wh/<slug>
Заголовок pushВаш, например Down: WebsiteВсегда Webhook <name>
Падение громко, восстановление тихоДаДа, с собственным телом; иначе один уровень для всего
Секрет хранится в Uptime KumaAPI-ключ с полным доступом к вашему аккаунтуURL, который может только создавать push через этот вебхук
Журнал запросов в Pocket AlertНетДа, в истории вебхуков

Выбирайте маршрут 1, если нужны читаемые заголовки и минимум движущихся частей. Выбирайте маршрут 2, если не хотите хранить полный API-ключ в Uptime Kuma (он сохраняет настройки уведомлений, включая заголовки, в базе данных в виде обычного JSON) или если хотите, чтобы каждый отправленный им запрос логировался на стороне Pocket Alert для отладки.

Маршрут 1: отправка напрямую в API Pocket Alert

В Uptime Kuma откройте Settings → Notifications и нажмите Set Up Notification. Заполните так:

  • Notification Type: Webhook
  • Friendly Name: Pocket Alert
  • Post URL: https://api.pocketalert.app/v1/messages
  • HTTP Method: POST
  • Request Body: Custom Body

Вставьте это в поле тела, заменив kuma.example.com на адрес вашего Uptime Kuma:

{%- assign level = "default" -%}
{%- assign title = "Uptime Kuma" -%}
{%- assign text = msg -%}
{%- if heartbeatJSON -%}
  {%- assign text = heartbeatJSON.msg | default: msg -%}
  {%- if heartbeatJSON.status == 0 -%}
    {%- assign title = "Down: " | append: monitorJSON.name -%}
    {%- assign level = "high" -%}
    {%- for tag in monitorJSON.tags -%}
      {%- if tag.name == "critical" -%}{%- assign level = "critical" -%}{%- endif -%}
    {%- endfor -%}
  {%- else -%}
    {%- assign title = "Up: " | append: monitorJSON.name -%}
    {%- assign level = "low" -%}
  {%- endif -%}
{%- elsif msg contains "will expire" -%}
  {%- assign title = "Expiring soon" -%}
{%- endif -%}
{
  "title": {{ title | json }},
  "message": {{ text | json }},
  "level": "{{ level }}",
  "actions": [
    {
      "type": "view",
      "label": "Open in Uptime Kuma",
      "value": "https://kuma.example.com/dashboard/{{ monitorJSON.id }}"
    }
  ]
}

Затем включите Additional Headers и вставьте:

{
  "Token": "YOUR_API_KEY",
  "Content-Type": "application/json"
}

Что делает тело:

  • Тело — это шаблон Liquid. Uptime Kuma передаёт в него msg (готовый текст), monitorJSON (монитор) и heartbeatJSON (проверку, которая изменила состояние). heartbeatJSON.status равен 0 при падении и 1 при восстановлении.
  • Фильтр | json записывает полную JSON-строку, включая кавычки. Тексты ошибок и названия мониторов могут содержать кавычки и обратные слеши; с фильтром они не могут сломать запрос. Монитор с названием Bob's "main" site всё равно даст корректный JSON.
  • Падение — high, восстановление — low. high на iPhone считается срочным и проходит через Фокусирование и отложенную сводку. low доставляется без того, чтобы вас прерывать.
  • Пометьте монитор тегом critical, чтобы сделать уведомление громче. Добавьте в Uptime Kuma тег с именем critical к самым важным мониторам, и их падения будут отправляться как critical: такие уведомления звучат даже при выключенном беззвучном режиме и в режиме «Не беспокоить». Критические уведомления доступны в платной версии; на бесплатном тарифе они доставляются как high.
  • У сертификатов и тестовых сообщений нет проверки (heartbeat). Для них push использует собственный текст Uptime Kuma. Тот же текст служит запасным, когда текст проверки пустой, как у ping-монитора при восстановлении; API отклоняет push с пустым сообщением.
  • Кнопка открывает монитор. /dashboard/<id> — это страница монитора в Uptime Kuma. Для предупреждения о сертификате ID монитора нет, и кнопка открывает панель. Кнопки действий доступны в платной версии; на бесплатном тарифе API их отбрасывает, и push доставляется без них. Что ещё умеют кнопки действий, см. в разделе кнопки действий.

Не пропускайте заголовок Content-Type. Когда Uptime Kuma отправляет собственное тело, он помечает его как application/x-www-form-urlencoded, если не указано иное. Так было в моём тесте. API Pocket Alert принимает только JSON или multipart и на такой запрос отвечает 400.

Нажмите Test. Push с заголовком «Uptime Kuma» и текстом «Pocket Alert Testing» должен прийти в течение нескольких секунд. Сохраните.

Вот что отправил Uptime Kuma 2.5.8 при реальном падении и восстановлении:

{
  "title": "Down: Website",
  "message": "timeout of 4000ms exceeded",
  "level": "high",
  "actions": [
    { "type": "view", "label": "Open in Uptime Kuma", "value": "https://kuma.example.com/dashboard/1" }
  ]
}
{
  "title": "Up: Website",
  "message": "200 - OK",
  "level": "low",
  "actions": [
    { "type": "view", "label": "Open in Uptime Kuma", "value": "https://kuma.example.com/dashboard/1" }
  ]
}

Используйте отдельный API-ключ с названием Uptime Kuma, чтобы его можно было отозвать отдельно, если этот сервер когда-нибудь скомпрометируют.

Маршрут 2: URL вебхука Pocket Alert

Здесь Uptime Kuma отправляет собственный JSON на вебхук Pocket Alert, а шаблон на стороне Pocket Alert превращает его в push.

Создайте вебхук

Шаблон кнопки можно задать только через API, поэтому самый быстрый способ — один вызов. Он создаёт вебхук «Uptime Kuma» с шаблоном сообщения, уровнем по умолчанию high (1) и кнопкой «Open in Uptime Kuma», а затем выводит URL для приёма:

PA_KEY='your-api-key'
KUMA_URL='https://kuma.example.com'

jq -n --arg kuma "$KUMA_URL" '{
  name: "Uptime Kuma",
  message: "%msg%",
  default_level: 1,
  actions: ([{type: "view", label: "Open in Uptime Kuma", value: ($kuma + "/dashboard/%monitor.id%")}] | tojson)
}' |
curl -sS https://api.pocketalert.app/v1/webhooks \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- |
jq -r '"Receive URL: https://p4a.me/wh/" + .url'

Если вам удобнее кликать, создайте его в консоли в разделе Webhooks: название Uptime Kuma, Default priority High, сообщение %msg%. Push-уведомления будут теми же, только без кнопки.

Направьте на него Uptime Kuma

Создайте новое уведомление типа Webhook, вставьте URL для приёма в поле Post URL и установите Request Body в Preset - application/json. Заголовки не нужны: секрет — это сам URL, поэтому относитесь к нему как к паролю. Не выбирайте пресет multipart: вебхуки Pocket Alert читают только JSON.

Вот что Uptime Kuma отправил в моей тестовой конфигурации при падении монитора (сокращено; объект monitor содержит около сотни полей):

{
  "heartbeat": {
    "monitorID": 1,
    "status": 0,
    "time": "2026-10-31 16:09:56.331",
    "msg": "timeout of 4000ms exceeded",
    "important": true,
    "localDateTime": "2026-10-31 16:09:56"
  },
  "monitor": {
    "id": 1,
    "name": "Website",
    "url": "http://tls-target/",
    "type": "http",
    "tags": []
  },
  "msg": "[Website] [🔴 Down] timeout of 4000ms exceeded"
}

Шаблон %msg% использует поле msg верхнего уровня, потому что оно есть в каждом запросе. Для предупреждений о сертификатах и тестовых сообщений heartbeat и monitor равны null, и заполнено только msg. Push приходит с заголовком «Webhook Uptime Kuma» и текстом «[Website] [🔴 Down] timeout of 4000ms exceeded». Плейсхолдер с отсутствующим путём превращается в пустую строку, поэтому при предупреждении о сертификате кнопка ведёт на /dashboard/ и всё равно работает.

Падение громко, восстановление тихо на этом маршруте

С пресетом JSON каждый запрос получает уровень вебхука по умолчанию, поэтому восстановления приходят так же громко, как падения. Чтобы это исправить, переключите Request Body на Custom Body и передавайте поле level самостоятельно. Вебхуки Pocket Alert читают level верхнего уровня из полезной нагрузки и только потом используют уровень по умолчанию:

{
  "level": "{% if heartbeatJSON %}{% if heartbeatJSON.status == 0 %}high{% else %}low{% endif %}{% else %}default{% endif %}",
  "msg": {{ msg | json }},
  "monitor": { "id": "{{ monitorJSON.id }}" }
}

Тело сохраняет имена полей msg и monitor.id, поэтому шаблоны сообщения и кнопки вебхука работают без изменений. Вебхуки Pocket Alert читают тело как JSON независимо от его Content-Type, так что этому маршруту не нужен дополнительный заголовок.

Включите для каждого монитора

Уведомление ничего не делает, пока им не пользуется монитор. Внизу формы уведомления есть два переключателя:

  • Default enabled включает это уведомление для каждого монитора, который вы создадите с этого момента.
  • Apply on all existing monitors добавляет его ко всем уже существующим мониторам. Выполняется один раз при сохранении и не запоминается.

Включите оба при первом сохранении. Чтобы исключить монитор, откройте его и снимите отметку с уведомления в форме редактирования.

Предупреждения об истечении сертификата

Uptime Kuma может предупредить вас до того, как TLS-сертификат истечёт. Откройте HTTP(s)-монитор (у мониторов Keyword и JSON Query тоже есть эта опция) и отметьте Certificate Expiry Notification в разделе Advanced. Флажок неактивен, пока включена опция Ignore TLS/SSL errors for HTTPS websites.

Пороги задаются глобально, в Settings → Notifications → TLS Certificate Expiry, по умолчанию это 7, 14 и 21 день. Предупреждение уходит в те же уведомления, что и падения монитора, с текстом вида:

[TLS site][https://tls-target/] server certificate tls-target will expire in 4 days

Тело маршрута 1 перехватывает его по условию msg contains "will expire" и присваивает заголовок «Expiring soon» с уровнем default. Uptime Kuma отправляет его один раз на каждый порог, а не при каждой проверке: в моём тесте монитор проверили 119 раз при сертификате, истекающем через четыре дня, и ушло ровно одно предупреждение.

Как не дать нестабильному монитору завалить телефон

Три настройки монитора определяют, насколько шумит нестабильный сервис:

НастройкаЧто делаетРекомендация
RetriesСколько неудачных проверок помечаются как Pending, прежде чем монитор считается упавшим. Проверки в состоянии Pending не отправляют уведомлений.2 или 3
Heartbeat Retry IntervalСекунды между проверками в состоянии Pending.20 — 60
Resend Notification if Down X times consecutivelyПовторяет уведомление о падении после стольких дополнительных неудачных проверок. 0 отправляет его один раз.0 или значение, которое даёт 30–60 минут

При Retries, равном 2, в моём тесте первые две неудачные проверки помечались как pending, и только третья отправила «Down». При Resend, равном 3, уведомление о падении повторялось после каждых трёх дополнительных неудачных проверок, пока сервис не восстановился. Счётчик повторов считается в проверках, а не в минутах. При интервале 60 секунд значение 30 означает напоминание каждые полчаса.

Каждое падение, каждое восстановление и каждый повтор — это одно сообщение. Бесплатный тариф позволяет 50 сообщений в день, поэтому один нестабильный монитор без повторов может исчерпать лимит за полдня. Повторные проверки — самое дешёвое решение.

Если ничего не приходит

  • Тест завершается с HTTP 400. На маршруте 1 проверьте, что Additional Headers содержит "Content-Type": "application/json". Без него запрос уходит как данные формы.
  • HTTP 401. Заголовок Token отсутствует или ключ отозван. Создайте новый в разделе API Keys.
  • Тест приходит, а падения нет. Откройте монитор и проверьте, что уведомление отмечено. Также учтите: Uptime Kuma не отправляет уведомление при первой проверке монитора, если тот работает, поэтому новый монитор молчит, пока что-нибудь не изменится.
  • На маршруте 2 ничего не видно. Откройте историю вебхука в консоли. Если запрос там есть с ошибкой, она объяснит причину: невалидный JSON или шаблон, который дал пустое сообщение. Если запросов нет вообще, значит, Uptime Kuma не смог достучаться до p4a.me. Также можно отправить запросы в тестер вебхуков, чтобы увидеть, что именно отправляет Uptime Kuma.
  • Кажется, восстановление не пришло. Уведомления low беззвучны. Проверьте ленту в приложении.

FAQ

Какая версия Uptime Kuma нужна?

Всё проверено на 2.5.8, последнем релизе на момент написания. Версия 1.23.x тоже имеет тип Webhook с Custom Body и Additional Headers, а в шаблоне доступны те же переменные msg, monitorJSON и heartbeatJSON. Я отрисовал тело маршрута 1 движком шаблонов, который входит в 1.23.16, и получил тот же JSON, но полный сквозной прогон выполнялся только на 2.5.8.

Что делать, если сервер с Uptime Kuma упадёт?

Тогда оповещение никто не отправит. Uptime Kuma не может сообщить о собственном падении, поэтому запустите что-то снаружи, что это заметит: проверку с другой машины или хостед-монитор. На странице мониторинга доступности перечислены хостед-мониторы, которые работают с вебхуками Pocket Alert.

Можно ли отправлять разные мониторы на разные телефоны?

Да, на платном тарифе. Создайте уведомление для каждой группы с разным device_id в теле (маршрут 1) или отдельный вебхук с собственным устройством (маршрут 2), и отметьте нужное уведомление на каждом мониторе. На бесплатном тарифе есть одно устройство и один вебхук, поэтому телефон один.

Работает ли это для ping-, port- и DNS-мониторов?

Да. Тело использует только имя и ID монитора, а также статус и сообщение проверки, которые есть у всех типов мониторов. У некоторых типов, в том числе ping, сообщение при успешной проверке пустое; тогда тело использует собственный текст Uptime Kuma. Кнопка ведёт на страницу монитора в Uptime Kuma, а не на проверяемый адрес, поэтому работает, даже если адрес не является URL.

Я уже использую это для Proxmox. Можно ли использовать один API-ключ?

Можно, но лучше дать Uptime Kuma собственный ключ, чтобы отзыв одного не сломал другой. В руководстве по Proxmox описаны оповещения о бэкапах и дисках из той же домашней лаборатории.

Создайте бесплатный аккаунт, вставьте тело в уведомление Webhook и пусть следующее падение дойдёт до телефона, а восстановление тихо подождёт в ленте.

Поделиться статьёй