本文へ移動
Telemetry
API の信頼性 SQL レシピ

インシデントの顧客への影響を計画ごとに測定する

顧客名や生のリクエストデータを公開することなく、影響を受けるアカウントと平均影響期間をプランごとにカウントします。

中級者incident_account_impact_eventsレビュー済み 2026-07-28テスト済み アパッチ DataFusion 45.2.0

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

質問に回答しました

各計画でインシデントの影響を受けたアカウントの数は何ですか?

サービスレベルのエラー率からは、誰が影響を受けたのかがわかりません。制限付き影響イベントは、1 つのインシデントを仮名のアカウント、計画、制御された影響の種類、および期間に結び付けるため、対応チームは復旧とコミュニケーションに優先順位を付けることができます。

イベント契約

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

フィールド種類なぜ存在するのか
timestamp_utcTimestampUTC での影響評価時間。
incident_idUtf8安定したインシデント識別子。
account_idUtf8承認された仮名アカウント識別子。
planUtf8制限付きのプランまたはサービス層。
impact_typeUtf8顧客に見える影響カテゴリーを制御します。
affectedBooleanアカウントが文書化された影響定義を満たしているかどうか。
impact_duration_msInt64ミリ秒単位で測定された衝撃持続時間。
environmentUtf8導入環境。
DataFusion SQL

クエリをコピーする

sql
SELECT
  incident_id,
  plan,
  COUNT(*) AS assessed_accounts,
  SUM(CASE WHEN affected THEN 1 ELSE 0 END) AS affected_accounts,
  100.0 * SUM(CASE WHEN affected THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS affected_accounts_pct,
  AVG(CASE WHEN affected THEN impact_duration_ms ELSE NULL END)
    AS avg_impact_duration_ms
FROM incident_account_impact_events
WHERE timestamp_utc >= now() - INTERVAL '7 days'
  AND environment = 'production'
GROUP BY incident_id, plan
ORDER BY affected_accounts DESC, plan;

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

クエリ結果

プランごとに影響を受けるアカウント

3 つのエンタープライズ アカウントと 2 つのスターター アカウントは、総合的なインシデントと影響の定義を満たしています。

incident_idplanassessed_accountsaffected_accountsaffected_accounts_pctavg_impact_duration_ms
incident-checkout-42enterprise437540,000
incident-checkout-42starter524020,000

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

Affected accounts by plan: Measure Incident Customer Impact by Plan 結果例からの合成 affected_accounts 値の静的チャート
決定論的な出力例のインデックス可能な SVG。記事、ランブック、または出典を明示した設計レビューのためにダウンロードしてください。

例を再現する

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

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

SQL の仕組み

  1. 1評価済みアカウントの分母により、不完全な結合が低い影響率として見せかけられるのを防ぎます。
  2. 2計画は、制限された優先順位付けの次元です。クエリでは顧客名は公開されません。
  3. 3影響期間は影響を受けるアカウントに対してのみ計算されるため、影響を受けない行によって平均がゼロに近づくことはありません。

決定すべきエッジケース

  • 単に相関関係のある内部エラーではなく、ユーザーに表示される結果を使用して、影響を受けると定義します。
  • 1 つのアカウントに複数のユーザーまたはリージョンが含まれる場合があります。行を出力する前にレポート単位を選択します。
  • アカウントレベルのドリルダウンを制限し、承認された応答ワークフローに対してのみ集計を使用します。

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

  • バー: 計画による affected_accounts
  • 傾向: 新たに影響を受けたアカウントと回復したアカウント
  • 制限付きテーブル: 承認されたアカウント識別子と影響の種類

アラートガイダンス

このクエリは、インシデント検出後のスコープ設定とエスカレーションに使用します。アカウントレベルの行ごとに 2 ページ目を作成しないでください。

アラート設定を読む

レシピを活用する

関連する機器とガイド

分析を続ける

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

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

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

API キーを取得する