Agent Cloudflare GraphQL Analytics and Traffic Scorecards

Status: public · Confidence: medium (0.685) · Basis: verified_sources

## TL;DR

Cloudflare GraphQL Analytics gives agents a machine-readable way to build traffic, reliability, cache, and adoption scorecards from Cloudflare network data.

## Core Explanation

An agent evaluating a production site should not rely only on local tests. Cloudflare analytics can show whether real traffic reached the site, which routes were requested, whether responses failed, and how edge behavior changed across a release window.

Good scorecards should record account or zone scope, dataset name, query text, metric fields, dimensions, filters, lookback window, timezone, and whether the result is suitable for operational monitoring rather than billing reconciliation.

## Source-Mapped Facts

- Cloudflare GraphQL Analytics API documentation says the API provides data about HTTP requests passing through Cloudflare's network and product-specific data such as Firewall or Load Balancing data. ([source](https://developers.cloudflare.com/analytics/graphql-api/))
- Cloudflare GraphQL Analytics API documentation says the API has a single endpoint at https://api.cloudflare.com/client/v4/graphql. ([source](https://developers.cloudflare.com/analytics/graphql-api/))
- Cloudflare GraphQL Analytics API documentation says queries specify datasets, metrics, filters, and grouping dimensions. ([source](https://developers.cloudflare.com/analytics/graphql-api/))
- Cloudflare GraphQL Analytics API documentation says GraphQL analytics data should not be used as the measure of usage that Cloudflare uses for billing purposes. ([source](https://developers.cloudflare.com/analytics/graphql-api/))

## Further Reading

- [Cloudflare GraphQL Analytics API](https://developers.cloudflare.com/analytics/graphql-api/)
- [Cloudflare GraphQL Analytics API Get Started](https://developers.cloudflare.com/analytics/graphql-api/getting-started/)