イベント契約
クエリが期待するフィールド
| フィールド | 種類 | なぜ存在するのか |
|---|---|---|
| timestamp_utc | Timestamp | 失敗の時間。 |
| error_fingerprint | Utf8 | 安定した正規化誤差グループ。 |
| team_id | Utf8 | 安全な影響を受けるアカウントの識別子。 |
| status_code | Int64 | HTTP ステータス コード。 |
DataFusion SQL
クエリをコピーする
sql
SELECT
error_fingerprint,
COUNT(*) AS occurrences,
COUNT(DISTINCT team_id) AS affected_teams
FROM api_requests
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
AND status_code >= 500
AND error_fingerprint IS NOT NULL
GROUP BY error_fingerprint
ORDER BY affected_teams DESC, occurrences DESC
LIMIT 20;この読み取り専用クエリは、空の型付きテーブルに対して計画され、実行されます。 アパッチ DataFusion 45.2.0。決定論的なサンプル出力は合成され、個別にレビューされます。フィールド タイプ、しきい値、ビジネス定義を独自のデータと照合して検証します。 テスト方法を読んでください。
クエリ結果
エラーフィンガープリントによる影響を受けるチーム
税務サービスのタイムアウトは、OAuth エラーよりも繰り返し発生しませんが、影響ははるかに広範囲に及びます。
checkout.tax_service_timeout
73
sync.oauth_token_expired
18
report.pdf_render_failed
16
| error_fingerprint | occurrences | affected_teams |
|---|---|---|
| checkout.tax_service_timeout | 184 | 73 |
| sync.oauth_token_expired | 920 | 18 |
| report.pdf_render_failed | 44 | 16 |
合成出力例。運用上の決定に使用する前に、独自のイベント スキーマとしきい値に対してクエリを実行します。
例を再現する
パブリックフィクスチャをダウンロードする
JSON バンドルには、型付きイベント コントラクトが含まれています。 illustrative 入力行、正確な SQL、予想される出力、レビューメモ、およびエンジンのバージョン。 CSV には、表示された結果が含まれます。
SQL の仕組み
- 1安定したフィンガープリントでは、リクエスト ID やその他の揮発性メッセージのフラグメントが削除されるはずです。
- 2COUNT DISTINCT team_id は幅を測定し、オカレンスは繰り返しを測定します。
- 3影響を受けるアカウントごとに順序を付けることで、最初の優先順位付けビューがユーザーへの影響に近づくようになります。
決定すべきエッジケース
- 生のエラー メッセージ全体をハッシュすると、識別子が変更されるたびに新しいグループが作成されます。
- 匿名または未認証のリクエストには、別の影響度が必要です。
- グループ化フィールドには生のスタック トレースや個人データを含めないでください。
推奨されるダッシュボード
- バー: 指紋による affected_teams
- 表: 発生状況と最新リリース
- 傾向: 上位のフィンガープリントの推移
レシピを活用する
関連する機器とガイド
分析を続ける
実際のイベントで実行する
テーブルを作成し、フィールドを調整して、結果を保存します
無料で始めて、構造化されたイベントを送信し、クエリ結果をグラフ、共有ダッシュボード ウィジェット、またはアラート入力として使用します。