statsd_server

`statsd_server` 指令设置 NGINX 要将统计数据发送到的 StatsD 服务器的主机名或 IP 地址。

语法statsd_server address;
默认值none
上下文http, server, location
参数1

说明

statsd_server 指令用于指定 NGINX 应将其统计信息发送到的 StatsD 服务器地址。该指令是用于指标采集的 NGINX 模块的一部分,允许用户监控其 Web 服务器的各种性能指标。在该模块中,此指令可以在三种上下文中配置:httpserverlocation,这为定义收集和发送统计信息的位置提供了灵活性。

在配置此指令时,用户必须提供一个参数,即 StatsD 服务器的地址。如果在 http 上下文中提供了 StatsD 服务器,则该设置对该 http 块中定义的所有 serverlocation 全局生效。如果在特定的 serverlocation 块中被覆盖,则在该特定上下文中定义的 StatsD 服务器将替代全局设置。

为了有效管理流量并避免使 StatsD 服务器过载,可以将 statsd_sample_rate 指令与 statsd_server 一起使用。通过设置采样率,用户可以控制发送到服务器的统计数据的百分比,确保只传输可管理数量的数据,这在高流量环境中特别有用。

配置示例

http {
    statsd_server your.statsd.server.com;
    statsd_sample_rate 10; 

    server {
        listen 80;
        server_name www.example.com;

        statsd_count "example.requests" 1;

        location / {
            statsd_count "example.pages.index_requests" 1;
            proxy_pass http://backend;
        }
    }
}

确保 NGINX 服务器可以访问 StatsD 服务器;否则不会发送任何指标。

地址配置错误(例如主机名拼写错误)会导致统计数据发送失败,因此请仔细检查服务器地址。

← 返回所有指令