Docs Home → View & Analyze Data → Atlas Charts
Create and Manage Billing Dashboards
On this page
You can visualize your Atlas billing data in Atlas Charts by creating a billing dashboard. Billing dashboards are dashboards with prebuilt charts that help you monitor your Atlas usage. After you ingest your billing data, you can add a billing dashboard and customize it to suit your specific billing needs.
To learn more about how Atlas bills your deployments, see Manage Billing.
Billing Dashboards
Billing dashboards provide metrics and detailed charts about the usage in your organization across different categories and periods of time. The insights from your dashboard can help you optimize your Atlas spending.
By default, billing dashboards include the following metrics and charts:
Total spending across your organization
Biggest spenders in your organization
Total spending by instance size, project, cluster, product category, or SKU
Total cost by product category
Required Access
To create a billing dashboard, you must have at least
Project Data Access Read/Write
permissions.
Limitations
At any given time, billing dashboards use the last twelve months of your organization's billing data.
If you change an existing invoice, Atlas updates the billing data in your ingestion only if you've incurred the invoice within the last three months. Any invoice changes reflect in your dashboard after the next scheduled ingestion.
Create a Billing Dashboard
To ingest your billing data and add a billing dashboard:
Configure the Atlas Billing Ingestion.
Enter your Organization public API key and Organization private API key.
Your key pair must have at least
Organization Billing Admin
andOrganization Billing Viewer
access.To learn how to create and view an API key for your organization, see Grant Programmatic Access to Atlas.
From the dropdown, select the Target deployment to store your billing data.
(Optional) Change the Database name.
Click Save.
Charts uses the Invoices API to ingest the last twelve months of your organization's billing data into the specified deployment and database. After you create the initial ingestion, Atlas ingests billing data daily.
In the Atlas Billing card, click Add and Open.
Charts generates the billing dashboard and saves it to the Dashboards page. All dashboard and chart features, such as dashboard filters and interactive filtering, apply to billing dashboards and its prebuilt charts.
To learn more about filtering billing dashboards, see Apply Dashboard Filters.
Apply Dashboard Filters
You can use dashboard filters to refine the charts across your billing dashboard. By default, billing dashboards include filters on the following fields from your billing data:
name
cluster
category
sku
To view active filters, click the filter icon in the top-right corner of your dashboard to expand the Dashboard Filters pane.
In the Dashboard Filters pane, you can manage your active filters or click Edit to add and apply new filters. When you apply a filter, the charts in your dashboard update to display only data that matches the field values that you filtered on.
To learn more, see The Dashboard Filters Pane.
Example
Consider a sample billing dashboard that uses the following filters:
A filter on the
category
field to include only invoices related to the Charts and Private Endpoint categories.A filter on the
date
field to include only invoices incurred within the past 6 months.
Once the filters are applied, the charts in the billing dashboard highlight only the values specified in these filters. For example:
Manage Atlas Billing Ingestions
Edit an Ingestion
To edit an existing billing ingestion:
Delete an Ingestion
To delete an existing billing ingestion: