本文へ移動
Telemetry
フロントエンドの信頼性 SQL レシピ

ルートとリリースごとにコア Web バイタルを比較

通過するサンプルのパーセンテージを視覚的に維持しながら、安定したルートとリリースによって LCP、INP、および CLS サンプルを比較します。

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

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

質問に回答しました

フロントエンドのパフォーマンスが最も弱いルートとリリースはどれですか?

フロントエンド平均は、ルートを保持して境界を解放すると実用的になります。このクエリは、入力された Web-vital サンプルをルートおよびリリースごとに 1 行にピボットし、製品のレビュー済みしきい値を通過したサンプルの割合によって結果を並べ替えます。

イベント契約

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

フィールド種類なぜ存在するのか
timestamp_utcTimestampUTC での測定時間。
route_templateUtf8ユーザーまたはクエリ文字列の値を持たない安定したルート テンプレート。
releaseUtf8フロントエンドのリリース識別子。
metric_nameUtf8制御された LCP、INP、または CLS メトリック名。
metric_valueFloat64文書化された単位でのメトリック値。
passedBooleanサンプルが製品のバージョン管理されたしきい値を通過したかどうか。
environmentUtf8導入環境。
DataFusion SQL

クエリをコピーする

sql
SELECT
  route_template,
  release,
  COUNT(*) AS samples,
  AVG(CASE WHEN metric_name = 'LCP' THEN metric_value ELSE NULL END) AS avg_lcp_ms,
  AVG(CASE WHEN metric_name = 'INP' THEN metric_value ELSE NULL END) AS avg_inp_ms,
  AVG(CASE WHEN metric_name = 'CLS' THEN metric_value ELSE NULL END) AS avg_cls,
  100.0 * SUM(CASE WHEN passed THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS passing_samples_pct
FROM frontend_vital_events
WHERE timestamp_utc >= now() - INTERVAL '7 days'
  AND environment = 'production'
GROUP BY route_template, release
ORDER BY passing_samples_pct ASC, route_template, release;

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

クエリ結果

フロントエンドサンプルをルートで渡す

Checkout は合成 LCP、INP、CLS サンプルの半分を渡します。検索ではすべてのサンプルが渡されます。

route_templatereleasesamplesavg_lcp_msavg_inp_msavg_clspassing_samples_pct
/checkoutweb-10262,8002200.150
/searchweb-10261,8501200.05100

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

Passing frontend samples by route: Compare Core Web Vitals by Route and Release 結果例からの合成 passing_samples_pct 値の静的チャート
決定論的な出力例のインデックス可能な SVG。記事、ランブック、または出典を明示した設計レビューのためにダウンロードしてください。

例を再現する

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

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

SQL の仕組み

  1. 1ルート テンプレートでは、生の URL または顧客 ID ごとに 1 つのグラフ シリーズを作成できなくなります。
  2. 2リリース ディメンションにより、パフォーマンスの変化がデプロイを対象とした調査に変わります。
  3. 3メトリクス固有の平均は単一の合格サンプルの概要の横に残るため、レビュー担当者はどのバイタルが移動したかを確認できます。

決定すべきエッジケース

  • レビュー済みのメトリック固有のしきい値を使用し、定義が変更されたときにそのバージョンを記録します。
  • サンプル量により比較がノイズから保護される場合にのみ、デバイス クラスと地理をセグメント化します。
  • SQL エンジンとサンプル量が許可する場合、実稼働エクスペリエンスのレポートでは平均よりもパーセンタイルを優先します。

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

  • バー: ルートおよびリリース別の passing_samples_pct
  • 傾向: 1 日ごとの LCP、INP、CLS
  • 表: サンプル数とリリースの変更を含むルート

アラートガイダンス

サンプル量が十分であり、ルートがバケット全体についてレビューされたパフォーマンス目標を下回っている場合にのみアラートを送信します。

アラート設定を読む

レシピを活用する

関連する機器とガイド

ソースデータを定義する

この分析のイベント スキーマ

分析を続ける

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

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

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

API キーを取得する