Skip to main content

Fastly Cost Exports with nOps Platform

To integrate Fastly with Inform, follow these steps:

  1. Create an API Token in Fastly
  2. Set Up Integration in nOps Platform
  3. Verify Integration

Prerequisites​

Before setting up the integration, ensure you have:

  1. Fastly Account

    • Active Fastly account with API access
    • Permissions to create and manage API tokens

  2. Required Information

    • Fastly API token with global:read scope (required for read access to account information and billing data)
    • Understanding of which Fastly services you want to track

Accessing Inform Integrations​

To begin, navigate to the Organization Settings and click on Integrations. From there, select Inform to proceed with setting up your Fastly integration.

Below is an example of the integrations page:
Inform Integrations Interface

This page provides access to configure and manage integrations with your Inform tools.

The list of integrations will indicate whether there are any active integrations or if the tools are not yet integrated. Active integrations will be marked accordingly, allowing you to easily identify the current status of each integration.

How the Integration Works​

  1. API Token Creation

    • Create an API token in the Fastly console with read-only access for usage and billing
    • Securely store and provide this token to nOps during integration setup

  2. Integration Setup

    • Configure the Fastly API Token in nOps
    note

    Make sure to keep your API token secure and never share it with unauthorized users.

  3. Data Retrieval by nOps

    • nOps uses the provided API token to fetch usage and billing data from Fastly
    • Data is collected for invoices, service metadata, and usage statistics associated with your Fastly account

  4. Data Processing

    • The retrieved data is processed and displayed within the Inform product
    • Cost information is organized by service, time period, and usage metrics

Step 1: Create an API Token in Fastly​

API tokens are required for secure access to your Fastly usage and billing data.

  1. Access API Token Settings

    • Log in to your Fastly account at https://manage.fastly.com/
    • Navigate to Account → Personal API tokens (or Account → API tokens)
    • Click on Create Token

  2. Configure API Token

    Fill in the following token details:

    • Name: Enter a descriptive identifier, such as nOps-Cost-Integration or nOps-Billing-Access

    • Type: Select Automation token (if this option is available in your Fastly console)

    • Role: If prompted to select a role, choose Billing to limit access to cost-related data

    • Scope: Select Read-only access (global:read) — This grants read access to account information, configuration, and statistics

    • Access: Choose All Services for your organization to ensure complete cost visibility

    • Expiration: You may select Never expire for convenience, or set an expiration date according to your organization's security policy

      • If you set an expiration, remember to update the token in nOps before it expires
    important

    Required Scope: The API token must have the global:read scope. Without this scope, nOps will not be able to retrieve your Fastly billing and usage data. For security reasons, consider implementing a regular token rotation schedule even if you choose "Never expire."

  3. Save API Token

    • Copy the generated API token
    • Store it securely—tokens are typically shown only once

Step 2: Set Up Integration in nOps​

  1. Access the Inform Integrations page to begin.
  2. Select the Fastly integration card.
  3. Click on the +Add Fastly Integration button

Configuration Parameters​

  1. Enter Fastly API Token

    • Paste the API token you copied from the Fastly console
    • The token MUST have global:read scope for the integration to work

  2. Click Save to finish

Step 3: Verify Integration​

After setting up the integration, you should see it listed in your active integrations.

  1. Check Integration Status

    • The integration will appear in the Fastly section
    • Status will show as "Integrated" when healthy
    • If there are errors, the status will show "Action Required" with an inline error message

  2. Wait for Data Synchronization

    • It may take up to 24 hours for the initial data to appear
    • After synchronization, you can access your Fastly cost data in the Explorer section

  3. Access Cost Data

    • Navigate to the Explorer tool
    • Look for Fastly as a service provider in your cost breakdowns
    • Filter and analyze costs by service, time period, and usage metrics

Troubleshooting​

  1. API Token Issues

    • Verify the API token has not expired (if you set an expiration date)
    • Ensure the token has the required global:read scope — this is mandatory for read permissions
    • Check for typos in the API token
    • Confirm the token is still active in the Fastly console

  2. Data Not Appearing

    • Allow up to 24 hours after setup for initial data sync
    • Confirm there is actual billing activity in your Fastly account
    • Verify the API token is still active in Fastly
    • Check for inline error messages in the integration row

  3. Action Required Status

    • Expand the Fastly section to view the integration status
    • Look for inline error messages on the integration row
    • Common issues include expired tokens, insufficient permissions, or revoked access

  4. Incomplete Data

    • Ensure the API token has access to all relevant Fastly services
    • Verify your Fastly account has recent invoices and usage data
    • Check if there are any API rate limits affecting data retrieval

For support, contact nOps with details about the error messages you've encountered (do not share the actual API token).