R2 Data Catalog metrics now flow through the GraphQL Analytics API!

Hey there, it's me, Shii-chan! Today I dug up an update around R2's data platform. It's a quiet one, but if you run this stuff, it's the kind of thing that makes you happy.

Cloudflare Changelog developers.cloudflare.com

What was announced?

This one comes from Cloudflare's Changelog. R2 Data Catalog can now expose metrics through the GraphQL Analytics API. There are two new datasets:

• r2CatalogDataOperationsAdaptiveGroups: tracks Iceberg REST API requests to your catalog
• r2CatalogTableMaintenanceAdaptiveGroups: tracks table maintenance jobs like compaction and snapshot expiration

The story so far

R2 Data Catalog is a managed Apache Iceberg catalog built directly into your R2 bucket. What makes it lovely is that you can connect query engines like R2 SQL, Spark, Snowflake, and DuckDB to your data in R2.

But until now, there wasn't much of a way to see, from the outside and in numbers, how many requests were hitting your catalog or whether maintenance jobs were running smoothly.

What changes

From now on, a single call to the GraphQL Analytics API lets you filter by warehouse, namespace, table, and time range to see request volume and latency. Duration metrics even include percentile aggregations, so you can look at things like p50 and p99.

That means you can wire it into a monitoring dashboard or hunt down slow tables all on your own.

Dive Deep

• r2CatalogDataOperationsAdaptiveGroups carries operation type, request duration, HTTP status, and request body bytes. Use it to monitor request volume and latency across warehouses, namespaces, and tables.
• r2CatalogTableMaintenanceAdaptiveGroups lets you follow job success rates, files processed, bytes read and written, and job duration.
• Both datasets support filtering by warehouse name, namespace, table name, and time range, and include percentile aggregations for duration. For schema details and example queries, check the R2 Data Catalog metrics and analytics documentation.

Wrap-up

• R2 Data Catalog metrics are now available through the GraphQL Analytics API
• Two new datasets: one for requests, one for table maintenance
• Filter by warehouse, namespace, table, and time range, plus percentile aggregations for duration
• This one's for folks running Iceberg on R2 who want to take monitoring and observability seriously!