本文へ移動
Telemetry
データベースの信頼性 SQL レシピ

リージョンごとにデータベース レプリカの古さを測定する

アプリケーションで観察されたレプリカのリプレイ ラグ、古い読み取り、フェイルオーバーの結果をリージョンごとに比較します。

上級者向けdatabase_replica_read_eventsレビュー済み 2026-07-28テスト済み アパッチ DataFusion 45.2.0

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

質問に回答しました

どのレプリカ リージョンが古い読み取りまたは失敗した読み取りを処理していますか?

インフラストラクチャのレプリケーションの遅延は、アプリケーションから見える古い状態と必ずしも同じではありません。読み取りイベントは、選択したレプリカの役割、再生ラグ、一貫性の結果を保存できます。

イベント契約

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

フィールド種類なぜ存在するのか
timestamp_utcTimestampレプリカの読み取り完了時間。
regionUtf8アプリケーション領域。
replica_roleUtf8プライマリ、レプリカ、またはフェイルオーバー ターゲット。
replay_lag_msFloat64リプレイラグが観察または報告されました。
consistency_outcomeUtf8新しい、古い、失敗した、または不明です。
operation_nameUtf8アプリケーションの読み取り操作を制御します。
DataFusion SQL

クエリをコピーする

sql
SELECT
  region,
  replica_role,
  operation_name,
  COUNT(*) AS reads,
  approx_percentile_cont(replay_lag_ms, 0.95) AS p95_replay_lag_ms,
  SUM(CASE WHEN consistency_outcome = 'stale' THEN 1 ELSE 0 END)
    AS stale_reads,
  SUM(CASE WHEN consistency_outcome = 'failed' THEN 1 ELSE 0 END)
    AS failed_reads
FROM database_replica_read_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
GROUP BY region, replica_role, operation_name
ORDER BY stale_reads DESC, p95_replay_lag_ms DESC;

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

クエリ結果

レプリカ領域ごとの古い読み取り数

ap-southeast サブスクリプション読み取りには、観測された最も高い失効性とリプレイ ラグ テールがあります。

regionreplica_roleoperation_namereadsp95_replay_lag_msstale_readsfailed_reads
ap-southeastreplicasubscription-status18,4004,82021418
eu-westreplicaproject-list42,100740312

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

Stale reads by replica region: Measure Database Replica Staleness by Region 結果例からの合成 stale_reads 値の静的チャート
決定論的な出力例のインデックス可能な SVG。記事、ランブック、または出典を明示した設計レビューのためにダウンロードしてください。

例を再現する

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

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

SQL の仕組み

  1. 1レプリカの役割とリージョンは読み取りパスを識別します。
  2. 2アプリケーションの整合性の結果は、報告された遅延とは別に、ユーザーに見える古さを記録します。
  3. 3オペレーション名は、どのワークフローがより強力な読み取り後書き込み動作を必要とするかを示します。

決定すべきエッジケース

  • 一貫性の結果には、防御可能なアプリケーション チェックが必要です。
  • 再生ラグの単位はデータベースとコレクターによって異なります。
  • データベースネイティブのレプリケーションおよびフェイルオーバーツールは、引き続きサーバー診断のソースとなります。

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

  • バー: 地域別 stale_reads
  • 傾向: 役割別の p95_replay_lag_ms
  • 表: 操作別の失敗した読み取り

アラートガイダンス

重要な操作が、レビューされた一貫性目標を超えて古い読み取りまたは失敗した読み取りを処理する場合にアラートを送信します。

アラート設定を読む

レシピを活用する

関連する機器とガイド

分析を続ける

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

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

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

API キーを取得する