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.