accounting

accounting 指令在 NGINX 的 stream 上下文中启用对进出流量指标的实时监控。

语法accounting on | off;
默认值off
上下文stream
参数1

说明

NGINX 中的 'accounting' 指令提供监控和记录流连接的进出流量指标的能力,从而洞察资源使用和流量模式。启用此指令后,用户可以获得可聚合并记录以供分析的详细流量统计。它需要指定一个参数以将 accounting 功能设置为 on 或 off,从而允许用户根据特定需求或资源限制自定义监控设置。

该指令在 stream 上下文中运行,stream 上下文用于处理 TCP/UDP 流量而非 HTTP。当 'accounting' 设置为 'on' 时,NGINX 开始跟踪与指定流相关的流量指标。它会记录请求和响应,并通过唯一的 'accounting_id' 跟踪指标。根据与 'accounting_log' 指令配合的日志配置,这些数据收集结果会定期导出到已配置的日志文件或监控系统。

除了 'accounting' 指令外,用户还必须使用诸如 'accounting_log' 来指定日志存储位置和 'accounting_id' 来定义如何基于流量标识符划分资源等辅助指令。这增强了对不同服务和用户群体进行细粒度流量分析的能力。

配置示例

stream {
    accounting on;
    accounting_log logs/stream-accounting.log;

    server {
        listen 12345;
        accounting_id $remote_addr;  # Track traffic by remote client IP address
    }
}

确保只在 stream 上下文中使用 'accounting' 指令;在其他上下文中使用会导致错误。

请确保定义 'accounting_log' 指令以捕获记录的指标;否则不会记录任何数据。

请谨慎选择 'accounting_id' 的格式,以避免不同 stream 之间发生冲突。

← 返回所有指令