跳转到内容
对于要求 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 示例

针对此工作流程中的结构化字段运行查询,检查示例结果,并将有用的答案转换为仪表板或警报。

浏览所有查询示例

下一步

核对一个真实应用事件

无需注册即可发送和查询一个真实事件。认领工作区后可保存仪表板。

相关页面