[CCV-3803] Add Cloud Cost Management Forecasts documentation

config/_default/menus/main.en.yaml

@@ -3934,16 +3934,21 @@ menu:
       parent: cloud_cost
       identifier: cloud_cost_planning
       weight: 7
+    - name: Forecasting
+      url: cloud_cost_management/planning/forecasting
+      parent: cloud_cost_planning
+      identifier: cloud_cost_planning_forecasting
+      weight: 701
     - name: Budgets
       url: cloud_cost_management/planning/budgets
       parent: cloud_cost_planning
       identifier: cloud_cost_planning_budgets
-      weight: 701
+      weight: 702
     - name: Commitment Programs
       url: cloud_cost_management/planning/commitment_programs
       parent: cloud_cost_planning
       identifier: cloud_cost_planning_commitment_programs
-      weight: 702
+      weight: 703
     - name: Cost Changes
       url: cloud_cost_management/cost_changes
       parent: cloud_cost

content/en/cloud_cost_management/planning/_index.md

@@ -16,8 +16,9 @@ The Planning section of Cloud Cost Management helps you take control of your clo
 ## Key Features
 
 {{< whatsnext desc="This section includes the following topics:" >}}
-    {{< nextlink href="/cloud_cost_management/planning/budgets" >}}<u>Budgets</u>: Set up, track, and manage cloud budgets to monitor your spend and stay on target. Create both basic and hierarchical budgets to match your organization's structure.{{< /nextlink >}}
-    {{< nextlink href="/cloud_cost_management/planning/commitment_programs" >}}<u>Commitment Programs</u>: Monitor and optimize your cloud discount programs, such as Reserved Instances and Savings Plans, to maximize savings and reduce waste.{{< /nextlink >}}
+    {{< nextlink href="/cloud_cost_management/planning/budgets" >}}<u>Budgets:</u> Set up, track, and manage cloud budgets to monitor your spend and stay on target. Create both basic and hierarchical budgets to match your organization's structure.{{< /nextlink >}}
+    {{< nextlink href="/cloud_cost_management/planning/commitment_programs" >}}<u>Commitment Programs:</u> Monitor and optimize your cloud discount programs, such as Reserved Instances and Savings Plans, to maximize savings and reduce waste.{{< /nextlink >}}
+    {{< nextlink href="/cloud_cost_management/planning/forecasting" >}}<u>Forecasting:</u> Predict future cloud costs based on historical spending patterns to anticipate trends, plan budgets effectively, and make data-driven decisions about resource allocation.{{< /nextlink >}}
 {{< /whatsnext >}}
 
 ## Further Reading

content/en/cloud_cost_management/planning/budgets.md

@@ -131,8 +131,17 @@ You can add a budget to dashboards in two ways:
 
 Learn how to [create a budget-based monitor][2].
 
+## View forecasts in budgets
+
+Budget cards automatically display forecast information when available, showing projected costs for each budget period. If forecasted costs are projected to exceed your budget, the budget status indicates **Projected Over** to help you take action before going over budget.
+
+To view detailed forecast information in a budget, click **View Performance** and toggle **Show Forecast** to visualize predicted costs alongside actual spending.
+
+Learn more about how [forecasting][3] works and data requirements.
+
 ## Further Reading
 {{< partial name="whats-next/whats-next.html" >}}
 
 [1]: https://app.datadoghq.com/cost/plan/budgets
-[2]: /cloud_cost_management/cost_changes/monitors/
+[2]: /cloud_cost_management/cost_changes/monitors/
+[3]: /cloud_cost_management/planning/forecasting

content/en/cloud_cost_management/planning/forecasting.md

@@ -0,0 +1,95 @@
+---
+title: Forecasting
+description: Predict future cloud costs and make informed decisions with Cloud Cost Management Forecasts.
+further_reading:
+- link: "/cloud_cost_management/planning/budgets"
+  tag: "Documentation"
+  text: "Learn about Cloud Cost Management Budgets"
+- link: "/cloud_cost_management/reporting/"
+  tag: "Documentation"
+  text: "Learn about Cloud Cost Management Reports"
+- link: "/cloud_cost_management/"
+  tag: "Documentation"
+  text: "Cloud Cost Management"
+---
+
+## Overview
+
+Cloud Cost Management (CCM) Forecasts help you predict future cloud costs based on historical spending patterns. Use forecasts to anticipate cost trends, plan budgets more effectively, and make data-driven decisions about resource allocation.
+
+Forecasts are available in:
+- [**Reports**](#view-forecasts-in-reports): Enable the forecast toggle to visualize predicted costs alongside your budget.
+- [**Budgets**](#view-forecasts-in-budgets): View forecasted costs directly on budget cards to see if you're projected to go over budget.
+
+With Forecasts, you can:
+
+- Anticipate **spending trends** based on your historical data to predict future costs.
+- Visualize **projected costs** alongside actual spending to identify patterns and understand cost trends.
+- Use forecast data to set **realistic budget targets** and avoid cost overruns.
+- See if forecasted costs are projected to **exceed your budget** targets to track budget health.
+
+## How forecasting works
+
+Cloud Cost Management uses forecasting algorithms to generate cost to generate cost predictions. The forecasting model analyzes your historical spending data to identify patterns and trends in your cloud costs, including:
+
+- Recurring costs that happen on a **predictable schedule** (such as weekly or monthly cycles).
+- Whether your costs are **increasing, decreasing, or staying stable** over time.
+- Changes in spending that correspond to **specific periods or events**.
+
+### Flexible forecasting options
+
+You can generate forecasts for various time horizons and rollup intervals to match your planning needs:
+
+- **Forecast periods**: Predict costs for the next billing period, current month, current year, or a custom date range based on your historical spending data.
+- **Rollup intervals**: View forecasts at daily or monthly intervals depending on your analysis requirements.
+
+### Data requirements
+
+To generate accurate forecasts, CCM requires:
+
+- **At least 31 *consecutive* days of cost data**: This helps ensure the model has sufficient information to identify meaningful patterns. If fewer days are available, the model pads the remaining days with zeros to generate a forecast.
+- **Recent data**: The model uses up to the last 100 days of your cost history to generate predictions.
+
+## View forecasts in reports
+
+Navigate to [**Cloud Cost > Analyze > Reports**][1] in Datadog to enable forecasts in your budget reports.
+
+1. Create a report or open an existing **Budget** report.
+2. In the left panel, toggle **Show forecast** to enable forecasting.
+3. Select the forecast period from the **Until end of** dropdown (next period, current month, current year, or a custom range).
+
+{{< img src="cloud_cost/forecasts/budget_report_forecast-2.png" alt="Budget report showing the forecast toggle in the left panel and forecasted costs displayed with historical data" style="width:100%;" >}}
+
+The report displays:
+- **Forecast toggle and controls**: Located in the left panel to enable forecasting and select the time period.
+- **Historical costs**: Your actual spending shown in solid colors.
+- **Forecasted costs**: Predicted costs shown with a hatched pattern.
+- **Forecast summary card**: Shows the total forecasted cost for the selected period.
+
+## View forecasts in budgets
+
+Navigate to [**Cloud Cost > Plan > Budgets**][2] in Datadog to view forecasts in your budget summaries.
+
+Budget cards automatically display forecast information when available, showing projected costs for each budget period.
+
+If forecasted costs are projected to exceed your budget, the budget status indicates **Projected Over** to help you take action before going over budget.
+
+{{< img src="cloud_cost/forecasts/budget-list-with-forecast.png" alt="Budget list showing forecast values on budget cards" style="width:100%;" >}}
+
+To view detailed forecast information:
+
+1. From the Budgets page, click **View Performance** on any budget to open the detailed budget view.
+2. In the budget performance view, toggle **Show Forecast** to enable forecasting.
+3. The budget performance chart displays:
+   - **Actual costs**: Your current spending shown in solid colors.
+   - **Forecasted costs**: Predicted costs shown with a hatched pattern extending beyond your actual costs.
+   - **Forecasted Past**: A vertical line indicating where the forecast begins.
+
+{{< img src="cloud_cost/forecasts/updated_budget_status_forecast-1.png" alt="Budget performance view showing the forecast toggle and forecasted costs displayed with a hatched pattern" style="width:100%;" >}}
+
+## Further reading
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: https://app.datadoghq.com/cost/analyze/reports
+[2]: https://app.datadoghq.com/cost/plan/budgets