Skip to main content

Fastly Account Onboarding Guide

Connect your Fastly account to CloudYali for CDN cost tracking, service-level cost breakdowns, and regional usage analytics.

Quick Start

You'll need a Fastly Automation token with Global:Read scope and the Billing role. The entire setup takes about 5 minutes.

Prerequisites​

  • A Fastly account with access to billing data
  • Permission to create API tokens in your Fastly account

Step 1: Create a Fastly API Token​

We recommend creating an Automation token rather than a Personal API token. Automation tokens are not tied to a specific user, so the integration won't break if a team member leaves your organization.

  1. Log in to the Fastly management console
  2. Navigate to Account → API tokens
  3. Click Create Token
  4. Configure the token:
    • Name: Enter a descriptive name (e.g., "CloudYali Integration")
    • Type: Select Automation
    • Role: Assign the Billing role
    • Scope: Select Read-only access (global:read)
    • Access: Select All Services
    • Expiration: Select Never expire
  5. Click Create Token and copy the generated token
caution

Save your API token immediately — Fastly only shows it once. If you lose it, you'll need to create a new one.

Step 2: Connect to CloudYali​

  1. Log in to CloudYali
  2. Navigate to Settings → Integrations
  3. Locate the Fastly integration card and click + Connect Fastly
  4. Enter:
    • Account Name: A friendly label for this account (e.g., "Production CDN")
    • API Token: Paste the token from Step 1
  5. Click Connect Account

CloudYali validates your token against the Fastly Billing API before saving. If validation fails, verify your token has the correct scope and role.

Step 3: Wait for Data Sync​

Once connected, CloudYali automatically syncs your billing data:

  • Initial sync: Imports the last 3 months of billing history
  • Ongoing sync: New billing data syncs automatically on a daily schedule
  • Data availability: Cost data typically appears within 15 minutes of connecting

What Data Does CloudYali Collect?​

CloudYali accesses your Fastly billing invoices to provide:

  • Cost breakdowns by product (CDN, Compute, etc.), category, and region
  • Service-level costs showing spend per Fastly service
  • Usage metrics including bandwidth, requests, and compute usage
  • Daily and monthly trends for cost tracking and anomaly detection
  • Service inventory tracking your active Fastly services
Data Privacy

CloudYali only accesses billing and service metadata through the Fastly API. No traffic data, logs, or configuration details are accessed.

Managing Your Fastly Account​

Viewing Connected Accounts​

Navigate to Settings → Integrations to see all connected Fastly accounts, including sync status and last sync time.

Removing an Account​

  1. Go to Settings → Integrations
  2. Find the Fastly account you want to remove
  3. Click Remove Account

Removing an account deletes the stored API token from AWS Secrets Manager and stops future syncs. Historical billing data is retained.

Troubleshooting​

Token Validation Failed​

  • Verify the token has Global:Read scope and Billing role
  • Ensure the token hasn't been revoked or expired
  • Try creating a new token if the issue persists

No Cost Data Appearing​

  • Wait at least 15 minutes after connecting for the initial sync
  • Check sync status in Settings → Integrations
  • Ensure your Fastly account has billing history (new accounts may not have invoice data yet)

Stale or Missing Data​

  • Fastly finalizes invoices at the end of each billing period. Month-to-date data updates daily and may differ from the final invoice
  • Use the Trigger Sync option in account settings to request a manual data refresh

Next Steps​

Once your Fastly account is connected:

For additional help, contact our support team at support@cloudyali.io.

Last updated on