ZvenoAI
Руководства

Статус сервисов

Состояние API и сайта ZvenoAI, история инцидентов и подписка на инциденты через Atom-ленту в любой RSS-читалке.

Текущее состояние API и сайта показывает status.zveno.ai. Если запросы массово падают с 502, 503 или по таймауту, сначала проверьте эту страницу.

Что на странице

Как мы проверяем

Проверки идут снаружи нашей инфраструктуры раз в 30 секунд, каждая по новому соединению. API и сайт проверяются отдельно. Проверка API запрашивает каталог моделей, поэтому она проходит и через базу данных.

Подписка на инциденты

Подпишитесь на Atom-ленту:

https://status.zveno.ai/feed.atom

Каждое обновление инцидента приходит отдельной записью: «Выясняем», «Причина найдена», «Наблюдаем», «Решён». Поэтому читалка сообщит и об открытии инцидента, и о его закрытии. Новая запись появляется в ленте в течение 5 минут после публикации.

Подходит любая RSS-читалка, в том числе RSS-бот в Telegram: дайте ему адрес ленты, и он пришлёт каждое обновление инцидента сообщением.

Рассылки на почту и вебхуков пока нет.

Данные для мониторинга

Для своих скриптов и мониторинга состояние отдаёт status.json. Ключ не нужен:

curl -s https://status.zveno.ai/status.json
Пример ответа status.json
{
  "version": 1,
  "updated": "2026-11-12T10:19:49+00:00",
  "status": "operational",
  "severity": null,
  "components": {
    "api": { "status": "operational", "severity": null, "failed_last_10": 0 },
    "site": { "status": "operational", "severity": null, "failed_last_10": 0 }
  },
  "incidents": []
}
ПолеЧто означает
statusОбщее состояние: operational, degraded, down или unknown
severityУточняет degraded: minor — работает с перебоями, major — частичный сбой. При других статусах null. Есть у общего состояния и у компонентов
components.api, components.siteСостояние API и сайта: status и severity с теми же значениями и failed_last_10 — сколько из 10 последних проверок не прошли
incidentsОткрытые инциденты: id, title, impact (minor, major, critical), status (investigating, identified, monitoring), components, started, updated
updatedКогда файл обновлён. Файл обновляется раз в 30 секунд

Как считается состояние:

  • У компонента не прошла 0 или 1 из 10 последних проверок — operational. Не прошли все 10 — down. Иначе — degraded.
  • Открытый инцидент поднимает уровень: minor и major — до degraded, critical — до down.
  • Общее состояние down, когда по проверкам недоступны все компоненты или открыт инцидент critical. Если хотя бы один компонент не operational или открыт инцидент minor или major — degraded. Если у какого-то компонента unknown, общее тоже unknown. Иначе — operational.
  • unknown — последняя проверка старше 3 минут, проверки остановились. Не считайте это работой сервиса.

Как настроить свою проверку:

  • Запрашивайте status.json не чаще раза в минуту.
  • Тревога — любое значение status, кроме operational, в том числе unknown.
  • Отдельно следите за updated: если файл не обновлялся дольше 3 минут, данные устарели.
Состояние API
curl -s https://status.zveno.ai/status.json | jq -r '.components.api.status'

Формат версии 1 только дополняется: новые поля могут появиться, существующие не меняются и не исчезают. Несовместимые изменения выйдут по новому адресу.

Zabbix и Grafana

Готовые шаблоны опрашивают status.json раз в минуту и поднимают тревогу при сбое, при unknown и при устаревшей сводке. Проверены на Zabbix 7.0.32, Grafana 12.4.14 и плагине Infinity 4.1.4. Работа через прокси Zabbix, источник Grafana, созданный в интерфейсе, и Grafana Cloud не проверялись.

Сервер Zabbix или Grafana должен выходить на status.zveno.ai:443. Часы на нём синхронизируйте по NTP: от них считается возраст сводки.

Скачайте шаблон «ZvenoAI status» для Zabbix 7.0: zabbix_zvenoai_status.yaml.

  1. Откройте Сбор данных → Шаблоны → Импорт и загрузите файл.
  2. Создайте узел сети, например zvenoai, и привяжите к нему шаблон ZvenoAI status. Интерфейс узлу не нужен: сводку запрашивает HTTP-агент сервера Zabbix.
  3. Если Zabbix выходит в интернет через HTTP-прокси, укажите его в поле HTTP-прокси элемента «ZvenoAI: сводка status.json». Адрес сводки задаёт макрос {$ZVENOAI.STATUS.URL}: переопределяйте его на узле, а не в шаблоне.
ТриггерВажностьКогда срабатывает
ZvenoAI: работает со сбоямиПредупреждениеОбщий статус degraded
ZvenoAI: сервис недоступенВысокаяОбщий статус down
ZvenoAI: статус неизвестенПредупреждениеОбщий статус unknown
ZvenoAI: сводка не обновлялась больше 5 минутПредупреждениеupdated старше 5 минут
ZvenoAI: нет данных от status.json 5 минутПредупреждениеАдрес недоступен, отвечает ошибкой или ответ не разбирается

Шаблон также собирает статус API и сайта, число непрошедших проверок из 10 последних и число открытых инцидентов.

Скачайте файлы:

  1. Установите плагин Infinity и перезапустите Grafana. Нужна Grafana 12.0.10+, 12.1.7+ или 12.2.5+.

    grafana cli plugins install yesoreyeram-infinity-datasource
  2. Положите grafana_datasource.yaml в /etc/grafana/provisioning/datasources/ и перезапустите Grafana. Правило оповещения ссылается на источник по UID zvenoai-status. Если источник создан в интерфейсе, его UID случайный: подставьте его вместо zvenoai-status в строке datasourceUid файла правила. Если в источнике заполнен список Allowed hosts, добавьте в него https://status.zveno.ai.

  3. Импортируйте дашборд: Dashboards → New → Import. На нём общий статус, статус API и сайта и таблица открытых инцидентов. Если сводка старше 5 минут, статусы показывают «Неизвестно».

  4. Положите grafana_alert_rule.yaml в /etc/grafana/provisioning/alerting/ и перезапустите Grafana. Правило «ZvenoAI работает нештатно» срабатывает, если проблема держится две проверки подряд, и называет причину в заголовке. Если сводка недоступна, оповещение приходит с именем DatasourceError.

В Grafana Cloud файлов провижининга нет: создайте правило вручную с тем же запросом и условием A > 0.

On this page