OpenAICloudflare Developer PlatformMay 12, 2026, 12:00 AM

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

A condensed section focused on the key takeaways first.

Original Post

Quick Digest

Summary

A condensed section focused on the key takeaways first.

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

R2 Data Catalog now exposes metrics via the GraphQL Analytics API

Key Points

  • GraphQL analytics access
  • Data operations dataset
  • Table maintenance dataset

Summary

Cloudflare R2 Data Catalog metrics are now queryable via the GraphQL Analytics API. Two new datasets provide operational telemetry for Iceberg catalog REST API requests and table maintenance jobs, enabling engineers to monitor request latency/volume and maintenance job health across warehouses, namespaces, and tables.

Key Points

  • Access: query metrics through Cloudflare's GraphQL Analytics API.
  • r2CatalogDataOperationsAdaptiveGroups: tracks Iceberg REST API requests (operation type, request duration, HTTP status, request body bytes) for monitoring request volume and latency by warehouse/namespace/table.
  • r2CatalogTableMaintenanceAdaptiveGroups: tracks table maintenance jobs (compaction, snapshot expiration) including job success rates, files processed, bytes read/written, and job duration.
  • Filtering & aggregations: both datasets support filtering by warehouse name, namespace, table name, and time range; duration percentiles are provided for latency analysis.
  • Practical uses: build alerts/dashboards for high-latency or failed requests, track maintenance job performance, and inform capacity and optimization decisions.
  • Next steps: see the R2 Data Catalog metrics and analytics documentation for dataset schemas and example GraphQL queries.

Full Translation

Translations

A translation section that keeps the flow of the original article.

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 を参照してください。