Перейти к основному содержимому
Версия: 2.15 (последняя)

Уведомления сервера

Сервер NATS публикует уведомления о значимых событиях, связанных с соединениями, учётными записями и состоянием системы.

Обзор​

Уведомления сообщают о важных событиях сервера в реальном времени. Они публикуются в определённые темы иерархии $SYS; клиенты с нужными разрешениями могут подписаться на них.

Назначение​

Уведомления сервера позволяют:

  • Следить за соединениями — отслеживать подключения и отключения клиентов
  • Управлять учётными записями — отслеживать лимиты и использование
  • Вести аудит — записывать системные события для выполнения требований
  • Оповещать — запускать действия по системным событиям
  • Отлаживать — устранять проблемы соединений

Доступные уведомления​

События соединений​

  • Подключение клиента — публикуется при подключении клиента к серверу

    • Тема: $SYS.ACCOUNT.{account}.CONNECT
    • Содержит идентификатор клиента, IP-адрес и метаданные
  • Отключение клиента — публикуется при отключении клиента от сервера

    • Тема: $SYS.ACCOUNT.{account}.DISCONNECT
    • Содержит причину отключения и статистику

События учётных записей​

  • Соединения учётной записи — публикуется при достижении лимитов соединений
    • Тема: $SYS.ACCOUNT.{account}.CONNECTIONS
    • Оповещает о приближении к лимитам или их превышении

Требования для подписки​

Чтобы получать уведомления:

  1. Клиенту нужны разрешения на подписку на темы $SYS.>
  2. Для некоторых уведомлений требуются привилегии системной учётной записи
  3. Для уведомлений конкретной учётной записи нужен доступ к её темам

Формат сообщения​

Все уведомления используют согласованную структуру JSON:

{
"type": "io.nats.server.advisory.v1.{event_type}",
"id": "unique_event_id",
"timestamp": "2024-01-01T00:00:00Z",
"server": {
"name": "server_name",
"host": "127.0.0.1",
"id": "server_id",
"cluster": "cluster_name"
},
"data": {
// Данные конкретного события
}
}

Рекомендации​

  • Используйте группы очередей, если уведомления обрабатываются несколькими потребителями
  • Фильтруйте уведомления шаблонами тем на уровне подписки
  • Сохраняйте критически важные уведомления для аудита
  • Настройте оповещения о приближении к лимитам соединений
  • Отслеживайте частоту уведомлений для выявления аномалий