Конфигурация событий

RUSEON Core публикует асинхронные системные уведомления и AI-телеметрию через HTTP Вебхуки и MQTT. Настройка выполняется в секции events файла config.yaml.

---

Вебхуки (Webhooks)

Вебхуки позволяют RUSEON Core отправлять HTTP POST запросы с телом JSON при наступлении системных событий.

Параметр	Тип	Описание
url	string	Целевой HTTP/HTTPS адрес получателя.
topics	[]string	Список отслеживаемых топиков (или ["*"] для всех).
secret	string	Секретный ключ HMAC-SHA256 для подписи запросов в заголовке X-Signature.

Поддерживаемые топики событий

• camera_online: Срабатывает при успешном подключении RTSP и получении видеокадров.
• camera_offline: Срабатывает при разрыве связи с камерой (содержит причину error).
• archive_segment_ready: Срабатывает при завершении записи часового fMP4 сегмента архива.
• recording_failed: Срабатывает при ошибках ввода-вывода (I/O) на диске.
• storage_warning: Срабатывает при заполнении диска свыше 90%.

Пример конфигурации вебхука

events:
  webhooks:
    - url: "https://vms.company.local/api/hooks"
      topics:
        - "camera_online"
        - "camera_offline"
        - "archive_segment_ready"
        - "recording_failed"
        - "storage_warning"
      secret: "super-secret-hmac-key"

---

MQTT

RUSEON Core транслирует AI-метаданные и телеметрию в реальном времени брокеру MQTT через неблокирующую lock-free очередь.

Параметр	Тип	Описание
enabled	bool	Включает фонового издателя MQTT.
broker	string	Адрес брокера (например, tcp://localhost:1883 или ssl://mqtt.company.local:8883).
username	string	Логин для авторизации на брокере (опционально).
password	string	Пароль для авторизации на брокере (опционально).
topic	string	Базовый топик для публикации (например, ruseon/metadata).

Пример конфигурации MQTT

events:
  mqtt:
    enabled: true
    broker: "tcp://localhost:1883"
    username: "ruseon_publisher"
    password: "mqtt_password_123"
    topic: "ruseon/metadata"