3. Prometheus Exporter 通用配置：启动参数、监听端口、Metrics 路径与日志级别

Exporter 作为 Prometheus 生态的数据采集代理，其启动参数直接决定了采集行为、网络暴露面与运维可观测性。本章聚焦 Exporter 的四大通用配置维度：启动参数、监听端口、Metrics 路径与日志级别。这些参数在大多数官方 Exporter（node_exporter、blackbox_exporter、mysqld_exporter 等）中保持一致的语义，是 Runbook 自愈剧本中“数据采集层”标准化配置的基础。

3.1 启动参数传递方式

Exporter 通常以二进制或容器方式运行，启动参数通过命令行标志（flag）传入。主流 Exporter 均基于 kingpin 或 pflag 库解析参数，支持以下三种传递形式：

3.2 监听端口配置

监听端口是 Exporter 对外暴露 HTTP 服务的入口。Prometheus Server 通过该端口拉取 Metrics 数据。端口配置遵循以下规则：

• 默认端口：官方 Exporter 通常使用 IANA 分配的端口或社区约定端口（如 node_exporter 默认 9100，blackbox_exporter 默认 9115）。
• 自定义端口：通过 --web.listen-address=":PORT" 指定，支持 IPv4/IPv6 双栈。
• 安全约束：生产环境禁止使用 0-1023 特权端口；建议使用 9100-9999 区间，避免与业务端口冲突。
• 多实例共存：同一主机运行多个 Exporter 时，必须分配不同端口，并在 Prometheus 的 targets 中分别配置。

3.3 Metrics 路径配置

Metrics 路径是 Exporter HTTP 端点中提供 Prometheus 格式数据的 URI。默认路径为 /metrics，可通过 --web.telemetry-path 自定义。路径配置要点：

3.4 日志级别配置

日志级别控制 Exporter 输出信息的详细程度，直接影响故障排查效率与日志存储成本。通用日志级别参数为 --log.level，支持以下级别：

• error：仅输出错误信息，适用于稳定生产环境。
• warn：输出警告与错误，推荐作为默认级别。
• info：输出常规运行信息，适用于调试与上线初期。
• debug：输出详细调试信息，包含每次采集的请求/响应细节，仅用于临时诊断。

3.5 通用配置参数一览

下表汇总了 Prometheus 官方 Exporter 通用的核心启动参数，适用于 node_exporter、blackbox_exporter、mysqld_exporter、redis_exporter 等主流采集器：

3.6 配置生效验证

启动 Exporter 后，应通过以下步骤验证配置是否生效：

1. 端口监听检查：curl -v http://localhost:PORT/metrics 2>&1 | head -20，确认 HTTP 200 响应。
2. Metrics 内容检查：curl -s http://localhost:PORT/metrics | grep -E "^# HELP|^# TYPE" | head -10，确认 Prometheus 格式头部存在。
3. 日志级别验证：查看 Exporter 标准错误输出，确认日志级别与配置一致。例如 log.level=info 应输出启动信息。
4. 自愈剧本集成：在 Runbook 中增加 check_exporter_health 步骤，通过 HTTP 探活 + Metrics 样本数阈值判断 Exporter 是否正常。

# 检查 Exporter 是否存活
if curl -sf http://localhost:9100/metrics > /dev/null 2>&1; then
    echo "Exporter 存活，继续采集"
else
    echo "Exporter 无响应，触发重启"
    systemctl restart node_exporter
fi

3.7 通用配置架构图

下图展示了 Exporter 通用配置在自愈剧本中的位置与数据流关系：

3.8 常见配置陷阱与规避

• 端口绑定到 127.0.0.1：若 Exporter 仅监听 localhost，Prometheus Server 无法从其他主机拉取数据。生产环境应监听 0.0.0.0 或指定可路由 IP。
• Metrics 路径被反向代理覆盖：Nginx 或 Kong 等反向代理可能重写 URI，导致 /metrics 无法访问。需在代理层配置路径透传或使用 --web.route-prefix 调整。
• 日志级别长期设为 debug：debug 日志会记录每次采集的完整 Metrics 内容，高并发场景下每日日志量可达 GB 级。务必在诊断结束后恢复为 warn 或 info。
• 多 Exporter 端口冲突：同一主机运行多个 Exporter 时，需显式指定不同端口。建议在自愈剧本中通过端口扫描自动分配可用端口。