graphite_default_data

`graphite_default_data` 指令指定在给定的 location 或 server 上下文中要收集并发送到 Graphite 服务器的默认指标。

语法graphite_default_data data_template [data_params];
默认值none
上下文http, server
参数1-2

说明

graphite_default_data 指令允许用户定义默认的指标模板和参数,NGINX Graphite 模块在向 Graphite 服务器报告数据时会使用这些模板和参数。该指令可以接受一个或两个参数。第一个参数通常指定一个数据模板字符串,用于定义如何命名被收集的指标。例如,模板可以是 nginx.$server.$location,这会基于 NGINX 的 server 和 location 上下文动态生成指标名称。第二个可选参数允许将额外参数附加到指标名称中,从而实现更细粒度的指标报告,例如不同的查询参数或特定上下文信息。

当该指令出现在 httpserver 上下文中时,会影响该上下文内处理的所有请求。数据会被聚合,并按指定的间隔发送到目标 Graphite 服务器。这种灵活性使其非常适合具有多个 server blocks 或 locations 的环境,在这些环境中不同的指标可能是相关的。对默认数据参数的正确管理可确保准确且全面的指标报告,帮助用户有效地监控性能与健康状况。

配置示例

http {
    graphite_default_data nginx.default;  
    server {
        location /api/ {
            graphite_default_data api.metrics;  
        }
    }
}

该指令不能在 location 上下文中指定;必须在 httpserver 块中使用。

确保在 graphite_default_data 中定义的数据模板与 Graphite 服务器所期望的结构一致。

← 返回所有指令