markuslindenberg/nginx_request_exporter

Prometheus的Nginx请求导出器

这是一个用于Prometheus的Nginx请求导出器。

与现有导出器不同，nginx_request_exporter不通过stub status模块抓取服务器状态，而是记录HTTP请求的统计数据。默认情况下，它在9147端口监听HTTP请求。

安装方式

使用go get

go get github.com/markuslindenberg/nginx_request_exporter

使用Docker

docker pull markuslindenberg/nginx_request_exporter
docker run --rm -p 9147:9147 -p 9514:9514/udp markuslindenberg/nginx_request_exporter

配置说明

Nginx日志配置

nginx_request_exporter通过syslog协议接收日志，需在Nginx配置中添加以下内容：

1. 定义自定义日志格式（在http上下文）：

log_format prometheus 'time:$request_time status=$status host="$host" method="$request_method" upstream="$upstream_addr"';

2. 启用syslog日志输出：

access_log syslog:server=127.0.0.1:9514 prometheus;

注意事项

• 日志格式仅支持键值对：冒号分隔指标（如time:$request_time），等号分隔标签（如status=$status）。
• 修改日志格式后需重启nginx_request_exporter生效。

核心功能

• 收集Nginx请求的时间、状态码、主机、请求方法等指标。
• 支持自定义日志格式，可扩展监控维度。
• 输出Prometheus兼容的指标数据，用于可视化和告警。

使用场景

• 监控Nginx服务的请求性能（如响应时间分布）。
• 分析请求状态码分布（如4xx/5xx错误占比）。
• 跟踪上游服务的请求转发情况。