1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | redis-observability | GitHub API / SKILL.md |
| 作者/维护者 | Redis, Inc.（官方 redis/agent-skills 仓库） |
GitHub API |
| 来源链接 | https://github.com/redis/agent-skills/tree/main/skills/redis-observability | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 所属仓库 90★ / 21 forks（该数字属整个 Redis Agent Skills 合集，不代表本技能个体热度，仅供了解所属仓库规模） | GitHub API |
| 最新版本 | SKILL.md 标注 version 0.1.0；子目录最近一次提交 2026-05-27 | 仓库提交历史 / SKILL.md |
| 安装方式 | npx skills add redis/agent-skills 或 Claude Code 插件市场一条命令安装（见第 9 章） |
仓库 README |
2. 功能介绍与亮点
redis-observability 是 Redis 官方 Agent Skills 合集中专攻可观测性的技能，把“该看哪些指标、什么时候告警、出问题时该跑哪条命令”整理成可直接照抄的对照表。
核心能力：
- 指标监控表：
used_memory、connected_clients、blocked_clients、instantaneous_ops_per_sec、keyspace_hits/keyspace_misses、rejected_connections、rdb_last_save_time七项核心指标，逐项给出含义与具体告警阈值（如内存使用超maxmemory80%、缓存命中率低于 80%） - 故障排查命令速查：
SLOWLOG GET/LEN/RESET（慢查询定位）、INFO all及分节视图、MEMORY DOCTOR/MEMORY STATS（内存诊断）、CLIENT LIST（连接排查）、FT.INFO/FT.PROFILE（搜索查询画像），并说明SLOWLOG GET与MEMORY DOCTOR是事故排查时最先该用的两条命令 - Redis Insight 使用场景：说明官方免费 GUI 工具适合交互式排查与开发阶段，不能替代接入 Prometheus/Datadog 等监控系统的常态化指标导出
- 配套
references/metrics.md与references/commands.md两篇参考文档，以及可直接复用为告警脚本雏形的 Python 代码片段（如计算缓存命中率）
亮点：内容不是泛泛的“监控你的 Redis”提醒，而是把每项指标绑定了具体的告警阈值和排查命令，做到读完即可照抄进监控配置；技能本身为纯 Markdown 指导，不含可执行脚本，安装单元干净。
3. 适用场景
固定分类：DevOps 与基础设施
- 首次为生产 Redis 实例搭建监控告警清单的工程师
- 排查 Redis 延迟飙升、内存压力、连接风暴等线上故障的 on-call 工程师
- 需要把 Redis 指标接入 Prometheus、Datadog、CloudWatch 等既有监控系统的 DevOps 团队
- 用
FT.PROFILE定位 Redis Search 慢查询的开发者（可与同合集内 redis-search 技能配合使用）
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库自带
.claude-plugin/marketplace.json，/plugin install redis-development@redis连带装入本技能 - Codex：官方明确支持——Redis 官方博客（redis.io/blog，2026-02-03 发布）原文列出“every AI coding agent you use (Claude Code, Cursor, Codex, Copilot, Augment Code, whatever)”，明确将 Codex 纳入支持范围；但仓库内未见针对 Codex 的专用清单目录，实际安装依赖通用 Agent Skills CLI（
npx skills add） - OpenClaw：未验证——官方材料未提及，技能遵循标准 SKILL.md 格式，理论上可通用安装，但未见官方或可靠第三方验证
- Hermes Agent：未验证——官方材料未提及
（仅基于已抓取材料判断，未为兼容性单独发起搜索）
5. 推荐理由
Redis 生产事故中，内存压力、连接风暴、慢查询这类问题往往要等到线上告警甚至用户投诉才被发现，而很多团队并未系统梳理过“该盯哪些指标、阈值定多少”。redis-observability 把这套运维知识收敛成一张可直接照抄的指标-阈值-排查命令对照表，配合可复用的 Python 代码片段，省去从 Redis 官方文档逐条摸索监控体系的过程，尤其适合刚开始为生产 Redis 实例补齐可观测性的初中级工程师。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Redis, Inc. 官方仓库出品，仓库共 10 位贡献者持续维护；本子目录自身提交虽只有 2 次（单一作者），但已被独立第三方技术文章（越南语开发者社区 viblo.asia，2026 年发布）专门点名介绍其 SLOWLOG/INFO/MEMORY DOCTOR 排查能力；作为合集中的专项运维能力，受众窄于覆盖全体 Redis 用户的旗舰技能 redis-core |
| 可用性 | 9 | npx skills add 或 Claude Code 插件市场一条命令安装；SKILL.md 正文精炼、两篇 references 文档覆盖指标与命令细节；最近一次提交 2026-05-27，在近 3 个月维护窗口内；纯文档指导，无需 API key 或付费依赖，Redis Insight 为官方免费工具 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
① 执行 shell 命令——纯文档指导型技能，无 scripts/ 目录，SKILL.md 内命令示例仅作讲解素材
② 联网外发数据——技能内容为本地建议，不涉及技能自身向外部服务器发送数据，接入 Prometheus/Datadog 等监控系统由用户自行配置
③ API key/凭据——不涉及凭据；认证相关内容属合集内另一子技能 redis-security，不在本次推荐范围
④ 未发现可疑指令——抓取 SKILL.md 全文与 references 目录内容，均为透明的 Redis 运维说明，未见 prompt injection 或混淆代码迹象
⑤ 作者信誉——Redis, Inc. 官方仓库，仓库共 10 位贡献者，多个账号资料可确认任职于 Redis
⑥ License——MIT，明确
⑦ 维护时间——子目录最近提交 2026-05-27，仓库整体最近推送 2026-07-09，持续维护中
综合评分：8.3（三项均值）
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 redis-observability 的差异 |
|---|---|---|
| qdrant-monitoring（qdrant/skills） | Qdrant 官方监控排障手册，聚焦向量数据库的 Prometheus 抓取端点、K8s 健康探针与优化器卡住等故障模式 | 同为“官方出品的单一数据存储运维手册”，但面向向量数据库场景；redis-observability 面向承担缓存/会话/搜索等多重职责的 Redis 实例，指标体系（内存、连接、命中率）更贴近通用缓存与存储场景 |
| dd-apm-datadog-labs-agent-skills（datadog-labs/agent-skills） | Datadog 官方 APM 技能，聚焦分布式追踪、服务地图与跨服务性能分析 | 面向需要接入 Datadog 账号的通用可观测性平台，覆盖任意技术栈的服务间调用链；redis-observability 聚焦单一 Redis 实例自身指标与内置排查命令，无需额外部署或订阅第三方监控平台即可上手 |
| Redis Insight（Redis 官方 GUI 工具） | 交互式可视化监控与查询工具，同一技能内容中被引用为辅助手段 | 是图形界面工具，需要单独安装打开，适合人工交互排查；redis-observability 是喂给编码 agent 的文本知识，让 agent 在对话中直接给出该查哪个指标、跑哪条命令的结论，两者互补而非替代 |
redis-observability 的差异化在于“零额外基础设施”：不需要部署专用监控平台或订阅第三方 SaaS，仅用 Redis 自带的 INFO/SLOWLOG/MEMORY DOCTOR 等命令即可完成日常监控与故障定位，适合技术栈尚未接入重型可观测性平台、希望先把 Redis 自身运维基本盘打牢的团队。
8. 用户评价
越南语开发者社区平台 viblo.asia 上一篇署名 Chính Nguyễn Quốc 的技术文章专门介绍了 redis/agent-skills 合集，其中点名提到 redis-observability 支持“监控与分析 Redis”，并具体列出其覆盖 INFO 关键指标、SLOWLOG 分析、MEMORY DOCTOR 与查询画像等能力。作者对该技能持肯定但审慎的态度，原文大意为：技能的实际价值在于“在 AI 处理 Redis 相关任务的关键时刻提供知识、生产实践与护栏”，但同时提醒“最终决策仍需依赖真实系统数据”，技能本身不能替代基准测试与真实负载分析。除此之外，该技能目前在 Reddit、Hacker News 等平台尚无具名用户评价。
9. 安装使用方式
- Agent Skills CLI：
npx skills add redis/agent-skills（安装整个合集，含 redis-observability） - Claude Code 插件市场：
/plugin marketplace add redis/agent-skills，再执行/plugin install redis-development@redis - Cursor：在对话中使用
/add-plugin redis - 手动安装：将
skills/redis-observability目录复制到对应 agent 的技能目录
安装后注意事项：redis-observability 属于 redis-development 插件包的一部分，按插件方式安装会连带装入其余 7 个 Redis 子技能（redis-core、redis-connections、redis-search、redis-clustering、redis-security、redis-semantic-cache、iris-development）；若只需要可观测性能力，可只手动复制 redis-observability 子目录（其内容不依赖其他子技能）。安装后无需重启，agent 会在涉及 Redis 监控、告警搭建或故障排查的对话中自动触发。
10. 注意事项
- 技能内容不涉及 Redis Cluster 特有的跨节点监控（如各分片间的指标聚合），该部分需配合同合集内 redis-clustering 技能
- Codex 支持基于官方博客的文字声明，未见专用清单目录佐证，建议使用前自行验证实际安装效果
- OpenClaw、Hermes Agent 的兼容性目前均无官方或可靠第三方材料佐证，两个生态的用户使用前建议先自行验证基本安装流程
- 该技能子目录自身提交历史较短（仅 2 次提交、单一作者），长期独立维护节奏有待观察