本文へ移動
Telemetry
ダッシュボードの例

バックグラウンドジョブの信頼性 ダッシュボード

ターミナル ジョブの結果を試行から分離し、安定したジョブ名ごとに再試行、キュー待機、および期間を比較します。

レビュー者 Telemetry 製品チーム . 意思決定、イベント粒度、メトリクス、DataFusion SQL、合成結果、仮定、鮮度、解釈境界. 基準と所有権を確認する

条目

論理ジョブごとに 1 つの最終結果。

決定が支持されました

容量、再試行ポリシー、ジョブ コード、または依存関係を検査するかどうかを選択します。

メートル法契約

分母と単位をグラフの横に置きます

宣言された穀物を維持しながら、これらの名前を契約に適合させます。運用プロデューサーからフィールドをマッピングする前に、リンクされたイベント スキーマを検査します。

  • 完了したジョブ
  • 端末故障率
  • リトライ率
  • p95 持続時間
イベントスキーマを検査する
完全な DataFusion SQL

フィールドを調整する前にクエリを確認してください

このパブリック クエリは開始定義です。実稼働イベント契約に適した、制限された時間フィルター、完全バケット ポリシー、環境、および最小ボリュームを追加します。

SELECT
  job_name,
  COUNT(*) AS completed_jobs,
  ROUND(
    100.0 * SUM(CASE WHEN status = 'error' THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0),
    2
  ) AS terminal_failure_rate_pct,
  ROUND(AVG(attempt_count), 2) AS average_attempts,
  approx_percentile_cont(duration_ms, 0.95) AS p95_duration_ms
FROM job_runs
GROUP BY job_name
ORDER BY terminal_failure_rate_pct DESC, completed_jobs DESC;
データの仮定

結果を公開する前にこれらを証明してください

  • 安定したジョブ識別子は、ジョブ ペイロードを公開することなく試行を接続します。
  • 試行回数には、端末の試行が含まれます。
  • キューの待機時間と実行時間には、別のミリ秒フィールドが使用されます。
クエリレビュー

ダッシュボードの信頼性を維持するためのチェック

  • 試行レベルのデータは、分母が明示的に試行である場合にのみ使用します。
  • 実行時間の横にキュー待機パーセンタイルを追加します。
  • 開始ライフサイクル イベントと終了ライフサイクル イベントを使用して、消滅したワーカーを検出します。

解釈境界

この結果だけでは証明できないこと

ジョブごとに 1 つの最終結果を数えます。試行レベルのログはボリュームを増大させ、回復された再試行が失敗した顧客のワークフローのように見える可能性があります。

関連するダッシュボードの例

既知のデータを使用して定義を検証する

クエリを運用ダッシュボードまたはアラートに接続する前に、既知の成功、失敗、欠落、重複、境界のケースを含むフィクスチャを実行します。