OpenAICloudflare Developer Platform2026/05/12 0:00

R2 - R2 Data Catalog now exposes metrics via the GraphQL Analytics API

要点だけを先に読めるように短く再構成したセクションです。

元記事

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

openaijamodel: gpt-5-mini-2025-08-07

R2 Data Catalog のメトリクスが GraphQL Analytics API で取得可能に

Key Points

  • メトリクス公開
  • 2つのデータセット
  • パーセンタイル対応

Summary

R2 Data Catalog(Apache Iceberg ベース)のメトリクスが Cloudflare の GraphQL Analytics API で取得可能になりました。エンジニアはこれらのデータセットをクエリして、リクエスト量・レイテンシ・テーブル保守ジョブの成功率などを監視・可視化できます。

Key Points

  • 新しいデータセット:
    • r2CatalogDataOperationsAdaptiveGroups: Iceberg の REST API リクエストを追跡(operation、duration、HTTP ステータス、リクエストボディバイト数)。倉庫・ネームスペース・テーブル単位でのリクエストボリュームとレイテンシ監視に利用。
    • r2CatalogTableMaintenanceAdaptiveGroups: コンパクションやスナップショット期限切れなど保守ジョブを追跡(成功率、処理ファイル数、読み書きバイト数、ジョブ時間)。
  • フィルタリング: warehousenamespacetable、時間範囲で絞り込み可能。
  • 集計: duration 系にはパーセンタイル集計(例: p50、p95)を使用可能。
  • 実用的な使い方: GraphQL Analytics API で該当データセットを指定し、フィルタ+集約クエリを組んでダッシュボードやアラートのデータソースにする。詳細は公式ドキュメントのスキーマとサンプルクエリを参照。

Actionable tips

  • まず短期間で p95 レイテンシを取得して平常値を把握し、異常検出の閾値を設定する。
  • 保守ジョブの成功率・処理バイト数を定期集計して、リトライや最適化のトリガーにする。
  • テーブル単位のコンパクション時間や処理ファイル数を比較して、最適化対象を特定する。

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

openaijamodel: gpt-5-mini-2025-08-07

R2 - R2 Data Catalog が GraphQL Analytics API 経由でメトリクスを公開

R2 Data Catalog が GraphQL Analytics API 経由でメトリクスを公開

公開日: 2026-05-12

R2 Data Catalog は、R2 バケットに直接組み込まれたマネージド Apache Iceberg データカタログで、R2 SQL、Spark、Snowflake、DuckDB などのクエリエンジンを R2 のデータに接続できます。Cloudflare の GraphQL Analytics API を通じて、R2 Data Catalog のウェアハウスに関する分析情報をクエリできるようになりました。

利用可能な新しいデータセット

  • r2CatalogDataOperationsAdaptiveGroups

    • カタログに対して行われた Iceberg REST API リクエストを追跡します。
    • 収集される主要項目: 操作タイプ、リクエストの所要時間(duration)、HTTP ステータス、リクエストボディのバイト数。
    • 用途: ウェアハウス、ネームスペース、テーブルごとのリクエスト量とレイテンシの監視。
  • r2CatalogTableMaintenanceAdaptiveGroups

    • コンパクションやスナップショットの有効期限切れなどのテーブル保守ジョブを追跡します。
    • 収集される主要項目: ジョブの成功率、処理されたファイル数、読み取り・書き込みバイト数、ジョブ所要時間。
    • 用途: 保守ジョブの状況把握とパフォーマンス分析。

フィルタリングと集計

両データセットとも以下の条件でフィルタリングできます:

  • ウェアハウス名
  • ネームスペース
  • テーブル名
  • 時間範囲

また、duration(所要時間)メトリクスに対するパーセンタイル集計もサポートしています。

詳細

詳細なスキーマ情報や例示クエリについては、R2 Data Catalog metrics and analytics documentation を参照してください。