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

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

## Обзор

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

## Назначение

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

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

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

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

* [Подключение клиента](/reference/system/advisory/client-connect.md) — публикуется при подключении клиента к серверу

  * Тема: `$SYS.ACCOUNT.{account}.CONNECT`
  * Содержит идентификатор клиента, IP-адрес и метаданные

* [Отключение клиента](/reference/system/advisory/client-disconnect.md) — публикуется при отключении клиента от сервера

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

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

* [Соединения учётной записи](/reference/system/advisory/account-connections.md) — публикуется при достижении лимитов соединений

  <!-- -->

  * Тема: `$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": {

    // Данные конкретного события

  }

}
```

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

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