Redis Exporter不是装完就能用，必须按Redis实例实际连接方式（密码、集群、非标端口等）正确传参启动，否则metrics端口可访问但无指标值。
直接说结论：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://<exporter-host>:9121/metrics</exporter-host>在 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 才能聚合。
