イベント契約
クエリが期待するフィールド
| フィールド | 種類 | なぜ存在するのか |
|---|---|---|
| timestamp_utc | Timestamp | 取り込み試行時間(UTC)。 |
| event_name | Utf8 | 制御されるイベント名。 |
| source | Utf8 | 境界のあるプロデューサーまたは SDK ソース。 |
| payload_bytes | Int64 | トランスポート圧縮前のシリアル化されたイベントのサイズ。 |
| accepted | Boolean | 取り込みがイベントを受け入れたかどうか。 |
| environment | Utf8 | 導入環境。 |
クエリをコピーする
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_name | source | events | total_payload_bytes | avg_payload_bytes | rejected_events | rejection_rate_pct |
|---|---|---|---|---|---|---|
| debug_trace | worker | 4 | 16,000 | 4,000 | 1 | 25 |
| llm_request_completed | api | 3 | 6,000 | 2,000 | 0 | 0 |
| page_viewed | web | 6 | 3,000 | 500 | 1 | 16.67 |
合成出力例。運用上の決定に使用する前に、独自のイベント スキーマとしきい値に対してクエリを実行します。
例を再現する
パブリックフィクスチャをダウンロードする
JSON バンドルには、型付きイベント コントラクトが含まれています。 reproducible 入力行、正確な SQL、予想される出力、レビューメモ、およびエンジンのバージョン。 CSV には、表示された結果が含まれます。
SQL の仕組み
- 1合計バイト数と平均バイト数によって、高頻度のイベントと大規模なコントラクトが区別されます。
- 2複数のプロデューサーが同じイベント名を発行できる場合、ソースは所有権を表示したままにします。
- 3拒否率により、収集の変更はコストのみを考慮した作業ではなく、データ品質のレビューに変わります。
決定すべきエッジケース
- シリアル化されたペイロード サイズは、保存サイズ、スキャン バイト、ネットワーク送信、または請求コストではありません。
- ディメンションのカーディナリティを個別に測定します。小規模なイベントでも、高価なグループや使用不可能なグループが作成される可能性があります。
- 本番環境の保持を変更する前に、合成トラフィックと開発トラフィックを除外します。
推奨されるダッシュボード
- バー: total_payload_bytes by event_name
- 傾向: ソース別のイベント数とバイト数
- 表: 平均サイズ、拒否率、保持所有者、およびスキーマのバージョン
レシピを活用する
関連する機器とガイド
分析を続ける
実際のイベントで実行する
テーブルを作成し、フィールドを調整して、結果を保存します
無料で始めて、構造化されたイベントを送信し、クエリ結果をグラフ、共有ダッシュボード ウィジェット、またはアラート入力として使用します。