Уведомления 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/messages | https://p4a.me/wh/<slug> |
| Заголовок push | Ваш, например Down: Website | Всегда Webhook <name> |
| Падение громко, восстановление тихо | Да | Да, с собственным телом; иначе один уровень для всего |
| Секрет хранится в Uptime Kuma | API-ключ с полным доступом к вашему аккаунту | 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 и пусть следующее падение дойдёт до телефона, а восстановление тихо подождёт в ленте.