Agent Skills
返回列表
🔒

监控与可观测性

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/monitoring-observability-sh-bf92bu。

技能介绍

解决什么问题

当服务规模从单机扩展到多节点、多语言之后,排查故障往往要在日志、指标、链路三类数据之间来回切换:报警说 CPU 高,但不知道是哪个请求慢;日志里有异常堆栈,却无法定位是哪条链路触发的;仪表盘堆了几十个面板,却没有人说得清每个数字对应的 SLO。根因定位变成一场跨系统拼图游戏。

核心能力

这个技能围绕可观测性三大支柱给出可执行的实践清单:

  • 链路追踪:基于 OpenTelemetry 初始化 SDK,自动为 HTTP、数据库、消息队列注入 instrumentation,并为关键业务操作补充自定义 span
  • 指标采集:使用 Prometheus 暴露指标,标签设计遵循有界基数原则,避免把 user ID 这类高基数字段直接作为 label
  • 结构化日志:输出 JSON 格式日志,支持敏感信息脱敏,替代字符串拼接的日志写法,并通过共享 trace ID 与链路数据关联
  • 告警与仪表盘:在定义 SLO 之后再搭建告警规则和仪表盘,按服务展示 RED 指标(Rate、Errors、Duration),告警基于错误率与延迟分位数而非 CPU 这类症状

适用边界

技能内的检查清单(Checklist)适合作为接入后的验收标准,但它默认你已经选择了 OpenTelemetry + Prometheus 这一套技术栈。如果你使用 Jaeger 或 StatsD 等替代方案,清单中的具体配置需要相应替换。此外,告警规则和 SLO 的制定与业务目标紧密相关,技能提供的是原则而非现成的阈值数值。

使用场景

  • 微服务上线初期,后端团队需要为 HTTP、数据库和消息队列接入 OpenTelemetry 自动埋点,快速建立链路追踪能力
  • 在给 Prometheus 指标设计 label 时,需要评估哪些字段属于高基数,避免将 user ID 直接作为标签导致指标膨胀
  • 排查跨服务故障时,需要确认日志输出为 JSON 格式并携带 trace ID,以便在日志系统与链路追踪平台之间关联上下文
  • 制定告警规则前,需要先定义服务的错误率与延迟分位数 SLO,避免针对 CPU 高负载这类症状直接触发告警

适合人员

  • 需要为新服务搭建可观测性体系的后端开发者,希望快速掌握 OpenTelemetry 自动埋点与自定义 span 的接入步骤
  • 负责 Prometheus 指标治理的 SRE 工程师,需要在指标爆炸前识别高基数 label 并优化标签设计
  • 处理跨系统故障的运维人员,需要在日志平台和链路追踪工具之间通过共享 trace ID 快速定位根因
  • 制定 SLO 与告警策略的技术负责人,希望参考结构化日志和 RED 指标的最佳实践来设计可观测性方案