登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  数据库 >  Redis

Redis INFO commandstats 怎样查看命令调用统计

来源:17golang原创

时间:2026-11-19 10:49:49 476浏览 收藏

执行 INFO commandstats 可以查看 Redis 按命令类型汇总的调用统计。重点看 calls(进入命令执行的次数)、usec(累计 CPU 时间)和 usec_per_call(每次执行的平均 CPU 时间)。它们适合判断命令负载构成,不能直接当作客户端请求的端到端延迟。

官方地址:https://redis.io/docs/latest/commands/info/

如果要给监控页面设计一个统计接口,我会保留原始计数,再计算区间指标,而不只返回一个“平均耗时”。这样更容易解释忙的是哪类命令,也能保留排查依据。以下是接口设计建议与假设示例,没有虚构线上实测。

先确定统计接口要回答什么

先让调用方明确自己的问题:是看累计调用构成,还是看最近一段时间的压力?这两种视图不能混在一个未标明时间范围的排行榜里。建议接口携带实例标识、采集时间、命令名和原始字段,页面再标出累计视图或区间视图。

我倾向于把该接口命名为命令资源统计,避免“接口响应速度”这样的表述。统计没有业务路由、调用方或键名维度,不能据此认定某个用户请求就是慢请求。

读取命令分组并解释字段

# 通过已配置认证与连接参数的客户端读取命令统计,不在命令中写密钥
redis-cli --raw INFO commandstats

返回文本中按 cmdstat_命令名识别记录,冒号右侧是逗号分隔的字段。不要依赖固定行号或字段排列。根据官方 INFO 字段定义,可用下表理解核心值。

字段解释阅读注意
calls进入命令执行的调用次数并非所有被拒绝请求的总和
usec累计 CPU 时间,微秒次数多也能造成总量大
usec_per_call平均每次执行 CPU 时间不是尾延迟或网络往返
rejected_calls被拒绝的调用次数单独展示
failed_calls失败的调用次数不能用 calls 代替成功数
命令统计记录与计数、耗时字段的结构关系
结构说明图:命令记录包含调用计数与CPU字段,两组数据共同解释负载。

为区间指标保留原始计数

累计平均会受到很久以前的流量影响。我的选择是为同一实例、同一命令保存两份原始采样,按本次减上次计算。区间调用量记作 Δcalls,区间CPU时间记作 Δusec;当 Δcalls 大于零时,区间均值为 Δusec / Δcalls。每秒调用量则使用 Δcalls 除以采样间隔秒数。

不能相减两次 usec_per_call 来得到区间均值。平均值不是可直接相减的计数。采集时间应使用可靠的时间间隔;零间隔、倒退时间和无调用窗口都应显示不可计算原因,而不是除零或填成看似正常的耗时零。

把异常和字段缺失分别处理

解析层先按行拆开,再用首个冒号分离命令标识和字段集合,每个字段用首个等号拆分。calls、usec 等计数按整数读取,平均字段按小数读取。保留未知字段,但缺少必需字段时将该条记录标成不完整,不能默认为零。

如果新计数小于旧计数,先把这个采样对标成不可比较,保存本次作为新基线。这可能是重启、统计重置或切换了实例,不能把负差值取绝对值。读取失败、权限拒绝与真正的零调用也要分开显示。

为了看一分钟压力而清空共享统计,会影响其他观察者;我更愿意在采集侧保留基线。这里不需要执行统计重置命令。

保持多实例与版本兼容

每个实例单独保存基线,故障切换后不要把两个进程的计数直接相减。对集群汇总区间均值时,可比较窗口里的 Δusec 求和除以 Δcalls 求和,不能对各实例均值做简单平均。

返回字段会因版本和运行状态不同而变化。接口应把“未提供”作为独立状态,容忍新增字段。本文只要求上表核心值,不把额外统计字段当作所有部署都具有的能力。若使用大整数计数,给前端的序列化格式还要避免整数精度丢失。

实例、两份采样与区间计数及平均值的依赖关系
结构说明图:两份采样属于同一实例,区间均值依赖计数差值;无箭头连线仅表达静态依赖。

用一组假设数据理解结果

假设同一命令第一次采样 calls=800、usec=4000,第二次为 calls=1000、usec=5400,相隔10秒。由此推算区间有200次执行,每秒20次,区间平均CPU时间为7微秒。这些数值只用于算术说明,不是实际采样结果。

这种视图适合先定位资源占比较大的命令类型。若目标是排查业务请求延迟,还需要客户端耗时等独立信息,不应给统计字段增加其没有的含义。

usec_per_call 大就一定最耗资源吗?

不一定。低频高均值与高频低均值的总消耗可能不同,需要同时看区间总CPU时间和调用次数。

calls 可以直接当成功数吗?

不可以,它描述进入执行的次数。失败与拒绝字段要按各自定义处理,不能把请求、执行和成功混为一谈。

命令行没有出现某个命令怎么办?

保留缺失状态,检查实际返回、实例与采集范围,不要伪造一条零值记录来掩盖缺失原因。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>