イベント契約
クエリが期待するフィールド
| フィールド | 種類 | なぜ存在するのか |
|---|---|---|
| timestamp_utc | Timestamp | リクエストの完了時間。 |
| release_version | Utf8 | アプリケーションのリリースまたはビルドの識別子。 |
| status_code | Int64 | HTTP 応答ステータス コード。 |
| latency_ms | Float64 | リクエストの継続時間 (ミリ秒単位)。 |
DataFusion SQL
クエリをコピーする
sql
SELECT
release_version,
COUNT(*) AS requests,
100.0 * SUM(CASE WHEN status_code >= 500 THEN 1 ELSE 0 END)
/ NULLIF(COUNT(*), 0) AS error_rate_pct,
approx_percentile_cont(latency_ms, 0.95) AS p95_latency_ms
FROM api_requests
WHERE timestamp_utc >= now() - INTERVAL '7 days'
AND release_version IS NOT NULL
GROUP BY release_version
HAVING COUNT(*) >= 100
ORDER BY error_rate_pct DESC, p95_latency_ms DESC;この読み取り専用クエリは、空の型付きテーブルに対して計画され、実行されます。 アパッチ DataFusion 45.2.0。決定論的なサンプル出力は合成され、個別にレビューされます。フィールド タイプ、しきい値、ビジネス定義を独自のデータと照合して検証します。 テスト方法を読んでください。
クエリ結果
リリースごとの 5xx レート
リリース 2026.07.27.2 は、エラー率と p95 遅延が最も高くなります。
2026.07.27.2
1.82%
comparison 1,180%
2026.07.27.1
0.44%
comparison 620%
2026.07.26.4
0.31%
comparison 590%
| release_version | requests | error_rate_pct | p95_latency_ms |
|---|---|---|---|
| 2026.07.27.2 | 22,640 | 1.82 | 1,180 |
| 2026.07.27.1 | 18,110 | 0.44 | 620 |
| 2026.07.26.4 | 39,400 | 0.31 | 590 |
合成出力例。運用上の決定に使用する前に、独自のイベント スキーマとしきい値に対してクエリを実行します。
例を再現する
パブリックフィクスチャをダウンロードする
JSON バンドルには、型付きイベント コントラクトが含まれています。 illustrative 入力行、正確な SQL、予想される出力、レビューメモ、およびエンジンのバージョン。 CSV には、表示された結果が含まれます。
SQL の仕組み
- 1リリースごとにグループ化すると、重複するロールアウト トラフィックが分離されます。
- 2最小量ルールにより、小さなカナリア サンプルからの比較が保護されます。
- 3結果を相関関係として扱います。原因を割り当てる前に、ルート、地域、顧客、およびエラーの種類の内訳を追跡します。
決定すべきエッジケース
- リリース識別子のないリクエストはデプロイ分析をサポートできません。
- 段階的なロールアウトには、展開の開始時間と、これらの集約に伴うトラフィックの共有が必要です。
- セグメンテーションを行わずに、根本的に異なるルートや顧客セグメントにサービスを提供したリリースを比較しないでください。
推奨されるダッシュボード
- バー: リリースごとに error_rate_pct
- グループ化されたバー: p95 レイテンシとリクエスト量
- 表: 選択したリリースのエラー タイプ
レシピを活用する
関連する機器とガイド
分析を続ける
実際のイベントで実行する
テーブルを作成し、フィールドを調整して、結果を保存します
無料で始めて、構造化されたイベントを送信し、クエリ結果をグラフ、共有ダッシュボード ウィジェット、またはアラート入力として使用します。