[DOCS-13864] Document Monitors overlay in Cloudcraft

config/_default/menus/main.en.yaml

@@ -2970,6 +2970,11 @@ menu:
       parent: datadog_cloudcraft_overlays
       identifier: datadog_cloudcraft_overlays_ccm
       weight: 104
+    - name: Monitors
+      url: datadog_cloudcraft/overlays/monitors/
+      parent: datadog_cloudcraft_overlays
+      identifier: datadog_cloudcraft_overlays_monitors
+      weight: 105
     - name: Resource Catalog
       url: infrastructure/resource_catalog/
       pre: resource-catalog

config/_default/params.yaml

@@ -301,6 +301,7 @@ unsupported_sites:
   continuous_integration: [gov]
   correlation: [gov] #Event management correlation
   coterm: [gov]
+  cloudcraft_monitors_overlay: [gov]
   cloudprem: [gov]
   csm_jira: [us,us3,us5,eu,ap1,ap2]
   data_jobs: [gov]

content/en/datadog_cloudcraft/overlays/_index.md

@@ -22,6 +22,7 @@ Cloudcraft provides the following built-in overlays:
 - [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.
+- [Monitors][5] (Preview): View monitor states for your resources and services, and investigate alerting monitors with Bits AI SRE.
 
 ## Further reading
 
@@ -31,4 +32,5 @@ Cloudcraft provides the following built-in overlays:
 [2]: /datadog_cloudcraft/overlays/observability/
 [3]: /datadog_cloudcraft/overlays/security/
 [4]: /datadog_cloudcraft/overlays/ccm/
+[5]: /datadog_cloudcraft/overlays/monitors/
 

content/en/datadog_cloudcraft/overlays/monitors.md

@@ -0,0 +1,56 @@
+---
+title: Monitors
+description: "Use the Monitors overlay in Cloudcraft to view monitor states for your resources and services, and investigate alerting monitors with Bits AI SRE."
+site_support_id: cloudcraft_monitors_overlay
+further_reading:
+- link: "/bits_ai/bits_ai_sre/"
+  tag: "Documentation"
+  text: "Bits AI SRE"
+---
+
+{{< callout btn_hidden="true" header="Join the Preview!" >}}
+The Monitors overlay is in Preview.
+{{< /callout >}}
+
+## Overview
+
+The Monitors overlay shows monitors associated with your AWS and Azure resources and services, along with their current state (Alert, Warn, or OK). Use this overlay to identify and investigate production issues directly in your infrastructure diagram.
+
+## View monitor status
+
+Each resource or service with associated monitors displays an icon showing:
+
+- The count of monitors in the highest state (Alert takes priority over Warn, which takes priority over OK)
+- The title of the highest-priority monitor
+
+When only one monitor is in the highest state, the diagram displays the monitor icon instead of a count.
+
+{{< img src="datadog_cloudcraft/overlays/cloudcraft_monitors_overlay_diagram.png" alt="Cloudcraft diagram with the Monitors overlay showing monitor icons and counts on resources." style="width:100%;" >}}
+
+## Filter monitors
+
+Use the legend at the bottom of the diagram to filter monitors by alerting status and monitor priority.
+
+{{< img src="datadog_cloudcraft/overlays/cloudcraft_monitors_overlay_legend.png" alt="Monitors overlay legend in Cloudcraft with filter options for alerting status and monitor priority." style="width:50%;" >}}
+
+## Investigate monitors
+
+### Hover panel
+
+Hover over a resource or service with monitors to see a count breakdown of associated monitors by status. The hover panel includes an **Investigate with Bits AI SRE** button that loads the three most recent alerting events for the selected monitor. From there, you can initiate an investigation or view an existing one.
+
+{{< img src="datadog_cloudcraft/overlays/cloudcraft_monitors_overlay_hover_panel.png" alt="Cloudcraft Monitors overlay hover panel showing a monitor count breakdown by status and the Investigate with Bits AI SRE button." style="width:80%;" >}}
+
+For more information, see [Bits AI SRE][1].
+
+### Side panel
+
+Click a monitor pin on the diagram to open a side panel listing all monitors associated with that resource or service. For resource monitors, you can also initiate or view a [Bits AI SRE][1] investigation for any alerting monitor from this panel.
+
+{{< img src="datadog_cloudcraft/overlays/cloudcraft_monitors_overlay_side_panel.png" alt="Cloudcraft Monitors overlay side panel showing a list of monitors associated with a resource." style="width:100%;" >}}
+
+## Further reading
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: /bits_ai/bits_ai_sre/