Cloudflare analytics metrics

The Cloudflare connection can pull analytics for your zones and Workers every 5 minutes. Squasher stores them as OpenTelemetry metrics, next to the Worker logs and traces from Cloudflare Workers. The analytics pull is off by default. It is read-only.

Prerequisites

A Cloudflare provider connection on the project.
These permissions on the connection: Account Analytics Read, Zone Read, and Zone Analytics Read. A connection made before the analytics pull existed does not have them. Connect it again one time to grant them.

Turn on the analytics pull

Dashboard
CLI
API

Open your project and select Settings in the sidebar, then the Integrations tab.
On the Cloudflare card, turn on the analytics metrics.

squasher integrations cloudflare-analytics --project "$SQUASHER_PROJECT_ID" --enable

Use --disable to stop the pull.

curl -X PUT "https://api.squasher.ai/v1/projects/$SQUASHER_PROJECT_ID/provider-connections/cloudflare/analytics" \
  -H "x-squasher-key: $SQUASHER_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

The response gives enabled and the required_permissions of the pull.

Metrics

Squasher reads the Cloudflare GraphQL Analytics API. Zone metrics are split by status class, cache status, and data center. Worker metrics are split by Worker.

Metric	What it counts
`cloudflare.zone.requests`	HTTP requests to the zone
`cloudflare.zone.bytes`	Bytes that the zone sent
`cloudflare.worker.requests`	Worker invocations
`cloudflare.worker.errors`	Worker invocations that ended with an error
`cloudflare.worker.subrequests`	Subrequests that Workers made
`cloudflare.worker.cpu_time`	Worker CPU time, at p50 and p99 in the `cloudflare.quantile` attribute
`cloudflare.worker.duration`	Worker wall time

Each metric has these resource attributes:

Attribute	Value
`cloud.provider`	`cloudflare`
`cloud.account.id`	The Cloudflare account ID
`faas.name`	The Worker name, on Worker metrics
`squasher.source`	`cloudflare.analytics`

Query the metrics in Metrics, or see the zones and Workers with their key metrics under Infrastructure, on the Providers tab.

Check the pull

squasher integrations health --project "$SQUASHER_PROJECT_ID"
squasher integrations resources --project "$SQUASHER_PROJECT_ID" --provider cloudflare

What you see	What to do
Freshness is `paused`	The analytics pull is off. Turn it on.
Freshness is `stale`	No pull has succeeded for 20 minutes. Read the last error in `squasher integrations health`.
Error class `permission` or `auth`	The connection is missing the analytics permissions. Connect Cloudflare again to grant them.

Get started

Guides

Cloudflare analytics metrics

Prerequisites

Turn on the analytics pull

Metrics

Check the pull

Next steps

Cloudflare Workers

Provider connections

​Prerequisites

​Turn on the analytics pull

​Metrics

​Check the pull

​Next steps

Cloudflare Workers

Provider connections

Prerequisites

Turn on the analytics pull

Metrics

Check the pull

Next steps