前言¶

功能上線之後，最常見的排查姿勢是翻日誌、猜復現、加臨時打印。問題是日誌常常沒有上下文，指標缺口徑，告警只在故障已經發生之後才響，排查停留在「誰先出錯」的層面。

下面介紹一個面向這類問題的 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