本文へ移動
Telemetry
ダッシュボードやアラートに依存する前にイベント コントラクトを検証するデータ チームとプラットフォーム チーム向け

Telemetry SQL によるデータ品質監視

イベントの鮮度、必須フィールド、タイプ、重複、スキーマのバージョン、ボリュームを監視して、誤解を招くビジネスや信頼性の指標になる前に壊れたインスツルメンテーションを発見します。

レビュー者 Telemetry 製品チーム . イベントの契約、推奨される分析、およびプライバシーの境界. 基準と所有権を確認する

なぜこれが機能するのか
  • 取り込みの成功を正しいものとして扱うのではなく、既知のフィクスチャを使用してイベント グレインと必須フィールドをテストします。
  • 鮮度、到着の遅れ、識別子の重複、スキーマ バージョンの採用、および予期しないボリュームの変更を個別に追跡します。
  • 所有者と契約バージョンを重要なイベント テーブルにアタッチすることで、障害が発生した場合に明示的な修復パスが得られます。
ユースケースの証拠パス

Telemetry Data Quality Monitoring with SQL: 実装から決定まで

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

  1. 1

    境界を設定する

    顧客対応、収益、信頼性、またはコンプライアンスの意思決定を強化するイベント テーブルの一覧を作成します。

  2. 2

    結果を把握する

    Begin with event_contract_checked, ingestion_freshness_sampled, duplicate_event_observed and document the grain of each event.

  3. 3

    行を証明する

    所有者がしきい値、除外、および予想される回復動作を確認した後にのみ、品質のクエリとアラートを公開します。

  4. 4

    決断を下す

    どの重要なイベント ストリームが古い、不完全、重複している、またはタイプが変更されていますか?

範囲と隣接するユースケース

適切な測定境界についてはこのページを選択してください

  • このページを使用して、テレメトリ自体 (鮮度、必須フィールド、タイプ、重複、バージョン、ボリューム) を検証します。
  • ソース イベントが信頼でき、アプリケーション ワークフローが失敗している可能性がある場合は、運用監視ページを使用します。
  • 簡潔な実装概要を作成するには、イベント追跡計画テンプレートを使用します。このガイドでは、進行中の品質管理プログラムについて説明します。

エージェントプロンプト

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

交換する YOUR_API_KEY サインアップ後、エージェントに製品フローを実行して最初のイベントを確認するように依頼します。

エージェントプロンプト

Telemetry Data Quality Monitoring with SQL セットアップ プロンプト

text
Telemetry を使用してテレメトリ データ品質モニタリングを追加します。

/skill.md とこの Telemetry API キーを使用します: YOUR_API_KEY

すべての意思決定が重要なイベント テーブルについて、イベントの粒度、所有者、必須フィールド、フィールド タイプ、タイムスタンプ単位、許容値、schema_version、重複キー、予想される到着遅延、および予想される日次ボリューム範囲を文書化します。

有効なイベント、必須フィールドの欠落、重複したイベント ID、遅延到着、および互換性のないフィールド タイプに対して決定的なフィクスチャを作成します。取り込みの鮮度、必須フィールドの NULL 率、重複イベント率、スキーマ バージョンの採用、遅延到着率、およびイベント名とリリースごとのボリューム変更のために SQL をビルドします。

最小限のサンプル サイズと所有者を持つ持続的な侵害に対してのみアラートを追加します。各アラートから契約および検証クエリへのリンクを含めます。

本番ペイロード、資格情報、個人データ、または無制限のエラー テキストを品質テスト イベントに配置しないでください。

セットアップ手順

  1. 1顧客対応、収益、信頼性、またはコンプライアンスの意思決定を強化するイベント テーブルの一覧を作成します。
  2. 2各契約の粒度、必須フィールド、タイプ、単位、許可される値、遅延、および重複ポリシーを定義します。
  3. 3有効なイベント、欠落しているイベント、重複したイベント、遅延したイベント、および互換性のないイベントに対して、確定的なフィクスチャを送信します。
  4. 4所有者がしきい値、除外、および予想される回復動作を確認した後にのみ、品質のクエリとアラートを公開します。

キャプチャするイベント

event_contract_checkedingestion_freshness_sampledduplicate_event_observedschema_version_observedevent_volume_sampled

質問のロックが解除されました

  • どの重要なイベント ストリームが古い、不完全、重複している、またはタイプが変更されていますか?
  • 現在のトラフィックの何パーセントが承認されたスキーマ バージョンを使用していますか?
  • ダッシュボードが変更される前に、リリースによりイベントの量や必須フィールドの完全性が変更されましたか?

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

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

関連製品の機能

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

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

関連する SQL レシピ

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

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

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

顧客の証拠

お客様が説明した関連ワークフロー

次のステップ

エージェントが使用する API キーを作成します

プロンプトの実行、テスト イベントの送信、最初のダッシュボードの確認には無料プランで十分です。

関連ページ