首页/云/可观测性速查/redis_exporter:Redis 指标采集
Prometheus 与采集64 条

redis_exporter:Redis 指标采集

redis_exporter 采集 Redis 内存、连接与命中率;默认端口 9121,常用指标包括 redis_up、redis_memory_used_bytes 与 keyspace hits/misses 计数。

可观测性速查云更新于 2026-10-13

redis_exporter 是什么

redis_exporter 通过 INFO、CONFIG 等命令采集 Redis 的内存、连接、命中率与持久化状态,并以 /metrics 暴露给 Prometheus,默认监听 9121 端口。它是 Redis 监控的基础组件:单机、主从、Cluster 都能接,配合 redis_up 判断可连接性,用内存与命中率指标做容量与性能分析。

基本信息

默认端口9121
采集对象Redis 单机 / 主从 / Sentinel / Cluster
连接方式redis:// 地址,支持密码与 TLS
关键指标redis_up、内存、连接数、命中率
多实例方式exporter 代理采集或多实例各跑一份
依赖需要能执行 INFO 等只读命令

典型使用场景

  • 监控 Redis 内存使用率,逼近 maxmemory 时提前扩容
  • 用命中率下降发现缓存穿透或键大量过期
  • 监控连接数,避免达到 maxclients 造成拒绝服务
  • 观察主从延迟与复制状态,及时发现问题实例
  • 关注持久化(RDB 保存、AOF 重写)失败与耗时
  • 多实例场景统一采集,按 instance 标签区分

配置与运行

配置与运行
redis_exporter --redis.addr=redis://127.0.0.1:6379   # 无密码
redis_exporter --redis.addr=redis://127.0.0.1:6379 --redis.password=***

# 常用查询
redis_up                                              # 可连接性
redis_memory_used_bytes / redis_memory_max_bytes       # 内存使用率(注意 max 为 0)
sum(rate(redis_keyspace_hits_total[5m]))
  / (sum(rate(redis_keyspace_hits_total[5m])) + sum(rate(redis_keyspace_misses_total[5m])))  # 命中率

关键指标读法

指标含义异常信号
redis_up能否成功采集0 表示连接失败或被拒
redis_memory_used_bytes已用内存逼近 maxmemory 需扩容
redis_connected_clients当前连接数接近 maxclients 有风险
redis_keyspace_hits/misses命中与未命中计数命中率持续下滑
redis_commands_duration_seconds_total慢命令耗时汇总单项耗时异常增长
多实例场景可让 exporter 按 target 参数代理采集,或多实例各跑一份由 Prometheus 分别抓取;前者省进程,后者隔离性更好。
redis_memory_max_bytes 为 0 表示未设置上限,直接相除会得到 Inf;判断内存风险要先看该指标是否为 0。
耗时命令(如大 key 扫描、慢查询统计)会拉长采集时间,抓取 timeout 要留足余地,必要时避开业务高峰。
主从与 Cluster 场景关注点不同:主从看复制延迟与偏移量,Cluster 还要看槽位分布与节点角色是否稳定。
内存增长要结合键数量与过期策略一起看:键数不涨而内存涨,往往是大 key 或碎片率升高。

易错点

  • redis_memory_max_bytes 为 0 表示未设置上限,直接相除会得到 Inf 并让看板失去意义
  • 耗时命令会拉长采集时间,抓取超时设置过短会造成周期性抓取失败
  • 密码或 ACL 权限不足时采集静默失败,redis_up 变 0 但容易只看内存曲线而忽略
  • 命中率是累计计数的比值,用瞬时值相除会失真,应先 rate 再比
  • 多实例共用一份 exporter 代理采集时,实例参数写错会把 A 的指标标成 B,需要按 instance 标签核对
  • 把命中率低直接等同于故障会误判:业务刚上线预热阶段命中率天然偏低,判断要结合键数量与时间

数据来源与参考

  • redis_exporter 项目文档(github.com/oliver006/redis_exporter)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌