本文へ移動
Telemetry
データ品質 SQL レシピ

イベント名によるTelemetryボリュームの測定

保存ポリシーや収集ポリシーを変更する前に、ペイロード バイト、平均イベント サイズ、拒否率に基づいてイベント タイプをランク付けします。

初心者telemetry_ingestion_eventsレビュー済み 2026-07-28テスト済み アパッチ DataFusion 45.2.0

レビュー者 Telemetry 製品チーム . SQL の互換性、イベント コントラクト、合成出力、および操作上の注意事項. 基準と所有権を確認する

質問に回答しました

どのイベント コントラクトが最も多くの取り込み量を生み出しますか?

イベント数だけでも、サイズの大きいペイロードを隠すことができます。このクエリはカウントとバイト ボリュームをまとめて保持し、ペイロード バイトがベンダーの請求額と等しいかのように見せることなく、ノイズの多いイベント コントラクトや予想外に大規模なイベント コントラクトを可視化します。

イベント契約

クエリが期待するフィールド

フィールド種類なぜ存在するのか
timestamp_utcTimestamp取り込み試行時間(UTC)。
event_nameUtf8制御されるイベント名。
sourceUtf8境界のあるプロデューサーまたは SDK ソース。
payload_bytesInt64トランスポート圧縮前のシリアル化されたイベントのサイズ。
acceptedBoolean取り込みがイベントを受け入れたかどうか。
environmentUtf8導入環境。
DataFusion SQL

クエリをコピーする

sql
SELECT
  event_name,
  source,
  COUNT(*) AS events,
  SUM(payload_bytes) AS total_payload_bytes,
  AVG(payload_bytes) AS avg_payload_bytes,
  SUM(CASE WHEN accepted THEN 0 ELSE 1 END) AS rejected_events,
  100.0 * SUM(CASE WHEN accepted THEN 0 ELSE 1 END)
    / NULLIF(COUNT(*), 0) AS rejection_rate_pct
FROM telemetry_ingestion_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
  AND environment = 'production'
GROUP BY event_name, source
ORDER BY total_payload_bytes DESC, event_name;

この読み取り専用クエリは、空の型付きテーブルに対して計画され、実行されます。 アパッチ DataFusion 45.2.0。決定論的なサンプル出力は合成され、個別にレビューされます。フィールド タイプ、しきい値、ビジネス定義を独自のデータと照合して検証します。 テスト方法を読んでください。

クエリ結果

イベント契約ごとのペイロード量

合成デバッグ トレースは、ページ ビューよりもイベントが少ないにもかかわらず、バイト ボリュームが最も大きくなります。

event_namesourceeventstotal_payload_bytesavg_payload_bytesrejected_eventsrejection_rate_pct
debug_traceworker416,0004,000125
llm_request_completedapi36,0002,00000
page_viewedweb63,000500116.67

合成出力例。運用上の決定に使用する前に、独自のイベント スキーマとしきい値に対してクエリを実行します。

Payload volume by event contract: Measure Telemetry Volume by Event Name 結果例からの合成 total_payload_bytes 値の静的チャート
決定論的な出力例のインデックス可能な SVG。記事、ランブック、または出典を明示した設計レビューのためにダウンロードしてください。

例を再現する

パブリックフィクスチャをダウンロードする

JSON バンドルには、型付きイベント コントラクトが含まれています。 reproducible 入力行、正確な SQL、予想される出力、レビューメモ、およびエンジンのバージョン。 CSV には、表示された結果が含まれます。

SQL の仕組み

  1. 1合計バイト数と平均バイト数によって、高頻度のイベントと大規模なコントラクトが区別されます。
  2. 2複数のプロデューサーが同じイベント名を発行できる場合、ソースは所有権を表示したままにします。
  3. 3拒否率により、収集の変更はコストのみを考慮した作業ではなく、データ品質のレビューに変わります。

決定すべきエッジケース

  • シリアル化されたペイロード サイズは、保存サイズ、スキャン バイト、ネットワーク送信、または請求コストではありません。
  • ディメンションのカーディナリティを個別に測定します。小規模なイベントでも、高価なグループや使用不可能なグループが作成される可能性があります。
  • 本番環境の保持を変更する前に、合成トラフィックと開発トラフィックを除外します。

推奨されるダッシュボード

  • バー: total_payload_bytes by event_name
  • 傾向: ソース別のイベント数とバイト数
  • 表: 平均サイズ、拒否率、保持所有者、およびスキーマのバージョン

アラートガイダンス

グローバルな固定バイトしきい値ではなく、レビューされたベースラインと比較した継続的な契約サイズまたはボリュームの変更についてアラートを発行します。

アラート設定を読む

レシピを活用する

関連する機器とガイド

分析を続ける

実際のイベントで実行する

テーブルを作成し、フィールドを調整して、結果を保存します

無料で始めて、構造化されたイベントを送信し、クエリ結果をグラフ、共有ダッシュボード ウィジェット、またはアラート入力として使用します。

API キーを取得する