本文へ移動
Telemetry
インストルメンテーション テンプレートをコピー&ペースト

イベント追跡計画テンプレート

粒度、所有権、フィールド、プライバシー、保持、検証、およびダウンストリームの SQL 依存関係をカバーするレビュー可能なイベント カタログを作成します。

レビュー者 Telemetry 製品チーム . イベント名、推奨フィールド、分析の質問、プライバシー境界. 基準と所有権を確認する

これにより解き明かされる質問
  • 1 つの行は何を表しており、どのような決定をサポートしているのでしょうか?
  • どのフィールドが必須、機密、制限付き、または禁止されていますか?
  • どのクエリ、ダッシュボード、アラート、所有者がこの契約に依存しますか?
テンプレートの証拠パス

Event Tracking Plan Template: 実装から決定まで

プロンプトを実装の概要として扱います。有用な成果物は、コピーされたコードだけではなく、信頼できる答えを生成するレビューされたイベント コントラクトです。

  1. 1

    境界を選択してください

    Instrument the point where tracking_plan_reviewed becomes final.

  2. 2

    契約書を作成する

    Start with tracking_plan_reviewed, event_contract_changed, instrumentation_verified and keep every field typed, bounded, and privacy-reviewed.

  3. 3

    フィクスチャを実行する

    集計結果に依存する前に、既知の成功、失敗、再試行、および空の結果のケースを実行してください。

  4. 4

    質問に答えてください

    1 つの行は何を表しており、どのような決定をサポートしているのでしょうか?

テンプレート

これをコーディングエージェントに貼り付けます

交換する YOUR_API_KEY、フローをローカルで実行し、生成されたイベントとダッシュボードを確認します。

event-tracking-plan

イベント追跡計画テンプレート

text
Telemetry を追加する前に、このコードベースのイベント追跡計画を作成してください。

/skill.md を使用して、運用ワークフロー、既存の分析呼び出し、テスト、展開構成、プライバシー制御、およびダウンストリーム レポートを検査します。

提案されたイベントごとに、次のことを文書化します。
event_name、イベント粒度、ビジネスまたは運用上の決定、所有者、正確なトリガー、必須フィールド、オプションのフィールド、タイプと単位、制御された値、禁止されたコンテンツ、プライバシー分類、保持期待、schema_version、ダウンストリーム SQL またはダッシュボード、および合成検証ケース。

あいまいな再試行、重複した配信、生の URL、無制限の文字列、個人データ、機密情報、真実の情報源が不明瞭なフィールドを特定します。これらの境界が解決されるまで、インストルメンテーションを追加しないでください。

次に、承認された最小のイベント セットを実装し、コントラクト テストと障害パス テストを追加し、非運用環境での取り込みを検証し、レート以外のカウントを維持する SQL を作成します。

追跡計画をコミットされた Markdown ドキュメントとして返し、まだ必要なレビューの決定を要約します。同意、保持、セキュリティ、またはコンプライアンスのポリシーを考え出さないでください。

キャプチャするイベント

tracking_plan_reviewedevent_contract_changedinstrumentation_verifiedschema_drift_detectedevent_contract_retired

検証チェックリスト

完全なインストルメンテーション パスが後に残すもの

イベント

合成イベントは、安定した名前とフィールド タイプで目的のテーブルに到達します。

クエリ

最初の SQL クエリは、明示的な時間枠を使用して妥当な行を返します。

ビュー

ダッシュボードでは実際のフィールドが使用され、変更を説明するのに十分なコンテキストが含まれています。

安全性

プロンプト、本文、資格情報、署名、およびプライベート コンテンツの編集がチェックされました。

イベントスキーマの開始点

クエリまたはスニペットを運用環境に適用する前に、行粒度、出力境界、必要なタイプ、プライバシー クラス、サンプル ペイロード、および検証チェックリストを確認してください。

関連製品の機能

このワークフローを続行します 構造化イベント

安定したイベント名、型指定されたフィールド、プライバシーが確認された操作コンテキストをキャプチャします。

関連する SQL レシピ

SQL で次の質問に答えてください

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

すべてのレシピを参照する
完全なコレクションデータ品質 SQL

その他のテンプレート