跳至主要內容
對於要求 Claude Code 修改生產應用程式的團隊

Claude Code 可觀測性

給 Claude Code 一個提示,使遙測成為實施過程的一部分,而不是單獨的清理專案。

審閱者 Telemetry產品團隊 上 . 我們檢查了事件欄位、建議查詢和要排除的資料. 誰負責審查此頁面

在儲存庫中重複使用相同的經過審查的指令 代理遙測skill.md 指南.

為什麼這有效
  • 從與程式碼更改相同的上下文生成的結構化日誌。
  • 新增儲存的儀表板前,核對已驗證事件和 SQL。
  • 編輯優先的指導,使提示、秘密和原始有效負載遠離事件資料。
用例證據路徑

Claude Code observability:從實施到決策

完整的 claude code observability 測量迴圈連線一個擁有的工作流程、一個有界事件契約、一個受控裝置和一個有人可以採取行動的問題。

  1. 1

    設定邊界

    選擇一個已完成的應用程式操作,讓 Claude Code 加上事件記錄。

  2. 2

    捕捉結果

    僅選擇所選應用程式操作需要的欄位;不要記錄私密內容或憑證。

  3. 3

    證明行數

    執行該操作並用 SQL 核對儲存的事件。範例事件不代表完成接入。

  4. 4

    做出決定

    擴大事件記錄範圍前,檢查已觀察事件和未涵蓋部分。

代理提示

將其貼上到您的編碼代理中

將 YOUR_API_KEY 替換為現有的伺服器端金鑰,或無需註冊嘗試首個事件。儲存儀表板需要認領工作區。

代理提示

Claude Code observability 設定提示

text
使用 /skill.md,透過一個真實應用程式事件驗證已驗證身分的 Telemetry 接入。

僅在伺服器端程式碼中使用此 Telemetry API 金鑰:YOUR_API_KEY

匿名金鑰支援無需註冊的事件寫入和同步 SQL。建立儀表板或警示前,請使用相同金鑰在 https://telemetry.sh/register 認領現有工作區。尚未認領時,查詢該事件以核對投遞,並說明哪些功能需要註冊。

請:
1. 選擇一個已完成的應用程式操作,並在可用時記錄 event_name、service、route、status、duration_ms 和 release。
2. 不要記錄憑證、原始請求內容或客戶內容。
3. 執行該真實操作一次,並核對事件是否出現在預期工作區。此階段不要使用 telemetry_quickstart。
4. 檢查投遞回應,並查詢該事件,確認金鑰、工作區和資料表一致。若投遞失敗,回報回應狀態碼,不要暴露金鑰。
5. 說明核對了哪個真實事件、結果代表什麼,以及下次應用程式執行後如何再次查詢。

從一個真實應用程式操作開始,並核對儲存的事件。範例事件僅用於診斷。

用你的程式碼代理試用

設定步驟

  1. 1無需註冊即可開始,也可使用現有的伺服器端 API 金鑰。
  2. 2選擇一個已完成的應用程式操作,讓 Claude Code 加上事件記錄。
  3. 3執行該操作並用 SQL 核對儲存的事件。範例事件不代表完成接入。
  4. 4認領工作區以儲存儀表板,並在發布前核對結果。

要捕獲的事件

agent_task_startedagent_task_completedfeature_usedapi_request_completedcheckout_completedbackground_job_failed

由此解鎖的問題

  • 哪些代理編寫的功能在發布後實際使用?
  • Claude Code 變更在哪裡造成支援或可靠性風險?
  • 在新增更多自動化之前,哪些工作流程應該收到警示?

事件結構描述範例

在將查詢或程式碼片段適應生產之前,請檢查行粒度、發出邊界、所需型別、隱私類、範例有效負載和驗證清單。

相關產品功能

繼續此工作流程 儀表板

將經過驗證的產品或收入查詢轉變為集中的決策介面。

相關 SQL 查詢範例

更多 SQL 範例

針對此工作流程中的結構化欄位執行查詢,檢查範例結果,並將有用的答案轉換為儀表板或警示。

瀏覽所有查詢範例

下一步

核對一個真實應用程式事件

無需註冊即可傳送和查詢一個真實事件。認領工作區後可儲存儀表板。

相關頁面