Skip to main content

Connect Cloudflare

Cloudflare is a global cloud platform providing CDN, security, and edge computing services. The Cloudflare integration imports your usage and subscription billing data into DoiT Cloud Intelligence so you can analyze Cloudflare costs in Cloud Analytics.

Prerequisites

  • A Cloudflare account with access to billing data.

  • A DoiT account with the Billing Profiles Admin permission.

Required credentials

FieldDescriptionWhere to find it
Account IDYour Cloudflare account identifierCloudflare dashboard > Overview > Account ID (right sidebar)
API TokenAPI token with Billing:Read permissionCloudflare dashboard > Create Token

Create an API token

  1. Sign in to the Cloudflare dashboard.

  2. Navigate to your profile > API Tokens.

  3. Select Create Token.

  4. Under permissions, add Billing with Read access.

  5. Select Continue to summary, then Create Token.

  6. Copy the token.

    Caution

    The token is only shown once. Make sure to copy it before closing the page.

Connect your Cloudflare account

  1. Sign in to Cloud Intelligence, select Data ingestion and integrations > Integrations from the top navigation mega menu.

  2. Search for Cloudflare in the integrations catalog.

  3. Select Connect + on the integration card.

  4. Enter your Account ID and API Token.

  5. Select Test connection to verify DoiT can access your Cloudflare billing data.

  6. If the test is successful, select Save to complete the setup.

    If the test fails or you need further assistance, please open an expert inquiry.

Note

Upon initial connection, DoiT ingests the usage data Cloudflare makes available, which covers roughly the last two billing cycles. Earlier history cannot be imported, because Cloudflare's billable usage API does not serve it. The import process can take a few hours. You'll receive an email when the data is available in Cloud Analytics.

Data refresh

DoiT refreshes your Cloudflare billing data every six hours. Data typically becomes available within 48 hours of being generated by Cloudflare.

Connection status

After the first sync completes, each connection displays a status on the integrations page. Hover over the status to see additional details.

StatusColorMeaning
SuccessGreenThe sync completed and billing data is available in Cloud Analytics.
No dataAmberThe sync completed, but no usage data is available. See No data.
Auth errorAmberThe API token is missing a required permission. See Auth error.
FailedRedThe sync encountered an unexpected error.

No data

An amber No data status appears when a sync succeeds but no usage data is available, for example, an Enterprise contract account. Cloudflare's billable usage API does not serve usage data for these accounts.

No action is required for Enterprise contract accounts. The status reflects a provider-side limitation, not a configuration problem.

Auth error

An amber Auth error status indicates that the API token is missing a required permission, usually Billing with Read access.

To resolve the error:

  1. Create a new API token with Billing > Read permission.

  2. On the integrations page, select Manage on the Cloudflare card.

  3. Update the API Token field with the new token and save.

Reporting dimensions

Once connected, Cloudflare data maps to the following standard Cloud Analytics dimensions:

Cloud Analytics dimensionCloudflare valueExample
ProviderCloudflareCloudflare
Billing AccountAccount ID023e105f4ecef8ad9ca31a8372d0c353
Project/Account IDZone name or account-levelexample.com
ServiceService nameRegular Twitch Neurons (RTN), Cloudflare Subscription
SKUCharge descriptionArgo Accelerated Gigabytes usage measured in Gigabytes, Pro Plan

In addition to standard dimensions, the following Cloudflare-specific labels are available:

LabelDescription
ServiceCloudflare service name (e.g., Log Explorer, Regular Twitch Neurons (RTN))
Service FamilyService family grouping (e.g., Workers AI, Durable Objects)
ZoneThe Cloudflare zone (domain) associated with the charge
UnitUnit of consumption (usage charges only, e.g., Gigabytes, Count). Maps to the Cloudflare consumed_unit field.
AI ProductWhether the charge is for a Cloudflare AI product such as Workers AI or Vectorize (true or false)
PlanRate plan name (subscription charges only)
Subscription StateSubscription status (subscription charges only)
Billing FrequencyBilling frequency (subscription charges only)
Contract AccountWhether the account is on an Enterprise contract (subscription charges only)
Note

Cloudflare AI costs (Workers AI and Vectorize) are filterable in Cloud Analytics using the AI Product label. Once the integration is active, Workers AI and Vectorize spend also appears in the GenAI Intelligence dashboard alongside other supported GenAI providers.

Enterprise accounts

Cloudflare's billable usage API is not available for Enterprise contract accounts. The connection displays an amber No data status to indicate this limitation.

Delete your Cloudflare connection

  1. Sign in to Cloud Intelligence, select Data ingestion and integrations > Integrations from the top navigation mega menu.

  2. Search for Cloudflare in the integrations catalog.

  3. Select Manage on the integration card.

  4. Select the kebab menu () at the rightmost end of the account you want to remove and select Delete.

  5. Select Delete to confirm.