前言¶

功能上线之后，最常见的排查姿势是翻日志、猜复现、加临时打印。问题是日志常常没有上下文，指标缺口径，告警只在故障已经发生之后才响，排查停留在「谁先出错」的层面。

下面介绍一个面向这类问题的 Skill：可观测性与埋点。它把日志、指标、追踪、告警四类能力组织成一套可落地的方案，目标是让线上行为可见、可诊断。

这是什么¶

可观测性与埋点（observability-and-instrumentation）是一个给生产功能加日志、指标、追踪、告警的 Skill，坐标 @kunlungrowth/observability-and-instrumentation，由「昆仑增长」发布维护，版本 1.0.0，来源 enterprise，分类 it-ops-security。

它解决的问题是：功能已经上线，但线上到底发生了什么、哪一步变慢、哪个调用出错、用户看到的报错来自哪条链路，这些信息如果不提前埋好，事后只能靠猜。

SkillHub 上的公开数据：评分 100000，下载 963，安装 0，标签 requires_api_key=false（不需要额外 API Key）。

核心功能¶

资料中给出的能力包括四块，按此介绍：

1. 日志：结构化日志，便于按字段检索，而不是在非结构化文本里做字符串匹配。
2. 指标：覆盖 RED/USE 两组口径。RED 面向服务侧（Rate、Errors、Duration），USE 面向资源侧（Utilization、Saturation、Errors）。
3. 追踪：关联 ID，让一次请求在跨服务、跨日志行之间能串起来。
4. 告警：症状告警，即针对用户能感知到的异常现象（如错误率升高、延迟抬升）触发，而不是等到底层资源指标异常才报。

安装与启用¶

当前公开资料中没有给出命令行安装命令、目录路径或配置文件字段，只有 SkillHub 页面和坐标信息。可用的信息如下：

SkillHub 页面: https://www.skillhub.cn/skills/kunlungrowth/observability-and-instrumentation
SkillHub API: https://api.skillhub.cn/kunlungrowth/observability-and-instrumentation
坐标: @kunlungrowth/observability-and-instrumentation
来源: enterprise
分类: it-ops-security
requires_api_key: false

需要说明的是，资料中没有列出 Cursor、Codex CLI、Claude Code 各自的启用方式差异，也没有安装命令，这里不做推测。如果需要确认命令行安装方式，建议直接打开上面的 SkillHub 页面查看，或在本地 Skill 管理器中按坐标搜索 kunlungrowth/observability-and-instrumentation。

另外，requires_api_key=false 表示该 Skill 不依赖额外的 API Key，启用前不需要准备密钥。

典型用法¶

官方资料给出的简介是：「给生产功能加日志/指标/追踪/告警，让线上行为可见可诊断；含 RED/USE、结构化日志、关联 ID、症状告警。」

围绕这句话，可以按下面的顺序在生产功能上落地：

1. 先定义需要被观测的对象：一次用户请求经过哪些服务、依赖哪些资源。这一步决定后面埋什么。
2. 加结构化日志：每个日志行带固定字段（时间、服务名、关联 ID、请求路径、状态码、耗时等），避免写自由文本。
3. 加关联 ID：请求进入系统时生成或透传一个 ID，跨服务传递，所有日志和追踪都带上它。
4. 加指标：服务侧按 RED 记录请求速率、错误数、耗时；资源侧按 USE 记录利用率、饱和度、错误数。
5. 配症状告警：以错误率、延迟等用户可感知的症状为触发条件，而不是只盯 CPU 或内存。

这五步的顺序来自简介中的能力列举，具体字段名和接口在公开资料中没有给出，这里不补全。

适用场景与注意¶

适合的场景：

• 已经上线、但线上行为不透明的功能，需要补齐日志、指标、追踪、告警。
• 排查问题时需要把一次请求跨服务串起来的场景。
• 希望告警对应用户可感知症状，而不是底层资源指标的场景。

需要注意的：

• 该 Skill 是能力清单与方法组织，不是现成的监控平台。指标采集、日志存储、告警通道仍需接入现有基础设施。
• 公开资料中没有安装命令、配置字段和平台差异说明，启用方式需要到官方页面确认后再写。
• 版本号 1.0.0，来源 enterprise，说明这是企业来源的初版发布，能力边界以官方页面为准。
• 安装数为 0（评分与下载数见上），使用前建议先在一个非关键链路上试一遍。

结尾¶

这个 Skill 的价值在于把「加日志、看指标、串追踪、配告警」这四件事组织成一套可执行的方案，并明确区分了 RED/USE 的指标口径和症状告警的触发思路。对已经上线、但线上行为不透明的功能，它可以作为补全可观测性的一条路径。

官方地址：https://www.skillhub.cn/skills/kunlungrowth/observability-and-instrumentation