push_stream_channels_statistics
为 NGINX Push Stream 模块启用频道统计。
NGINX push stream module
·
location
语法push_stream_channels_statistics;
默认值none
上下文location
参数none
说明
push_stream_channels_statistics 指令用于 NGINX Push Stream 模块，用以启用对各个通道统计数据的收集和检索。 这在监控方面尤其有用，因为它允许用户跟踪诸如每个通道的活跃订阅者数量、发送的消息数量以及其他相关指标。当在 location 块中启用时，它会将该端点转换为通道统计报告端点，并可根据请求参数以 JSON 格式输出数据。
该指令不接受任何参数，并应添加到 location 上下文中，这意味着其作用域局限于服务器配置中定义的特定 URL 模式。一旦在某个 location 激活该指令，用户即可通过特定的查询参数访问通道统计信息，例如指定 channel ID 或请求所有通道的汇总统计。此功能可帮助管理员洞察通道活动和资源使用情况，从而优化使用推流功能的应用程序的整体性能。
配置示例
server {
location /channels-stats {
push_stream_channels_statistics;
push_stream_channels_path $arg_id;
}
}⚠
确保该指令在 location 块内使用；它与上下文相关，在此上下文之外无法正确工作。
⚠
在访问统计信息时，请正确指定查询参数以避免错误响应。