redis_exporter 怎么配置 HTTP 监听地址和 metrics 路径

redis_exporter 的 HTTP 监听地址由 --web.listen-address 设置，指标 URL 路径由 --web.telemetry-path 设置。例如监听 127.0.0.1:19121、路径设为 /telemetry/redis，对应的本机访问入口就是 http://127.0.0.1:19121/telemetry/redis。这两个参数不改变被采集 Redis 的地址。

官方地址：https://github.com/oliver006/redis_exporter

把监听入口和 Redis 目标分开配置

一个常见部署场景是：同一主机已经有服务占用默认监控端口，或者统一入口要求不同组件使用不同的指标路径。这时需要调整的是 exporter Web 端点，而不是 Redis 服务本身。先把三个配置对象列清楚，后面的部署模板才不容易串线。

当前项目文档列出的默认 Web 监听是 0.0.0.0:9121，默认指标路径是 /metrics。监听地址表示本进程在哪个本地地址接受连接；它不是让客户端原样填写的“服务器网址”。尤其 0.0.0.0 是绑定含义，调用方仍应使用可达的主机地址。

用最小启动命令固定地址与路径

# 本机HTTP端点使用19121端口，指标路径改为/telemetry/redis。
# redis.addr是被采集的Redis地址，与HTTP监听参数独立。
./redis_exporter \
  --redis.addr=redis://127.0.0.1:6379 \
  --web.listen-address=127.0.0.1:19121 \
  --web.telemetry-path=/telemetry/redis

示例按前台方式启动，不自行创建后台任务。路径以斜杠开头，监听参数只包含主机与端口，不填写 http:// 前缀。这里没有真实 Redis 凭据，也没有连接目标实例；命令是部署示例，不能把它读成已成功运行的记录。

绑定 127.0.0.1 适合访问者位于同一网络命名空间的情况。若远程采集端或其他容器要访问，应结合实际网络拓扑选择绑定地址，并配置相应访问边界。不要为了解决连不上就无条件扩大到所有接口；也不要在容器内绑定回环后，期待端口发布自动让它成为对外可达的服务。

更改指标路径时，需要同步所有使用这个端点的消费者。改成 /telemetry/redis 后，应把旧的 /metrics 当作需要迁移的配置引用，不假设两个地址都继续导出同一份指标。本文只讨论 exporter 的 Web 配置，不展开采集端的抓取规则。

部署模板怎样传入同一组配置

# 环境变量写法表达同一配置，不再重复提供对应的命令行参数。
REDIS_ADDR=redis://127.0.0.1:6379 \
REDIS_EXPORTER_WEB_LISTEN_ADDRESS=127.0.0.1:19121 \
REDIS_EXPORTER_WEB_TELEMETRY_PATH=/telemetry/redis \
./redis_exporter

项目为上述 Web 参数提供了对应环境变量：REDIS_EXPORTER_WEB_LISTEN_ADDRESS 和 REDIS_EXPORTER_WEB_TELEMETRY_PATH。自动化模板可以选用环境变量写法，但应固定一个权威配置来源，避免部署文件写了一套，启动脚本又追加另一套。

环境变量属于进程启动配置。修改模板文件后，还需要由现有服务管理方式把新配置带入新进程，不能假设编辑文件就已经改变当前监听。变更记录应保存最终地址、路径、配置来源和适用部署实例，使维护者能从配置定位到入口。

# 只查看当前二进制支持的选项；本文未运行此命令。
./redis_exporter --help

交付前可在目标环境按实际二进制帮助确认选项名称，项目 master 文档不是所有历史发布版的保证。自动化应固定所使用的版本或镜像标识，再维护对应参数；本文不声称任意版本都完全一致。

按失败类型定位入口问题

这是读者部署时的定位顺序，不是本文已经执行的验证结果。HTTP 端点可访问和 Redis 数据可采集是两种状态，通知中也应分别描述。否则一条“监控正常”的消息可能只说明端口在接受请求，没有说明采集连接是否满足预期。

若前面还有代理，外部访问路径与 exporter 内部路径可能不同。交接时记录两者的映射，特别是代理是否保留或移除路径前缀；不能把外部路径直接粘贴到内部参数，再期望两层配置自动对齐。

变更通知与常见问题

本次变更通知至少写明部署实例、HTTP绑定地址、对外访问地址、指标路径以及回退配置。失败时保存错误类型与对应配置项，避免把凭据或整份环境转储带进日志。流程的目标是让后续维护者知道哪一层发生变化，而不是只宣布“端口改好了”。

改监听端口会改 Redis 端口吗？不会。HTTP监听与 redis.addr 是独立配置，后者才决定采集连接目标。

telemetry-path 要写完整 URL 吗？不需要，填写 URL 路径；协议、主机与端口由实际访问入口决定。

在同机能访问，另一台机器不行怎么办？先看是否只绑定了回环地址，再结合网络访问规则与容器拓扑定位，不直接改采集目标。

换一个隐蔽路径能作为鉴权吗？不能。路径命名是路由配置，访问控制仍需使用部署环境提供的明确机制。

参考：redis_exporter 项目配置文档。