rtmp_stat
'rtmp_stat' 指令在响应 Web 请求时生成 RTMP 流媒体统计信息。
NGINX RTMP module
·
httpserverlocation
语法rtmp_stat path;
默认值none
上下文http, server, location
参数1+
说明
rtmp_stat 指令是 NGINX RTMP 模块的一部分，提供了一种通过 HTTP 端点让管理员查看流媒体统计信息的方法。启用后，它会输出与活动 RTMP 流相关的关键指标，包括连接客户端数、流的总数，以及每个流的详细统计信息，例如流名称、传输的字节数和连接时间。这些统计数据对于实时监控服务器性能和流活动非常有价值。
http、server 或 location 上下文中可以使用此指令。其基本功能是定义一个 URL 路径，通过该路径可以访问 RTMP 统计信息。如果指定了多个 rtmp_stat 指令，可在不同的端点暴露统计信息。提供的统计可以以多种格式呈现，通常为 XML，从而便于与报告工具或面向人类的监控界面集成。
为了便于访问控制，可以与 rtmp_stat 配合配置基于 IP addresses 的访问限制等选项。这样管理员就能保护统计端点，确保只有授权用户能够检索敏感的流数据。由于统计信息可能反映服务器负载和资源使用情况，因此管理对这些信息的访问对于维护服务器安全性和性能至关重要。
配置示例
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;
}
}
}⚠
确保限制对 rtmp_stat URL 的访问，以防止未授权用户查看流媒体统计信息。
⚠
如果 RTMP 统计信息未按预期显示，请检查你的 NGINX 错误日志，因为错误配置可能导致静默失败。
⚠
该指令必须放在正确的配置上下文中才能生效（必须位于 'http'、'server' 或 'location' 下）。