Skip to main content
A unit is any metric that your business tracks, such as users, requests, transactions, customers, vendors, and so on. Unit costs can help you analyze the cost of goods sold (COGS). You can add unit costs as a visualization on Cost Reports to visualize your cloud infrastructure costs on a per unit basis. Business metrics are the units of data from your business that are aggregated and combined with costs to produce per unit costs on Cost Reports. By importing these business metrics into Vantage, you can track unit costs, like cost per daily active user, COGS per customer, cost per million API requests, etc. In the visual example below, the business metric Per Requests per Second is visualized in the graph as a red line alongside daily costs. You can use this visualization to understand how changes in the request metric contribute to changes in your costs.
Per Unit Costs displayed as a trend line on the graph in a Cost Report

​
Labeled Business Metrics

You can optionally include a label for each uploaded metric. The label identifies the source of the metric—like an associated application or cost center. For example, a metric like Monthly Active Users typically applies to more than one application. The ability to allocate these metrics is important for analyzing both overall user activity and individual application performance, enabling more informed decision-making at the application level. In the above example, you can create labels like Active Users App A, Active Users App B, etc. When you assign this metric to a Cost Report, you can decide which labels to include on the Cost Report and in the per unit cost calculation. Any labels you decide to include will be aggregated in the per unit cost calculation. So, in this example, if you decide to include only data with the Active Users App A label, then unit costs will be calculated only for that set of data. If you also include Active Users App B, then the per unit cost calculation will aggregate both sets of labeled data.

​
Import Business Metrics

To get started with business metrics and unit costs, you can also view a video demo on Vantage University .
Business metrics can be imported from other systems directly into Vantage and analyzed alongside cost data. You can create automatic import integrations with Amazon CloudWatch, manually import these metrics from a CSV file, or automatically upload metrics via the Vantage API.
The following steps are for importing via CloudWatch or a CSV file. If you want to automatically import metrics, see Import via the Vantage API.
1
From the top navigation, click Financial Planning.
2
On the left navigation, click Business Metrics. All existing business metrics are displayed. You can edit or delete business metrics from this screen.
3
From the top right of the screen, click New Business Metric.
4
Enter a business metric Title and click Create Business Metric.
5
The Business Metrics screen is displayed with three tabs:
  • Metric Overview: Displays basic metric information (name, import type, integration details) and allows you to assign the metric to Cost Reports. See the Assign Business Metrics to Cost Reports section for details.
  • Imported Metrics: Import historical business metrics from a CSV file, Amazon CloudWatch, Datadog, or upload via the Vantage API. This tab stores your historical metric data and is used for calculating unit costs on Cost Reports. While you can upload any dates (past, present, or future) to this tab, only dates up to the current cost buffer date are used for unit cost calculations. Future dates uploaded here are stored and will automatically appear on Cost Reports once that date becomes current (passes the cost buffer). Only data uploaded to the Forecasted Metrics tab will be used for Dynamic Forecasting.
  • Forecasted Metrics: Upload future projections of your business metrics to create Dynamic Forecasts. Only data uploaded to this tab will be used for Dynamic Forecasting. This tab accepts CSV uploads only (CloudWatch and Datadog integrations are not available for forecasted metrics). See the Forecasted Metrics section for details.

​
Import from a CSV File

You can upload a CSV file that uses the following three-column format. This CSV file can replace existing data or be used to import new data. The date column must be in YYYY-MM-DD format. The amount column must be a number. The label column is optional. See the section above for more information about labels.
A label can be added once per date.
date,amount,label
2024-01-09,295,app1
2024-01-16,909,app1
2024-01-23,934,app1
2024-01-30,772,app1
2024-01-09,344,app2
2024-01-16,789,app2
2024-01-23,922,app2
2024-01-30,768,app2
...
Click the Imported Metrics tab, then click Upload a CSV. Select the CSV file and upload. After the file is imported, a dropdown menu for each month is displayed. For months with imported metrics, the date and associated metric number are displayed. Months with no metrics are blank.
The Imported Costs section with costs displayed for a month
To add additional metrics or change the value of a metric, update your source CSV file. Then, click Edit and upload the edited file. The new or updated metric is displayed in the table. See the Assign Business Metrics to Cost Reports section for the next steps.

​
Import from Amazon CloudWatch

To import business metrics from Amazon CloudWatch, you need a specific metric name and AWS account, as described below. Ensure AWS is one of your connected providers
If Vantage does not have a Cross-Account IAM Role associated with your AWS account, you need to create one. See the AWS integration documentation for details.
1
Click the Imported Metrics tab, then click Import via CloudWatch.
2
For AWS Account, select the connected AWS account you want to import metrics from.
3
Select an AWS Region.
4
Enter a Namespace. A complete list of available namespaces can be found in the AWS documentation for AWS services that publish CloudWatch Metrics. Namespaces start with AWS/ followed by the service name (e.g., AWS/EC2).
5
Enter a Metric name. Each AWS service has metrics that it sends to CloudWatch. Available metrics can be found in CloudWatch or the AWS documentation.
The AWS documentation includes a list of available metrics for services. For example, you can view EC2 instance metrics. An example metric to track in this instance is CPUUtilization. For Amazon RDS, an example metric to track is WriteIOPS or ReadIOPS.
6
For Dimensions, enter a Name and Value. Dimensions are used to pull specific statistical data for a metric. For example, enter InstanceId with a value of i-1234567890abcdef0. Each CloudWatch metric has a set of dimensions you can select. Click + Add a Dimension to add more than one dimension.
7
For each import, you must specify the Aggregation function to be used because metrics will be aggregated to the day. Select either Sum, Average, Maximum, or Minimum.
8
Optionally, enter a dimension name for the Label Dimension field.
9
Click Import Data.
The CloudWatch metrics import screen with data added to each field
The metrics will be automatically synced, daily, along with cost data from other integrations. See the Assign Business Metrics to Cost Reports section for the next steps.

​
Import from Datadog

To import business metrics from Datadog, ensure Datadog is one of your connected providers. If you do not have Datadog as one of your connected providers, you will be prompted to connect your Datadog account the first time you try to create a metric.
1
Click the Imported Metrics tab, then click Import via Datadog.
2
For Account, select the connected Datadog account for which you want to import metrics. If this is your first Datadog metric, you may be prompted to reauthorize your Datadog credentials and the required scopes for Vantage (i.e., billing_read, usage_read, metrics_read, and timeseries_query scopes).
3
For Raw Query, enter your Datadog metric, including aggregation, rollup formula, and label filters, into the text field. Your syntax should be similar to the following example:
aws.applicationelb.request_count{availabilityzone:us-east-1c, region:us-east-1}
The minimum aggregation for business metrics is daily. If you enter a lower granularity than daily, Vantage will perform aggregation at the daily level. For more information on the Datadog filtering syntax, see the Datadog documentation.
4
Click Import Data.
The Datadog metrics import screen with data added to each field
The metrics will be automatically synced, daily, along with cost data from other integrations. See the Assign Business Metrics to Cost Reports section for the next steps.

​
Import via the Vantage API

You can import business metrics to Vantage, from other applications, with the Vantage API. Use the /business_metrics endpoint to view, create, update, and delete business metrics. Ensure you have a valid Read/Write Vantage API token. See the API documentation for details on how to use this endpoint.

​
Assign Business Metrics to Cost Reports

Assign metric to cost report
Once your import is complete you can assign metrics to one or more Cost Reports. You can also assign as many different business metrics to a Cost Report as you want.
1
Under Assigned Cost Reports, click Assign a Report.
2
The Assign a Report popup window is displayed. In the Report dropdown menu, search for and select a Cost Report.
3
For Unit Scale, select either Per Unit, Per Hundred, Per Thousand, Per Million, or Per Billion. The scale is used to divide the business metric before calculating the cost per unit. Use this scale to create a per-unit cost, such as Cost per Thousand Requests. If you select Per Unit, no division occurs, and the actual metric number will be used within the Cost Report.
4
For Label Filter, select any labels that were imported with your data.
  • Any selected labels will be aggregated and applied to the Cost Report to calculate the per unit costs. For example, if you select the labels app1 and app2, the per unit cost calculation will be an aggregate of the corresponding values for those labels. If you select only app1, then the per unit cost calculation will only apply to values that correspond with the app1 label.
  • You can also select the unlabeled option, which includes any values that don’t have a corresponding label.
5
Click Save. The metric is displayed on the corresponding Cost Report based on the selected scale and optionally selected labels.

​
Forecasted Metrics

Dynamic forecasting is available to Enterprise customers only.
You can upload projected future values of your business metrics to create Dynamic Forecasts that align your cost projections with business growth expectations. When you upload forecasted business metrics, Vantage analyzes historical correlations between your costs and metrics, then incorporates your projections into forecasting models. You can create one forecast per business metric. To model different scenarios, update your existing forecast with new projected values, and all associated Cost Reports will reflect the updated projections.
1

Create a business metric

Follow the steps in the Import Business Metrics section above if you haven’t created a business metric yet.
2

Upload forecasted metrics

Once you’ve uploaded historical costs, select the Forecasted Metrics tab.Only data uploaded to the Forecasted Metrics tab will be used for Dynamic Forecasting. Upload either a CSV file with your projected metrics, or use the Vantage API. Use the same CSV format as historical data, optionally including labels, for example:
date,amount,label
2026-11-01,5000,app1
2026-11-02,5200,app1
2026-11-03,5400,app1
2026-11-01,3000,app2
2026-11-02,3100,app2
2026-11-03,3200,app2
You cannot upload forecasted metrics through the native Datadog or CloudWatch business metrics integrations. Forecasted metrics must be uploaded manually via CSV or API.
3

Assign to a Cost Report

Assign the business metric to a Cost Report if you haven’t already. See the Assign Business Metrics to Cost Reports section for details.
4

View and manage your forecast

Review the Forecasting documentation to learn how to view your Dynamic Forecast on Cost Reports and compare forecast types.

​
View Per Unit Costs on Cost Reports

Per Unit Costs displayed on a Cost Report
To inspect your unit costs, navigate to the assigned Cost Report. The average unit cost for the date range selected is displayed at the top of the screen. This average is calculated by first binning business metrics according to the selected date bucket (day, week, or month), then dividing the total costs by the total binned business metrics for date bins where both costs and metrics are available. This ensures accurate results that respect the date bucket size used by the report.
To see the cost per unit line, ensure your view is set to daily, weekly, or monthly.
Hover over a data point to see the cost per unit for that day, week, or month. If you add multiple business metrics to the same Cost Report, each business metric is displayed as a separate line, as shown in the example above.