Уведомления сервера
Сервер NATS публикует уведомления о значимых событиях, связанных с соединениями, учётными записями и состоянием системы.
Обзор
Уведомления сообщают о важных событиях сервера в реальном времени. Они публикуются в определённые темы иерархии $SYS; клиенты с нужными разрешениями могут подписаться на них.
Назначение
Уведомления сервера позволяют:
- Следить за соединениями — отслеживать подключения и отключения клиентов
- Управлять учётными записями — отслеживать лимиты и использование
- Вести аудит — записывать системные события для выполнения требований
- Оповещать — запускать действия по системным событиям
- Отлаживать — устранять проблемы соединений
Доступные уведомления
События соединений
-
Подключение клиента — публикуется при подключении клиента к серверу
- Тема:
$SYS.ACCOUNT.{account}.CONNECT - Содержит идентификатор клиента, IP-адрес и метаданные
- Тема:
-
Отключение клиента — публикуется при отключении клиента от сервера
- Тема:
$SYS.ACCOUNT.{account}.DISCONNECT - Содержит причину отключения и статистику
- Тема:
События учётных записей
- Соединения учётной записи — публикуется при достижении лимитов соединений
- Тема:
$SYS.ACCOUNT.{account}.CONNECTIONS - Оповещает о приближении к лимитам или их превышении
- Тема:
Требования для подписки
Чтобы получать уведомления:
- Клиенту нужны разрешения на подписку на темы
$SYS.> - Для некоторых уведомлений требуются привилегии системной учётной записи
- Для уведомлений конкретной учётной записи нужен доступ к её темам
Формат сообщения
Все уведомления используют согласованную структуру 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": {
// Данные конкретного события
}
}
Рекомендации
- Используйте группы очередей, если уведомления обрабатываются несколькими потребителями
- Фильтруйте уведомления шаблонами тем на уровне подписки
- Сохраняйте критически важные уведомления для аудита
- Настройте оповещения о приближении к лимитам соединений
- Отслеживайте частоту уведомлений для выявления аномалий