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

API の信頼性と遅延 ダッシュボード

パーセンタイルが安定しているかどうかを判断するのに十分な量を維持しながら、トラフィック、エラー率、テール レイテンシをエンドポイントごとに比較します。

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

条目

ルート テンプレートでグループ化する前の 1 つの端末要求の結果。

決定が支持されました

リリースの比較、依存関係の検査、またはロールバック レビューのためにエンドポイントに優先順位を付けます。

メートル法契約

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

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

  • リクエスト量
  • エラー率
  • p50 レイテンシ
  • p95 レイテンシ
イベントスキーマを検査する
完全な DataFusion SQL

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

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

SELECT
  endpoint,
  COUNT(*) AS requests,
  ROUND(
    100.0 * SUM(CASE WHEN status = 'error' THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0),
    2
  ) AS error_rate_pct,
  approx_percentile_cont(latency_ms, 0.50) AS p50_ms,
  approx_percentile_cont(latency_ms, 0.95) AS p95_ms
FROM api_requests
GROUP BY endpoint
ORDER BY error_rate_pct DESC, requests DESC;
データの仮定

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

  • エンドポイント値は、生の URL ではなく、制限されたルート テンプレートです。
  • レイテンシーは、プロデューサー間で 1 つのエンドツーエンドのミリ秒定義を使用します。
  • 運用チャートでは、最新の不完全なタイム バケットが省略されます。
クエリレビュー

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

  • このクエリを運用環境で使用する前に、制限時間フィルターを追加してください。
  • リクエストのボリュームをすべてのパーセンタイルとレートの横に置いてください。
  • リグレッションを検出した後、リリースとエラーのタイプごとにセグメント化します。

解釈境界

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

常にパーセンタイルの横にリクエスト数を表示します。少数のグループによる高い p95 は、広範な顧客への影響と同等ではありません。

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

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

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