redis_exporter需分别部署在主从节点并打标role，通过redis_replication_offset{role="master"}与redis_replication_offset{role="slave"}差值计算延迟，结合deriv和master_link_status实现精准告警。
怎么用 redis_exporter 拿到主从延迟指标
redis_exporter 本身不直接暴露 master_last_io_seconds_ago 或 slave_repl_offset 这类原始字段，它只把 INFO replication 解析后映射为 Prometheus 可识别的指标。关键指标是：redis_replication_master_last_io_seconds_ago（从节点视角）和 redis_replication_offset（主/从各自 offset）。你必须明确采集目标是**从节点**，否则 master_last_io_seconds_ago 不会出现。
常见错误：把 exporter 部署在主节点上、却指望它上报从节点延迟——这不可能。Exporter 只能反映它所连接的那个 Redis 实例的状态。
- 确保每个从节点都运行一个独立的 redis_exporter 实例，
--redis.addr指向本地从节点（如redis://127.0.0.1:6380） - Prometheus 的
scrape_configs中 target 必须是这些从节点上的 exporter 地址（如http://slave1:9121/metrics），不是 Redis 端口 - 检查采集到的指标是否存在：
curl http://slave1:9121/metrics | grep master_last_io，没结果说明 exporter 没连对实例或 Redis 版本太低（
为什么 redis_replication_master_last_io_seconds_ago 值一直为 0
这个值为 0 表示从节点当前与主节点通信正常，最近一次 IO 在 1 秒内发生。但它**不是延迟本身**，只是“最后一次心跳过去多久”，不能代替数据同步滞后量。真正反映复制 lag 的是 offset 差值。
容易忽略的点：主从之间网络通畅 ≠ 数据已应用。比如主节点写入快、从节点解析慢（CPU 高、大 key、Lua 阻塞），master_last_io_seconds_ago 仍可能为 0，但 redis_replication_offset 差值已在增长。
- 务必同时采集主节点的
redis_replication_offset（通过主节点上的 exporter）和从节点的同名指标 - 在 Prometheus 中用 PromQL 计算差值：
redis_replication_offset{role="master"} - redis_replication_offset{role="slave"}，注意 label 要提前打上role - 如果从节点没打
role="slave"label，可用instance=~".*:6380"之类硬匹配，但不推荐——label 应在 exporter 启动时注入：--web.telemetry-path="/metrics" --redis.label="role=slave"
如何配置 Prometheus 告警规则判断真实延迟
只监控 master_last_io_seconds_ago > 30 是片面的，它只能发现断连，漏掉“假在线真滞后”场景。真正要告警的是 offset 差值持续扩大 + 无下降趋势。
推荐组合条件，避免误报：
- offset 差值 > 10MB（按业务写入速率换算，例如 1MB/s 写入 × 10s = 10MB 安全阈值）
- 该差值在过去 2 分钟内单调递增（用
deriv(redis_replication_offset[2m])判断斜率是否 > 0） - 同时
redis_replication_master_link_status == 1（确认链路未断，排除网络抖动干扰）
告警表达式示例：
ALERT RedisReplicationOffsetLagHigh<br> IF (redis_replication_offset{role="master"} - redis_replication_offset{role="slave"}) > 10485760 AND deriv(redis_replication_offset{role="slave"}[2m]) > 0 AND redis_replication_master_link_status{role="slave"} == 1<br> FOR 1m<br> LABELS { severity = "warning" }<br> ANNOTATIONS { summary = "Redis slave offset lag exceeds 10MB and is increasing" }
redis_exporter 启动参数和 label 打标容易踩的坑
不加参数裸跑 redis_exporter，所有指标都缺上下文，Prometheus 查不到主从关系，告警规则根本写不出来。
最常漏的三项：
-
--redis.password必须显式传空字符串""（而非省略），否则遇到有密码的 Redis 会静默失败，日志里只打印 “connection refused” -
--redis.alias仅影响 metric 标签中的alias字段，不能替代role；要用--redis.label="role=slave"才能让role出现在所有指标中 - 多个从节点共用一个 exporter 实例？不行。redis_exporter 不支持多实例轮询，每个 Redis 实例必须配一个 exporter 进程，否则指标混杂、无法区分来源
复杂点在于：offset 差值告警依赖主从指标时间戳严格对齐。如果主从 exporter 抓取间隔不一致（比如主 15s、从 30s），差值计算会因采样错位而失真。统一设为 scrape_interval: 15s 最稳妥。
