statsd_count

`statsd_count` 指令将计数指标发送到 StatsD 服务器,允许您跟踪特定事件的发生情况。

语法statsd_count key value [condition];
默认值none
上下文server, location, if in server, if in location
参数2-3

说明

statsd_count 指令在 NGINX 中用于在特定事件发生时(例如 HTTP 请求)将指定计数器按定义的值递增。该指标会被发送到已配置的 StatsD 服务器,从而实现对应用的监控和指标汇总。该指令接受 2 到 3 个参数:第一个是指标键(字符串),用于在 StatsD 中标识计数器;第二个是要递增的数值;可选的第三个参数是一个条件,用于基于指定的 NGINX 变量决定是否记录该计数。这可以更精细地控制哪些事件被计入。

在行为上,如果提供了第三个参数,只有当指定的 NGINX 变量评估为真值(非空或不等于 0)时,才会发送计数。这在你想避免对被视为无效或无用的情况递增计数器时特别有用。总体而言,该指令便于在生产环境中高效监控应用性能指标。

配置示例

statsd_count "your_product.requests" 1;
statsd_count "your_product.pages.index_requests" 1;
statsd_count "your_product.pages.index_responses" 1 "$request_completion";

确保 StatsD 服务器已正确配置并且从 NGINX 可达,以避免指标丢失。

注意第三个参数;如果条件变量未定义或指定不正确,计数可能不会在预期时递增。

← 返回所有指令