Cloudflare GraphQL Analytics: A Field-Discovery Cookbook When Introspection Is Locked

Calendar May 20, 2026
Observability
Intermediate
Cloudflare-Analytics-Querying, Graphql-Schema-Discovery, Production-Observability
Cloudflare, Graphql, Analytics, Observability, Introspection, Api-Discovery, Debugging
Cloudflare, Graphql, Curl, Wrangler

Cloudflare GraphQL Analytics: A Field-Discovery Cookbook When Introspection Is Locked#

Cloudflare’s GraphQL Analytics API at https://api.cloudflare.com/client/v4/graphql is the richest source of metrics about your CF account — Workers invocations, D1 reads/writes, KV ops, Workers AI neurons, Vectorize queries. The dashboard’s charts are powered by it. The CLI is not: wrangler exposes a fraction of what GraphQL does.

But the schema is hostile to discovery:

  • __type(name: "WorkersInvocationsAdaptive") returns null for almost every node.
  • The official schema docs at developers.cloudflare.com/analytics/graphql-api are partial and stale by months.
  • Nodes like vectorizeQueriesAdaptiveGroups exist, but their sum/dimensions field names are nowhere on the public internet.

You can still derive the schema. The trick is deliberate-error probing: send a query with a guessed field name; the error message tells you whether the parent node exists. This page is the recipe.