Перейти к содержимому

Документация

Токены

Токены — это статические API-ключи, которые системы мониторинга используют для отправки событий в Sereno OnCall. Каждый токен привязан к конкретной команде: все алерты, отправленные с его помощью, попадают в эту команду.

Создание токена

Создавать токены могут только администраторы команды.

  1. Откройте страницу команды в разделе Команды.
  2. Перейдите в раздел Токены и нажмите Создать.
  3. Введите название токена — это поможет понять, где он используется (например, Zabbix PROD).
  4. Скопируйте значение токена сразу после создания.

Значение токена выводится только один раз. После закрытия окна восстановить его невозможно — только удалить и создать новый.

Использование токена

Передавайте токен в заголовке Authorization при отправке алертов через API:

Authorization: Bearer <token>

Поддерживаемые источники

В данные момент Sereno OnCall обрабатывает алерты от следующих систем мониторинга:

ИсточникОписание
ZabbixУниверсальная система мониторинга инфраструктуры
GrafanaПлатформа для визуализации метрик и алертинга
Prometheus AlertmanagerМенеджер алертов для экосистемы Prometheus
ElastAlertАлертинг на основе данных из Elasticsearch

Управление токенами

Список активных токенов отображается на странице команды. Видны название и дата создания — значение токена после создания не отображаются.

Для каждой подключённой системы рекомендуется создавать отдельный токен: это упрощает ротацию ключей и позволяет отозвать доступ конкретной интеграции, не затрагивая остальные.

Удалить токен может только администратор команды. Удаление немедленно блокирует все запросы, использующие этот токен.