Today, Vantage is announcing support for CircleCI costs in the Vantage console, allowing customers to track their CI/CD spend alongside their cloud infrastructure and SaaS providers in a single place. Customers can connect their CircleCI account from the Integrations page, and Vantage will automatically ingest and visualize CircleCI cost and usage data.

Customers use CircleCI to build, test, and ship software quickly, but understanding how CI/CD spend maps to teams, projects, and engineering workflows can be difficult. Teams previously relied on the CircleCI Usage dashboard for visibility into costs, and would use exports to manually upload costs to Vantage via Custom Providers in order to view them alongside other providers. This manual process made it difficult to align changes in CircleCI costs to changes in other correlating infrastructure, or include CircleCI costs in all-in cost allocations.

Now, with the launch of CircleCI cost support in Vantage, customers can grant Vantage access to their CircleCI organization by creating a Personal API key in the CircleCI console, and Vantage will automatically ingest their costs to display alongside their other infrastructure costs. This key allows Vantage to retrieve detailed usage data for each CircleCI job, including credit consumption breakdown by usage type and resource class. Customers can use these attributes to allocate costs to teams through Virtual Tags, detect anomalies in CircleCI usage, and analyze CircleCI consumption.

The CircleCI integration is now available to all Vantage customers. To connect, go to the Integrations page in account settings and select CircleCI. You can learn more via the new CircleCI section in Vantage’s documentation.

Frequently Asked Questions

1. What is being launched today?

Vantage is launching native support for CircleCI cost data. Customers can connect their CircleCI organization to Vantage and automatically ingest CircleCI usage-based costs for analysis alongside other providers.

2. Who is the customer?

The CircleCI integration is available to all Vantage customers, across all subscription tiers.

3. How much does this cost?

There is no additional fee for using the CircleCI integration. However, CircleCI costs will be included in quota tier enforcement. In the event that your CircleCI costs push you over your current tier limit, you may be prompted to upgrade. To see more details on pricing, please refer to the Pricing page.

4. How does Vantage technically integrate with CircleCI?

Vantage uses the createUsageReport API from CircleCI to pull your usage data through Personal API Keys. After authorizing Vantage access to your CircleCI account, Vantage will begin ingesting data from the createUsageReport API, which provides structured usage data for CircleCI jobs in credits. Vantage collects your price per credit in order to convert this from credits to currency.

5. What permissions does Vantage have in my CircleCI account?

CircleCI does not have any scoping of Personal API Keys. This key includes additional permissions beyond what Vantage uses; however, Vantage only reads data from the createUsageReport API endpoint related to usage, and will never perform any other actions.

Unfortunately, CircleCI does not currently support fine-grained permissions for Personal API Keys. We recommend customers submit a feature request to CircleCI for improved permission scoping, and Vantage will adopt fine-grained permissions if this becomes available.

6. What permissions are required in CircleCI in order to create the integration?

You also need to be an Org Admin to generate a Personal API Key compatible with the createUsageReport API. It’s best practice to use a dedicated key for Vantage and rotate it per your security policy.

7. What permissions are needed within Vantage?

You must have a Vantage Owner or Integration Owner role to add or remove the CircleCI integration.

8. What dimensions can CircleCI costs be filtered and grouped by?

CircleCI reports can support aggregating and filtering on the following dimensions:

• Billing Account (Organization Name)
• Account (Project Name)
• Service (e.g. Compute, Storage, Users, Network)
• Category (e.g. Linux Docker)
• Subcategory (e.g. small, medium, large)
• Resource (Job Name)
• Charge Type (Usage)
• Organization ID (available as a tag circleci:organization_id)
• Project ID (available as a tag circleci:project_id)
• VCS Name (available as a tag circleci:vcs_name)
• VCS URL (available as a tag circleci:vcs_url)
• VCS Branch (available as a tag circleci:vcs_branch)
• Pipeline ID (available as a tag circleci:pipeline_id)
• Job Build Status (available as a tag circleci:job_build_status)

9. Are tags from CircleCI available?

No, tags are not available from CircleCI; however, granular constructs, such as Job Name, VCS Name, VCS URL, VCS Branch, and Pipeline ID are available to isolate specific usage.

10. Can I view usage data for CircleCI?

Yes, usage data is available for CircleCI in credits consumed for services such as Compute, Storage, Users, and Network.

11. Are there Active Resources for CircleCI?

No, CircleCI jobs are not currently supported as Active Resources in Vantage.

12. How often does CircleCI data refresh in the Vantage console?

CircleCI data refreshes daily in the Vantage console.

13. What happens if I remove a CircleCI integration?

If you remove the integration, all CircleCI costs associated with that account will be removed from the Vantage console.

14. How far back will the data go?

Vantage imports up to six months of historical CircleCI cost data upon initial connection. Ongoing retention follows your Vantage data retention settings.

15. Can I connect multiple CircleCI accounts?

Yes. Customers can connect multiple CircleCI accounts by providing separate API keys for each. Each account will be tracked independently within Vantage.