Skip to content

[DOCS-11441] Add budgets to CCM reports and dashboards #30497

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Jul 17, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/en/cloud_cost_management/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,7 +100,7 @@ Proactively manage and optimize your cloud spending by creating a [Cloud Cost Mo

## Allocate costs

Use [Container Cost Allocation metrics][4] to discover costs associated with clusters and workloads across Kubernetes, AWS ECS, Azure, and Google Cloud. Gain visibility into pod-level costs, identify idle resource costs, and analyze costs by resource type.
Use [Container Cost Allocation metrics][4] to discover costs associated with clusters and workloads across Kubernetes, Amazon ECS, Azure, and Google Cloud. Gain visibility into pod-level costs, identify idle resource costs, and analyze costs by resource type.

## Permissions
Two permissions are available:
Expand Down
10 changes: 5 additions & 5 deletions content/en/cloud_cost_management/container_cost_allocation.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ CCM displays costs for resources including CPU, memory, and more depending on th
{{< tabs >}}
{{% tab "AWS" %}}

CCM allocates costs of AWS ECS clusters as well as all Kubernetes clusters, including those managed through Elastic Kubernetes Service (EKS).
CCM allocates costs of Amazon ECS clusters as well as all Kubernetes clusters, including those managed through Elastic Kubernetes Service (EKS).

The following table presents the list of collected features and the minimal Agent and Cluster Agent versions for each.

Expand All @@ -42,7 +42,7 @@ The following table presents the list of collected features and the minimal Agen

1. Configure the AWS Cloud Cost Management integration on the [Cloud Cost Setup page][101].
1. For Kubernetes support, install the [**Datadog Agent**][102] in a Kubernetes environment and ensure that you enable the [**Orchestrator Explorer**][103] in your Agent configuration.
1. For AWS ECS support, set up [**Datadog Container Monitoring**][104] in ECS tasks.
1. For Amazon ECS support, set up [**Datadog Container Monitoring**][104] in ECS tasks.
1. Optionally, enable [AWS Split Cost Allocation][105] for usage-based ECS allocation.
1. To enable storage cost allocation, set up [EBS metric collection][108].
1. To enable GPU container cost allocation, install the [Datadog DCGM integration][106].
Expand Down Expand Up @@ -144,13 +144,13 @@ For Kubernetes Persistent Volume storage allocation, Persistent Volumes (PV), Pe

Next, Datadog looks at all of the pods that claimed the volume on that day. The cost of the volume is allocated to a pod based on the resources it used and the length of time it ran. These resources include the provisioned capacity for storage, IOPS, and throughput. This allocated cost is enriched with all of the pod's tags.

### AWS ECS on EC2
### Amazon ECS on EC2

For ECS allocation, Datadog determines which tasks ran on each EC2 instance used for ECS. If you enable AWS Split Cost Allocation, the metrics allocate ECS costs by usage instead of reservation, providing more granular detail.

Based on resources the task has used, Datadog assigns the appropriate portion of the instance's compute cost to that task. The calculated cost is enriched with all of the task's tags and all of the container tags (except container names) running in the task.

### AWS ECS on Fargate
### Amazon ECS on Fargate

ECS tasks that run on Fargate are already fully allocated [in the CUR][103]. CCM enriches that data by adding out-of-the-box tags and container tags to the AWS Fargate cost.

Expand Down Expand Up @@ -403,7 +403,7 @@ In addition to ECS task tags, the following out-of-the-box tags are applied to c

| Out-of-the-box tag | Description |
| --- | ------------ |
| `orchestrator:ecs` | The orchestration platform associated with the item is AWS ECS. |
| `orchestrator:ecs` | The orchestration platform associated with the item is Amazon ECS. |
| `ecs_cluster_name` | The name of the ECS cluster. |
| `is_aws_ecs` | All costs associated with running ECS. |
| `is_aws_ecs_on_ec2` | All EC2 compute costs associated with running ECS on EC2. |
Expand Down
53 changes: 34 additions & 19 deletions content/en/cloud_cost_management/planning/budgets.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,20 +10,23 @@ further_reading:
---

## Overview
After you start ingesting your costs in Cloud Cost Management, set up budgets and visualize how you are tracking against budgets.
Set up budgets and enable engineering teams to visualize how they are tracking against budgets.

You can create two types of budgets:

- [**Basic**](#create-a-basic-budget): A flat, single-level budget for tracking your cloud costs.
- [**Hierarchical**](#create-a-hierarchical-budget): A two-level, parent-child budget for tracking costs in a way that mirrors your organization's structure. For example, if your organization has departments made up of many teams, you can budget on the department (parent) and team (child) levels and track budget health at both levels. In addition, this option allows you to create a single budget instead of needing to create multiple budgets.
- **Basic**: A flat, single-level budget for tracking your cloud costs.
- **Hierarchical**: A two-level, parent-child budget for tracking costs in a way that mirrors your organization's structure. For example, if your organization has departments made up of many teams, you can budget on the department (parent) and team (child) levels and track budget health at both levels. In addition, this option allows you to create a single budget instead of needing to create multiple budgets.

## Create a basic budget
## Set up budgets

{{< tabs >}}
{{% tab "Basic" %}}

To create a basic budget:

1. Navigate to [**Cloud Cost > Plan > Budgets**][1], or create a budget through the [API][2] or [Terraform][3].
1. Click the **Create a New Budget** button.
1. Click **Basic** to a basic budget.
1. Click **Basic** to create a basic budget.
1. You can either add budget information by **uploading a CSV** using the provided template in the UI, or **enter your budget directly** using the details below.

{{< img src="cloud_cost/budgets/budget-upload-your-csv.mp4" alt="Choose whether to add budget information by uploading a CSV or enter it directly within the UI" video="true">}}
Expand All @@ -40,7 +43,13 @@ To create a basic budget:

1. Click **Save**.

## Create a hierarchical budget
[1]: https://app.datadoghq.com/cost/plan/budgets
[2]: /api/latest/cloud-cost-management/#create-or-update-a-budget
[3]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/cost_budget

{{% /tab %}}

{{% tab "Hierarchical" %}}

To create a hierarchical budget:

Expand All @@ -63,6 +72,12 @@ To create a hierarchical budget:

1. Click **Save**.

[1]: https://app.datadoghq.com/cost/plan/budgets
[2]: /api/latest/cloud-cost-management/#create-or-update-a-budget

{{% /tab %}}
{{< /tabs >}}

## View budget status
The [Budgets page][1] lists all of your organization's budgets, highlighting the budget creator, any budgets that have gone over,
and other relevant details. Click on **View Performance** to investigate the budget, and understand what might be causing you to go over budget.
Expand All @@ -79,31 +94,31 @@ You cannot view budget versus actuals before 15 months, since cost metrics are r

{{< img src="cloud_cost/budgets/budget-status-month-2.png" alt="Budget Status View: view current month">}}

- Or can view the budget status for the **entire duration (all)**:
- Or you can view the budget status for the **entire duration (all)**:

{{< img src="cloud_cost/budgets/budget-status-all-2.png" alt="Budget Status View: view total budget">}}

## Investigate budgets

{{< img src="cloud_cost/budgets/budget-investigate-3.png" alt="Use the dropdown filter or Apply Filter option in the table to investigate over-budget dimensions. ">}}

To investigate budgets:
1. From the individual budget page, filter budgets using the dropdown at the top, or "Apply filter" in the table to investigate dimensions that are over budget.
1. From the individual budget page, filter budgets using the dropdown at the top, or "Apply filter" in the table to investigate the dimensions that are over budget.
{{< img src="cloud_cost/budgets/budget-investigate-3.png" alt="Use the dropdown filter or Apply Filter option in the table to investigate over-budget dimensions.">}}
2. Click **Copy Link** to share the budget with others to help understand why budgets are going over. Or, share budgets with finance so that they can understand how you're tracking against budgets.

## Modify a budget
## Modify or delete a budget
To modify a budget, click the edit icon on the Budgets page.

{{< img src="cloud_cost/budgets/budget-edit-1.png" alt="Click the edit icon to edit a budget" style="width:70%;">}}
{{< img src="cloud_cost/budgets/budget-edit-1.png" alt="Click the edit icon to edit a budget" style="width:70%;">}}

## Delete budget
To delete a budget, click the trash icon on the Budgets page.

{{< img src="cloud_cost/budgets/budget-delete-2.png" alt="Click the delete icon to delete a budget" style="width:70%;">}}
{{< img src="cloud_cost/budgets/budget-delete-2.png" alt="Click the delete icon to delete a budget" style="width:70%;">}}

## Add a budget to a dashboard

You can create a budget report and add budgets to dashboards.

{{< img src="cloud_cost/budgets/budget-dashboard.png" alt="A budget report that has been added to a dashboard" style="width:100%;">}}

## Further Reading
{{< partial name="whats-next/whats-next.html" >}}

[1]: https://app.datadoghq.com/cost/plan/budgets
[2]: /api/latest/cloud-cost-management/#create-or-update-a-budget
[3]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/cost_budget
[1]: https://app.datadoghq.com/cost/plan/budgets
16 changes: 12 additions & 4 deletions content/en/cloud_cost_management/reports.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,19 +10,20 @@ further_reading:

## Overview

Datadog's Cloud Cost Monitoring (CCM) Reports empower financial operations and finance teams to efficiently manage cloud costs. This feature provides a centralized platform for detailed cost analysis, allowing you to explore, analyze, and share cloud cost data.
Datadog's Cloud Cost Monitoring (CCM) Reports empower financial operations and finance teams to efficiently manage cloud costs. This feature provides a centralized platform for detailed cost analysis, allowing you to explore, analyze, and share cloud cost or budget data.

With Reports, you can:

- **Centralize cloud spend analysis**: View and manage costs from [AWS][1], [Azure][2], [Google Cloud][3], and [SaaS providers][4] in one place.
- **Filter and group**: Filter by provider, tags, regions, and group by service, provider, or custom tags.
- **Visualize graphs**: Use bar charts, summaries, and day-over-day views to spot trends and anomalies.
- **Use advanced controls**: Switch between cost types, toggle container allocation, and focus on usage charges or all spend.
- **Create budget reports**: Build budget reports in addition to cost reports to track spending against budget targets and forecast future costs.
- **Collaborate and share**: Save, star, export, and share reports with your team.

## Create a cost report
## Create a CCM report

Go to [**Cloud Cost > Analyze > Reports**][5] in Datadog.
1. Go to [**Cloud Cost > Analyze > Reports**][5] in Datadog.
1. Click **New Report** to start from scratch, or select a template from the gallery to accelerate your workflow.

{{< img src="cloud_cost/cost_reports/create-new-report.png" alt="Create a new report or from a template." style="width:100%;" >}}
Expand All @@ -35,7 +36,14 @@ With Reports, you can:

## Customizing your report

{{< img src="cloud_cost/cost_reports/customization-options-aws.png" alt="Customize your report by selecting cloud providers, filtering, grouping, changing the visualization, and using advanced options." style="width:100%;" >}}
{{< img src="cloud_cost/cost_reports/customization-options-aws-1.png" alt="Customize your report by selecting cloud providers, filtering, grouping, changing the visualization, and using advanced options." style="width:100%;" >}}

### Select the type of report

Select the type of report you want to build:

- **Cost**: Understand where your money is being spent across services, regions, teams, and so on.
- **Budget**: Track spending against predefined budget targets and forecast future costs.

### Apply filters

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading