本文へ移動
Telemetry
構造化イベント契約カタログ

結果を中心に構築されたイベント スキーマの例

結果を所有するサービスを選択し、適切な粒度で 1 つの永続的なイベントを発行し、機密ペイロードを分析にコピーすることなく識別子を有用な状態に保ちます。

レビュー者 Telemetry 製品チーム . イベント粒度、所有権、必須フィールド、プライバシー分類、ペイロード例、および関連する SQL. 基準と所有権を確認する

20

契約を完了する

192

文書化されたフィールド

電子メール、プロンプト、ペイロード、トークン、リンク先 URL はありません

サンプル識別子は合成されたものであり、プライバシー分類は独自のレビューの出発点となります。

結果で発行する

サービスが最終ステータス、期間、ビジネス ID を認識している場合にのみイベントを記録します。

穀物に名前を付けます

リクエスト、ジョブ、支払い試行、または永続的なマイルストーンごとに 1 行にすることで、偶発的な二重カウントを防ぎます。

バインドされたカーディナリティとプライバシー

ルート テンプレートと安定した ID を優先します。生の URL、電子メール、プロンプト、ペイロード、認証情報、スタック トレースを除外します。

契約を完了する

サービスが所有する結果を選択してください

製品ライフサイクルuser_signed_up

どのサインアップ コホートがアクティブ化され、維持されますか?

取得と計画のコンテキストを備えた永続的なアカウント入力イベント。 ID は匿名のままにし、プライバシーの審査後にのみマーケティング帰属を取得します。

穀物
ユーザーおよびアカウントごとに 1 つのサインアップが受け入れられます。
フィールド
7 文書化された
フィールドと例 JSON を確認してください。
製品分析product_milestone_completed

どのアカウントがアクティベーションを定義する永続的な瞬間に達しますか?

ソースの接続、最初のクエリの実行、ダッシュボードの公開など、安定した製品の成果を実現するための汎用マイルストーン エンベロープ。

穀物
アクター、アカウント、発生ごとに 1 つの完了したマイルストーン。
フィールド
8 文書化された
フィールドと例 JSON を確認してください。
API の信頼性api_request_completed

エラーや遅いリクエストは顧客にどのような影響を与えますか?

生の URL の代わりにルート テンプレートを使用した端末リクエスト イベント、制限されたエラー カテゴリ、およびサービス境界で測定された遅延。

穀物
1 つの完了した API リクエスト。
フィールド
10 文書化された
フィールドと例 JSON を確認してください。
AIの運用llm_request_completed

成功する AI ワークフローごとにどれくらいのコストがかかり、そのパフォーマンスはどの程度でしょうか?

プロンプトや生成されたコンテンツを含まない、モデル、トークン、レイテンシ、割り当てコスト、およびツールの結果を含む端末モデル呼び出しイベント。

穀物
1 つの完了したモデルプロバイダーリクエスト。
フィールド
10 文書化された
フィールドと例 JSON を確認してください。
非同期の信頼性background_job_completed

どのジョブが失敗、再試行、待機、または実行速度が遅いですか?

最終結果と試行回数を 1 回記録するターミナル ジョブ イベント。再試行ごとに 1 行による過剰カウントを回避します。

穀物
論理ジョブごとに 1 つの最終結果。
フィールド
11 文書化された
フィールドと例 JSON を確認してください。
収益業務invoice_payment_completed

どの請求額が成功、失敗、または回復しますか?

プロバイダー ID を匿名化し、請求金額を経常収益の定義から分離する支払い結果イベント。

穀物
端末支払いの試行は 1 回。
フィールド
9 文書化された
フィールドと例 JSON を確認してください。
統合の信頼性webhook_delivery_completed

どの宛先が永続的に失敗し、どのステータス コードが再発し、どの配信が再試行後に回復しますか?

attempt_count、最終 status_code、response_body_bytes、および制限付きコンテンツ タイプを含む端末配信ログ イベント。ただし、顧客 URL、リクエスト ヘッダー、承認、生の応答本文、またはペイロードは含まれません。

穀物
論理 Webhook 配信ごとに 1 つのターミナル結果。
フィールド
11 文書化された
フィールドと例 JSON を確認してください。
インシデント対応incident_impact_observed

インシデント中にどのアカウントとワークフローが影響を受けましたか?

リクエストのペイロードをインシデント レコードにコピーすることなく、宣言されたインシデントを顧客のワークフローに接続する、制限付きの影響観察。

穀物
宣言されたインシデントに関連する影響を受けた操作 1 件。
フィールド
9 文書化された
フィールドと例 JSON を確認してください。
アイデンティティのセキュリティauthentication_attempt_completed

どの認証方法、クライアント、およびリスク カテゴリが失敗または不審なバーストを引き起こしていますか?

制限されたメソッド、結果、およびリスク フィールドを含むターミナル サインイン結果。資格情報、トークン、生の IP アドレス、および自由形式のプロバイダー エラーを意図的に除外します。

穀物
認証試行が 1 回完了しました。
フィールド
8 文書化された
フィールドと例 JSON を確認してください。
フロントエンドの信頼性browser_performance_observed

ユーザーが目に見えるパフォーマンスを低下させているのはどのルート、リリース、デバイス クラスですか?

名前付きメトリック、数値、ルート テンプレート、リリース コンテキストを含むサンプリングされたブラウザー測定。未加工の URL、ユーザー エージェント、DOM コンテンツはイベントの外部に残ります。

穀物
1 つのサンプリングされたブラウザー メトリック観測。
フィールド
8 文書化された
フィールドと例 JSON を確認してください。
データベースの信頼性database_operation_completed

どの操作のフィンガープリント、リリース、データベース ロールが遅いか失敗していますか?

レビューされたフィンガープリントと大まかな操作メタデータによって表される、完了したデータベース操作。 SQL テキスト、バインドされた値、資格情報、および顧客レコードは除外されます。

穀物
アプリケーション所有のデータベース操作が 1 つ完了しました。
フィールド
9 文書化された
フィールドと例 JSON を確認してください。
Kubernetes の信頼性kubernetes_workload_observed

どのワークロード、クラスター、リリースが再起動されているか、使用不能になっているか、またはリソースが制限されていますか?

正規化された Kubernetes 座標と集約状態を含む定期的なワークロード スナップショット。ポッドのログ、環境変数、シークレット名、およびアノテーションは除外されます。

穀物
クラスター、名前空間、間隔ごとに 1 つのワークロード スナップショット。
フィールド
8 文書化された
フィールドと例 JSON を確認してください。
AIエージェントの運用ai_agent_run_completed

どのエージェントのバージョンが意図したタスクを完了しますか、ハンドオフが必要ですか、ループしますか、または失敗しますか?

バージョン管理されたワークフロー、ツールの概要、コスト、およびレビューされたタスクの結果を含む、ターミナル エージェントの実行結果。プロンプト、補完、ツール引数、および取得されたコンテンツは除外されます。

穀物
論理エージェントの実行ごとに 1 つの最終結果。
フィールド
10 文書化された
フィールドと例 JSON を確認してください。
AIエージェントのセキュリティagent_tool_authorization_decided

どのエージェント ツール アクションが許可され、拒否され、人間の承認にルーティングされますか?

結果としてエージェント ツールが呼び出される前に記録されるポリシー決定。プロンプト、引数、結果、資格情報、および顧客コンテンツを除外しながら、限定されたツール、リスク、意思決定、およびポリシーのフィールドをキャプチャします。

穀物
論理的なツール呼び出しの試行ごとに 1 つの最終認可決定。
フィールド
12 文書化された
フィールドと例 JSON を確認してください。
機能の提供feature_rollout_evaluated

導入コホートは、導入、信頼性、顧客の成果においてどのように異なりますか?

ターゲティング式や個人属性をコピーせずに公開ルールをクエリできるようにする、バージョン管理された機能割り当てレコード。

穀物
アクター、フィーチャ、割り当てバージョン、およびマテリアルの変更ごとに 1 つの効果的なフィーチャ評価。
フィールド
9 文書化された
フィールドと例 JSON を確認してください。
AIの運用agent_tool_call_completed

エージェントが有益な結果に達する前に、どのツールが失敗、再試行、ループ、または待ち時間の追加を引き起こしますか?

エージェントの信頼性分析のための境界付き端末ツール呼び出しイベント。引数と結果を専門家トレース システムに保持し、承認されたカテゴリと相関識別子のみを保持します。

穀物
エージェントの実行内で 1 回の完了したツール呼び出し試行。
フィールド
11 文書化された
フィールドと例 JSON を確認してください。
AIの品質rag_retrieval_evaluated

関連するコンテキストと根拠のある受け入れられた回答を生成する検索バージョンとプロンプト バージョンはどれですか?

ソース テキスト、プロンプト、生成された回答を保存せずに、取得スコア、回答レビュー、レイテンシ、コストを分離する、バージョン管理された RAG 評価イベント。

穀物
適格なクエリ、取得バージョン、評価者、および候補実行ごとに 1 つの評価結果。
フィールド
11 文書化された
フィールドと例 JSON を確認してください。
収益ライフサイクルsubscription_changed

新規、拡大、縮小、解約、または再活性化された経常収益はどれくらいですか?

コミットされた請求状態から発行される収益移動イベント。請求書の本文や支払いプロバイダーのペイロードではなく、正規化された計画と移動の値を保存します。

穀物
アカウント、サブスクリプション、および実質的な変更ごとに 1 つのコミットされた経常収益の移動。
フィールド
10 文書化された
フィールドと例 JSON を確認してください。
使用量の請求usage_meter_recorded

どのアカウントがクォータに近づいていますか? 従量制使用量を請求元帳と照合できますか?

数量、単位、メーターのバージョン、請求期間を含む冪等の使用量メーター レコード。生のソース ペイロードと顧客コンテンツを分析イベントの外に保管します。

穀物
冪等性キーおよびメーターごとに 1 つの許容使用量増分。
フィールド
10 文書化された
フィールドと例 JSON を確認してください。
データ品質telemetry_delivery_observed

アプリケーション イベントは完全かつ迅速に、再試行増幅なしで到着しますか?

アプリケーションが所有するテレメトリ配信試行の観察。配信ごとに再帰的なイベントが作成されるのを避けるために、別のシンクまたは制限されたサンプルを使用します。

穀物
配信試行または配信ウィンドウごとに 1 つのサンプリングまたは集約された観測。
フィールド
11 文書化された
フィールドと例 JSON を確認してください。

プライバシー ラベルをレビュー キューとして扱う

「仮名」識別子は、個人に関連する場合には依然として個人データである可能性があります。 「レビュー」フィールドは、取得またはプロバイダーのコンテキストを公開する可能性があります。実稼働インスツルメンテーションの前に、独自の保持、アクセス、同意、削除、常駐、および契約上の要件を適用します。