本文へ移動
Claude Code に本番アプリの変更を依頼するチーム向け

Claude Code 可観測性

Claude Code に、テレメトリを別個のクリーンアップ プロジェクトではなく実装パスの一部にするプロンプトを表示します。

レビュー者 Telemetry 製品チーム に . イベント項目、推奨クエリ、除外するデータを確認しました. このページのレビュー担当

レビュー済みの同じ手順をリポジトリ全体で再利用します。 エージェント テレメトリ skill.md ガイド.

なぜこれが機能するのか
  • コード変更と同じコンテキストから生成される構造化ログ。
  • 保存するダッシュボードを追加する前に、確認済みイベントと SQL を確認してください。
  • 編集優先のガイダンスにより、プロンプト、シークレット、生のペイロードがイベント データに含まれないようにします。
ユースケースの証拠パス

Claude Code observability: 実装から決定まで

完全な claude code observability 測定ループは、1 つの所有ワークフロー、制限されたイベント コントラクト、制御されたフィクスチャ、および誰かが行動できる質問を接続します。

  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例

このワークフローの構造化フィールドに対してクエリを実行し、結果の例を検査して、有用な回答をダッシュボードまたはアラートに変換します。

すべてのレシピを参照する

次のステップ

実際のアプリイベントを一つ確認

登録なしで実際のイベントを一つ送信してクエリします。ワークスペースを引き継ぐとダッシュボードを保存できます。

関連ページ