Claude Code observability: 実装から決定まで
完全な claude code observability 測定ループは、1 つの所有ワークフロー、制限されたイベント コントラクト、制御されたフィクスチャ、および誰かが行動できる質問を接続します。
- 1
境界を設定する
完了したアプリの操作を一つ選び、Claude Code にイベント記録を追加させます。
- 2
結果を把握する
選んだアプリ操作に必要な項目だけを記録し、非公開の内容や認証情報は除いてください。
- 3
行を証明する
その操作を実行し、保存されたイベントを SQL で確認します。サンプルイベントだけでは接続完了になりません。
- 4
決断を下す
計測範囲を広げる前に、観測したイベントと未確認の範囲を確認してください。
エージェントプロンプト
これをコーディングエージェントに貼り付けます
YOUR_API_KEY を既存のサーバー側キーに置き換えるか、登録なしで最初のイベントを試してください。ダッシュボードの保存にはワークスペースの引き継ぎが必要です。
Claude Code observability セットアップ プロンプト
/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登録せずに始めるか、既存のサーバー側 API キーを使います。
- 2完了したアプリの操作を一つ選び、Claude Code にイベント記録を追加させます。
- 3その操作を実行し、保存されたイベントを SQL で確認します。サンプルイベントだけでは接続完了になりません。
- 4ワークスペースを引き継いでダッシュボードを保存し、公開前に結果を確認します。
キャプチャするイベント
これにより解き明かされる質問
- エージェントが作成した機能のうち、リリース後に実際に使用されるのはどれですか?
- Claude Code の変更により、サポートまたは信頼性のリスクが生じているのはどこですか?
- さらに自動化を追加する前に、どのワークフローがアラートを受け取る必要がありますか?
イベントスキーマの例
このワークフローのイベントスキーマ
クエリまたはスニペットを運用環境に適用する前に、行粒度、出力境界、必要なタイプ、プライバシー クラス、サンプル ペイロード、および検証チェックリストを確認してください。
関連製品の機能
このワークフローを続行します ダッシュボード
検証された製品または収益のクエリを、焦点を絞った意思決定の表面に変えます。
関連する SQL レシピ
その他のSQL例
このワークフローの構造化フィールドに対してクエリを実行し、結果の例を検査して、有用な回答をダッシュボードまたはアラートに変換します。
次のステップ
実際のアプリイベントを一つ確認
登録なしで実際のイベントを一つ送信してクエリします。ワークスペースを引き継ぐとダッシュボードを保存できます。
関連ページ