Linux部署Prometheus监控Redis及Exporter配置教程

本文深入剖析了在Linux环境下部署Prometheus监控Redis时，Redis Exporter配置的常见陷阱与核心要点：它绝非“开箱即用”，必须严格依据Redis实例的真实连接方式（如密码认证、集群架构、非标准端口或TLS加密）精准传参启动，否则虽能访问metrics端口却无任何有效指标；文章系统揭示了从redis_exporter命令行参数（-redis.addr、-redis.password、-redis.tls-enabled、-redis.multi-targets）、systemd服务健壮性配置（Type=simple、Restart策略、非root用户），到Prometheus抓取配置（target地址匹配、监听绑定0.0.0.0、防火墙放行）、Grafana看板调试（指标缺失根源、表达式适配、时间范围设置）等全链路关键细节，并特别强调单个Exporter仅监控单一节点的本质特性——想真正掌握Redis集群健康状况，必须结合多实例部署与Prometheus高级重标记能力，避免被表面“正常运行”所误导。

直接说结论：Redis Exporter 不是“装完就能用”，必须按 Redis 实例的实际连接方式（有无密码、是否集群、端口是否非标）传参启动，否则 redis_exporter 启动后 metrics 端口（默认 9121）能访问，但所有指标都是空的或报错。

redis_exporter 启动时必须指定 -redis.addr 和认证参数

很多用户卡在第一步：启动 redis_exporter 后访问 http://localhost:9121/metrics，页面能打开，但内容里全是 # HELP redis_... 注释，没有实际指标值。这是因为 exporter 没连上 Redis，但默认不报错也不退出。

关键点：

• -redis.addr 必须写完整地址，例如 redis://127.0.0.1:6379 或 redis://192.168.10.5:6380；仅写 127.0.0.1:6379 在新版（v1.67+）中可能失败
• 如果 Redis 有密码，必须加 -redis.password=yourpass；空密码不能省略该参数，得显式写 -redis.password=
• 若 Redis 开启了 TLS（如云数据库），需加 -redis.tls-enabled 并挂载证书，否则连接拒绝
• 集群模式下，redis_exporter 默认只采集第一个节点，如要全量，得用 -redis.multi-targets 配合服务发现，不是简单改地址就行

systemd 服务配置里容易漏掉 Type=simple 和 Restart

用 systemctl 管理时，常见错误是复制网上模板却没改关键字段，导致服务看似 running，实则崩溃后不重启。

正确配置要点：

• Type=simple（不是 forking）——因为 redis_exporter 是前台进程，不 fork 子进程
• 必须加 Restart=on-failure 和 RestartSec=5，否则启动失败（比如连不上 Redis）后就停在那里，systemctl status 显示 active (exited)，但没人知道它早挂了
• User= 推荐设为非 root 用户（如 redis-monitor），避免权限过大；同时确保该用户对日志目录有写权限
• ExecStart 建议写绝对路径，例如 /usr/local/redis_exporter/redis_exporter，别用 ./redis_exporter

prometheus.yml 中 job 的 static_configs 地址必须和 exporter 实际监听地址一致

很多人把 redis_exporter 跑在 Redis 本机（127.0.0.1:9121），却在 prometheus.yml 里填了外网 IP 或主机名，结果 Prometheus 抓不到数据，Status > Targets 页面显示 DOWN，错误信息是 server returned HTTP status 403 Forbidden 或直接 timeout。

检查逻辑链：

• Prometheus 能否从自身网络环境访问到 redis_exporter 的 :9121/metrics？用 curl -v http://:9121/metrics 在 Prometheus 所在机器上试
• 如果 exporter 启动时用了 -web.listen-address=127.0.0.1:9121，那只有本机能访问；生产环境应改为 0.0.0.0:9121
• 防火墙（firewalld 或云安全组）必须放行 9121 端口，CentOS 7 默认是关的
• 不要在 static_configs.targets 里写 localhost —— 这是 Prometheus 容器或本机的 localhost，不是 exporter 所在机器的

Grafana Dashboard 导入后 Memory Usage 图表为空的典型原因

导入社区 Redis Dashboard for Prometheus Redis Exporter 后，Memory Usage 面板显示 “No data”，不是配置错了，而是指标本身缺失或表达式不匹配。

常见真实原因：

• redis_memory_max_bytes 返回 0：说明 Redis 没配 maxmemory，或者 exporter 权限不够读不到 INFO memory 段。此时得手动把面板表达式里的 redis_memory_max_bytes 改成你预设的上限值，比如 1073741824（1GB）
• redis_memory_used_bytes 为 NaN：通常是 Redis 实例不可达，或 exporter 启动参数里 -redis.addr 写错，导致指标根本没采集到
• Dashboard 版本和 exporter 版本不兼容：v1.80.1 的 exporter 默认开启 redis_slowlog_length，但旧版 Dashboard 可能还在查已废弃的 redis_slowlog_last_id，得进面板 edit → Metrics → 删掉无效 query
• 时间范围选太小：Prometheus 默认抓取间隔是 15s，如果 Grafana 时间范围选成 last 5s，大概率没数据，拉宽到 last 5m 再看

最易被忽略的一点：Redis Exporter 采集的是 *它所连接的那个 Redis 实例* 的指标。如果你监控的是 Redis Cluster，单个 exporter 只反映一个节点状态，不代表整个集群 —— 这不是 bug，是设计使然。需要多实例部署 + Prometheus relabeling 才能聚合。

到这里，我们也就讲完了《Linux部署Prometheus监控Redis及Exporter配置教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于Linux的知识点！