Redis FUNCTION STATS 怎么查看运行中函数：调用次数、耗时与内存指标边界

线上 Redis 延迟告警时，慢的未必是普通命令，也可能是某个 Redis Function 正在占住主线程。排查这类问题可以先执行 FUNCTION STATS：它返回当前正在运行的函数、调用命令和已经持续的毫秒数；如果此刻没有函数执行，running_script 就是空值。这个命令适合回答“现在谁在跑、跑了多久”，不负责提供历史调用次数或平均耗时。

先把现场问题分成“当前阻塞”还是“历史趋势”

函数运行时间较长时，Redis 主线程会持续处理这段函数逻辑，其他客户端的请求可能排队。此时最有价值的不是先看一张长期曲线，而是确认当前执行对象。Redis 官方文档把 FUNCTION STATS 的返回拆成两个部分：running_script 描述在途函数，engines 描述可用执行引擎及其函数、库数量。

这个边界决定了处置顺序：先用它确认正在运行的函数，再判断是否应该终止；不要因为看到 engines 里的数量，就误以为拿到了每个函数的历史调用次数。

用 Redis 8.0 复现一个可观察的长函数

下面的实验加载一个名为 obsdemo 的 Lua 函数库。slow_probe 读取第一个键参数，把它当作毫秒数，在 Redis 内部循环等待；这个函数只为复现观测窗口，生产环境不要用忙等模拟延迟。

redis-cli -p 6380 FUNCTION LOAD REPLACE '#!lua name=obsdemo
redis.register_function("slow_probe", function(keys, args)
  local until_ms = redis.call("TIME")[1] * 1000 + tonumber(keys[1])
  while redis.call("TIME")[1] * 1000 

实验中用第二个客户端在 FCALL 尚未返回时执行 FUNCTION STATS。屏幕上应同时看到 name=slow_probe、包含 FCALL 的 command，以及不断增加的 duration_ms。这三项正好对应“谁在跑、怎么被调用、已经跑了多久”。

根据返回值决定是否继续等待或终止

如果 duration_ms 已经超过业务允许的窗口，先确认命令确实来自预期客户端，再考虑 FUNCTION KILL。终止动作不是普通的“超时重试”：它会结束当前函数，调用方会收到错误，业务侧必须有幂等和恢复处理。

redis-cli -p 6380 FUNCTION STATS
redis-cli -p 6380 FUNCTION KILL
redis-cli -p 6380 FUNCTION STATS

测试中终止后再次查询，running_script 应为空，而 engines 仍保留 obsdemo 库的元信息；其中 libraries_count 和 functions_count 可用来核对当前引擎里仍加载着 1 个库和 1 个函数。这个前后变化比单看一条慢日志更能确认“在途函数已经退出”。

把 FUNCTION STATS 放进排障架构，而不是指标仓库

线上排障可以把它放在人工确认或自动化诊断脚本的第一步：业务延迟升高时读取一次，记录函数名、原始命令和持续时间；若命中明确的超时策略，再走审批或受控的终止流程。对于调用次数、错误率、P95 耗时和资源消耗，应该由应用埋点、Redis 慢日志或外部监控持续采集。

如果 Redis 运行在集群环境，还要确认诊断客户端连到正确的节点。FUNCTION STATS 观察的是执行该命令的 Redis 实例，不会替你汇总整个集群的函数运行状态。

常见误区与安全边界

• 把 duration_ms 当累计耗时：它描述当前运行实例的持续时间，函数结束后该在途记录就消失。
• 把 engines 当调用统计：它是引擎级信息，主要用于核对函数和库的存在，不提供每次调用的历史明细。
• 看到 nil 就判定没有问题：查询时刻没有在途函数，不代表此前没有短函数，也不代表延迟来源已经消失。
• 直接批量 FUNCTION KILL：先确认函数名、调用来源和业务幂等性，再处理；测试里的忙等函数不能照搬到生产。

相关问题

FUNCTION STATS 能看到某个函数调用了多少次吗？

不能。它关注当前运行中的函数以及执行引擎信息；调用次数和平均耗时需要应用埋点或独立监控记录。

没有函数运行时为什么还会返回 engines？

engines 是执行引擎的元信息，与当前是否存在在途函数无关；只有 running_script 会在没有运行对象时为空。

FUNCTION KILL 之后客户端一定拿到正常结果吗？

不一定。终止函数属于异常路径，调用方应按错误处理，并用幂等设计避免重复写入或重复扣减。

落地前的检查清单

把命令用于线上前，至少确认 Redis 版本支持 Functions、诊断账号具备所需权限、采样客户端连到了正确实例，并记录函数名与原始调用命令。若决定终止，留下审批依据和恢复结果；别用一次 FUNCTION STATS 查询替代长期指标。