Overview

Custom Costs allow you to upload any cost data source to Datadog, so that you can understand the total cost of your services.

Custom Costs accepts costs in pre-defined file structures (CSV or JSON). These files are aligned with the FinOps FOCUS specification, and you can upload multiple files in either format. For example, you can upload a mix of CSV or JSON files as desired with 1+ line items (rows for CSV or objects for JSON).

All line items must meet the following requirements and include the properties below:

• All column names (CSV), property names (JSON), and values are UTF-8 encoded.
• All required column names (CSV) or property names (JSON) are PascalCased. For example, you must use "ProviderName", not "providername" or "ProviderNAME".
• All column names (CSV) and values or property names (JSON) and values have a maximum of 1,000 characters.
• NULL or blank ("") parameter values are not accepted.

Additionally, all dates are transformed into UTC timestamps. For example, “2024-01-01” becomes “2024-01-01 00:00:00”.

Setup

To use Custom Costs in Datadog, you must configure Cloud Cost Management for either AWS, Azure, or Google Cloud.

Collect the required fields

Create a CSV or JSON file with required fields

You can upload multiple CSV and JSON files, in either or both formats. Ensure that you don’t upload the same file twice, since the cost will appear as doubled in the product.

[
    {
        "ProviderName": "Zoom",
        "ChargeDescription": "Video Usage",
        "ChargePeriodStart": "2023-01-01",
        "ChargePeriodEnd": "2023-12-31",
        "BilledCost": 100.00,
        "BillingCurrency": "USD"
    }
]

[
    {
        "providername": "Zoom",
        "chargedescription": "Video Usage",
        "chargeperiodstart": "2023-01-01",
        "chargeperiodend": "2023-12-31",
        "billedcost": 100.00,
        "billingcurrency": "USD"
    }
]

Add optional tags

You can optionally add any number of tags to CSV or JSON files to allocate costs after the required fields as additional columns.

[
    {
        "ProviderName": "Zoom",
        "ChargeDescription": "Video Usage",
        "ChargePeriodStart": "2023-01-01",
        "ChargePeriodEnd": "2023-12-31",
        "BilledCost": 100.00,
        "BillingCurrency": "USD",
        "Tags": {
            "team": "web",
            "service": "ops"
        }
    }
]

Configure Custom Costs

After your data is formatted to the requirements above, upload your CSV and JSON files to Cloud Cost Management on the Custom Costs Files page or programmatically by using the API.

In Datadog:

1. Navigate to Cloud Cost > Settings > Custom Costs.

2. Click the + Upload Costs button.

To send a file programmatically, use the PUT api/v2/cost/custom_costs API endpoint.

For example, using cURL:

curl -L -X PUT "api.datadoghq.com/api/v2/cost/custom_costs" \
-H "Content-Type: multipart/form-data" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-F "file=${file};type=text/json"

To send the content of the file programmatically, use the PUT api/v2/cost/custom_costs endpoint.

For example, using cURL:

curl -L -X PUT "api.datadoghq.com/api/v2/cost/custom_costs" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d '${file_content}'

Cost data appears in Datadog after 24 hours.

Cost metric types

You can visualize your ingested data using the following cost types:

All costs submitted to Custom Costs appear in these metrics. For example, if a $4 purchase was made on September 1, over the September 1-4 period, the following costs are attributed to each metric:

Use Custom Costs data

You can view custom costs data on the Cloud Cost Explorer page, the Cloud Cost Tag Explorer, and in dashboards, notebooks, or monitors. You can also combine Custom Cost metrics with other cloud cost metrics or observability metrics.

Further reading

Documentation, liens et articles supplémentaires utiles:

Cloud Cost ManagementDOCUMENTATION Gain insights into your AWS billDOCUMENTATION Gain insights into your Azure billDOCUMENTATION Gain insights into your Google Cloud billDOCUMENTATION