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

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

* minor edit

* add db screenshot

* natasha fb and rearrange some content

* little errors

* minor fix

Author: rtrieu

content/en/cloud_cost_management/_index.md

@@ -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:

content/en/cloud_cost_management/container_cost_allocation.md

@@ -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.
 
@@ -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].
@@ -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.
 
@@ -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. |

content/en/cloud_cost_management/planning/budgets.md

@@ -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">}}
@@ -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:
 
@@ -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.
@@ -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

content/en/cloud_cost_management/reports.md

@@ -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%;" >}}
@@ -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