[DOCS-12851] restructure Cloudcraft overlays section + CCM updates

config/_default/menus/main.en.yaml

@@ -3088,6 +3088,26 @@ menu:
       parent: datadog_cloudcraft
       identifier: datadog_cloudcraft_overlays
       weight: 1
+    - name: Infrastructure
+      url: datadog_cloudcraft/overlays/infrastructure/
+      parent: datadog_cloudcraft_overlays
+      identifier: datadog_cloudcraft_overlays_infrastructure
+      weight: 101
+    - name: Observability
+      url: datadog_cloudcraft/overlays/observability/
+      parent: datadog_cloudcraft_overlays
+      identifier: datadog_cloudcraft_overlays_observability
+      weight: 102
+    - name: Security
+      url: datadog_cloudcraft/overlays/security/
+      parent: datadog_cloudcraft_overlays
+      identifier: datadog_cloudcraft_overlays_security
+      weight: 103
+    - name: Cloud Cost Management
+      url: datadog_cloudcraft/overlays/ccm/
+      parent: datadog_cloudcraft_overlays
+      identifier: datadog_cloudcraft_overlays_ccm
+      weight: 104
     - name: Resource Catalog
       url: infrastructure/resource_catalog/
       pre: resource-catalog

content/en/datadog_cloudcraft/overlays/_index.md

@@ -0,0 +1,34 @@
+---
+title: Overlays
+description: "Use Cloudcraft overlays to view your infrastructure from different perspectives including observability, security, cost management, and infrastructure."
+further_reading:
+- link: "https://www.datadoghq.com/blog/cloud-architecture-diagrams-cost-compliance-cloudcraft-datadog/"
+  tag: "Blog"
+  text: "Plan new architectures and track your cloud footprint with Cloudcraft (Standalone)"
+- link: "https://www.datadoghq.com/blog/cloudcraft-observability-overlay/"
+  tag: "Blog"
+  text: "Visually identify observability gaps with Cloudcraft in Datadog"
+---
+
+## Overview
+
+Cloudcraft supports overlays that integrate data from multiple sources, enriching your diagrams with real-time insights. These views let you group and filter resources by key attributes, helping you focus on different parts of your architecture for troubleshooting, cost optimization, or security analysis. Each overlay is designed to address a specific operational goal, making it easy to adapt the diagram to your needs.
+
+## Available overlays
+
+Cloudcraft provides the following built-in overlays: 
+
+- [Infrastructure][1]: View resources grouped by Account, Region, and VPC for architecture diagrams and troubleshooting.
+- [Observability][2]: See where the Datadog Agent is installed and which features are enabled per host.
+- [Security][3]: Identify security exposures, misconfigurations, and vulnerabilities in your architecture.
+- [Cloud Cost Management (CCM)][4]: Discover savings opportunities with cost recommendations shown directly on resources.
+
+## Further reading
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: /datadog_cloudcraft/overlays/infrastructure/
+[2]: /datadog_cloudcraft/overlays/observability/
+[3]: /datadog_cloudcraft/overlays/security/
+[4]: /datadog_cloudcraft/overlays/ccm/
+

content/en/datadog_cloudcraft/overlays/ccm.md

@@ -0,0 +1,69 @@
+---
+title: Cloud Cost Management
+description: "Use the Cloud Cost Management overlay in Cloudcraft to view resource-level costs and discover savings opportunities directly on your architecture diagrams."
+further_reading:
+- link: "/datadog_cloudcraft/overlays/infrastructure/"
+  tag: "Documentation"
+  text: "Infrastructure overlay"
+- link: "/datadog_cloudcraft/overlays/observability/"
+  tag: "Documentation"
+  text: "Observability overlay"
+- link: "/datadog_cloudcraft/overlays/security/"
+  tag: "Documentation"
+  text: "Security overlay"
+- link: "/cloud_cost_management/"
+  tag: "Documentation"
+  text: "Cloud Cost Management"
+---
+
+## Overview
+
+The Cloud Cost overlay helps you visualize resource-level costs and identify savings opportunities within your AWS architecture diagrams. This overlay provides two views: **[Cost](#cost-view)** and **[Recommendations](#recommendations-view)**.
+
+## Cost view
+
+The Cost view displays resource-level cloud costs for the last 30 days, allowing you to understand spending patterns across your architecture.
+
+### Filter by cost
+
+Use the slider filter at the bottom of the screen to set a cost range. The diagram updates dynamically to highlight resources within your selected range.
+
+You can also filter by region to focus on specific parts of your infrastructure.
+
+### Resource details
+
+Click a resource to open the side panel, which displays:
+
+- Cost breakdown for the last 30 days
+- Tag information associated with the resource
+- **Top Cost Changes** section (when applicable) highlighting significant cost fluctuations
+
+**Note**: The time range defaults to the last 30 days and is not configurable.
+
+{{< img src="datadog_cloudcraft/overlays/cloudcraft_ccm_cost_view.png" alt="Cloud Cost Management overlay in Cloudcraft showing the Cost view with resource-level costs." style="width:100%;" >}} 
+
+## Recommendations view
+
+The Recommendations view shows savings opportunities directly on resources with estimated monthly savings (for example, terminate unused RDS instances, migrate storage classes).
+
+Use the filter at the bottom of the screen to narrow recommendations by:
+
+- Potential monthly savings range
+- Recommendation type: **Terminate**, **Migrate**, **Downsize**, or **Purchase**
+
+### Resource details
+
+Clicking a resource opens a detailed side panel with:
+
+- Current and projected monthly costs
+- A description of recommended changes
+- Quick actions to create a Jira issue or support case
+- Metrics and usage patterns explaining the recommendation
+
+This enables faster, in-context cost optimization without switching views.
+
+{{< img src="datadog_cloudcraft/overlays/cloudcraft_ccm_overlay_5.png" alt="Cloud Cost Management overlay in Cloudcraft showing the Recommendations view with savings opportunities highlighted." style="width:100%;" >}}
+
+## Further reading
+
+{{< partial name="whats-next/whats-next.html" >}}

content/en/datadog_cloudcraft/overlays/infrastructure.md

@@ -0,0 +1,61 @@
+---
+title: Infrastructure
+description: "Use the Infrastructure overlay in Cloudcraft to view resources grouped by Account, Region, and VPC for architecture diagrams and troubleshooting."
+further_reading:
+- link: "/datadog_cloudcraft/overlays/observability/"
+  tag: "Documentation"
+  text: "Observability overlay"
+- link: "/datadog_cloudcraft/overlays/security/"
+  tag: "Documentation"
+  text: "Security overlay"
+- link: "/datadog_cloudcraft/overlays/ccm/"
+  tag: "Documentation"
+  text: "Cloud Cost Management overlay"
+---
+
+## Overview
+
+The Infrastructure overlay provides a broad overview of your cloud environment, grouping resources by Account, Region, and VPC. This is the default view when opening a Cloudcraft diagram.
+
+{{< img src="datadog_cloudcraft/infra_overlay_4.png" alt="Infrastructure overlay in Cloudcraft." style="width:100%;" >}}
+
+## Use cases
+
+The Infrastructure overlay is ideal for:
+
+- Generating architecture diagrams for documentation or presentations
+- Troubleshooting connectivity and resource relationships
+- Conducting high-level architecture reviews
+- Onboarding team members to your cloud environment
+
+## Resource grouping
+
+Resources are organized in a hierarchical structure:
+
+- **Account**: Top-level grouping by AWS account
+- **Region**: Resources grouped by geographic region within each account
+- **VPC**: Resources grouped by Virtual Private Cloud within each region
+
+This hierarchy helps you understand how resources are distributed across your cloud infrastructure.
+
+## Interact with resources
+
+Click any resource to open a side panel with additional details, including:
+
+- Resource type and name
+- Associated tags
+- Links to related Datadog views
+
+## Excluded components
+
+To reduce visual clutter and highlight the most important parts of your architecture, the Infrastructure overlay excludes certain components by default:
+
+- EBS volumes
+- NAT Gateways
+- Transit Gateways
+
+These components are still part of your infrastructure but are hidden to keep the diagram focused on core resources.
+
+## Further reading
+
+{{< partial name="whats-next/whats-next.html" >}}