rtmp_stat

Директива 'rtmp_stat' генерирует статистику RTMP-потоков в ответ на веб-запросы.

Синтаксисrtmp_stat path;
По умолчаниюnone
Контекстhttp, server, location
Аргументы1+

Описание

Директива rtmp_stat является частью модуля NGINX RTMP и предоставляет администраторам возможность просматривать статистику потоков через HTTP-конечную точку. При включении она выводит ключевые метрики, связанные с активными RTMP-потоками, включая количество подключённых клиентов, общее число потоков и подробную статистику для каждого потока, такую как его имя, количество переданных байт и время соединения. Эти статистические данные могут быть бесценны для мониторинга производительности сервера и активности потоков в реальном времени.

Эта директива может использоваться в контекстах http, server или location. Базовая функциональность заключается в определении URL-пути, через который можно получить доступ к статистике RTMP. Если задано несколько директив rtmp_stat, их можно использовать для публикации статистики на разных конечных точках. Предоставляемая статистика может быть отображена в различных форматах, обычно в XML, что облегчает интеграцию с инструментами отчётности или создание удобных для человека интерфейсов мониторинга.

Для организации контроля доступа можно настроить опции, например ограничение доступа на основе IP-адресов в связке с rtmp_stat. Это позволяет администраторам защитить конечную точку статистики, обеспечивая, что только авторизованные пользователи могут получать конфиденциальные данные потоков. Поскольку статистика может отражать нагрузку сервера и использование ресурсов, управление доступом к этой информации критично для поддержания безопасности и производительности сервера.

Пример конфига

http {
    server {
        listen 8080;

        location /stat {
            # Enabling the RTMP statistics endpoint
            rtmp_stat all;
            # Allowing only localhost access to statistics
            allow 127.0.0.1;
            deny all;
        }
    }
}

Убедитесь, что вы ограничили доступ к URL rtmp_stat, чтобы предотвратить просмотр статистики трансляций неавторизованными пользователями.

Проверьте журналы ошибок NGINX, если статистика RTMP не отображается как ожидалось, поскольку неверные настройки могут приводить к неочевидным сбоям.

Директива должна быть корректно размещена в контексте конфигурации, чтобы работать (она должна находиться в 'http', 'server' или 'location').

← Ко всем директивам