Merge pull request #1236 from EnterpriseDB/DOCS-3504-roadmap-item-detect-schema-changes-change-detec

Schema change detection documentation

Author: irmabenitezzapata-creator

product_docs/docs/edb-postgres-ai/innovation-release/hybrid-manager/release_notes/hm_2026.01.0_rel_notes.mdx

@@ -43,7 +43,7 @@ HM now follows a dual release strategy: **LTS** and **Innovation Releases**. For
 
 | Type        | Description                                                                                                                                                                                                                                                                                                                                                                                          |
 | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Enhancement | The HM observability functionality has been upgraded with stacked charts for database sizes, historical chart annotations, and the ability to sync query tables with chart selections.                                                                                                                                                                                                               |
+| Enhancement | The HM observability functionality has been upgraded with stacked charts for database sizes, historical event markers, and the ability to sync query tables with chart selections.                                                                                                                                                                                                               |
 | Enhancement | Added API capabilities to annotate host metrics charts. You can now display activity logs as vertical dotted lines within the host historical charts in a cluster’s **Monitoring** tab. This allows you to correlate specific cluster events with host performance fluctuations at exact points in time.                                                                                             |
 | Enhancement | The Grand Unified Configuration (GUC) `query_advisor.exclude_schema_list` now includes predefined default values. These defaults automatically exclude internal database schemas, ensuring that Query Advisor recommendations (index and stats metrics displayed in the **Recommendations** tab of a cluster) remain focused on user-defined data and are not cluttered by internal system objects. |
 | Enhancement | The EDB Postgres AI agent uninstalls on Debian are now cleaner and warning free.                                                                                                                                                                                                                                                                                                                                  |

product_docs/docs/edb-postgres-ai/innovation-release/hybrid-manager/using_hybrid_manager/cluster_management/view_clusters/cluster-monitoring-tab.mdx

@@ -14,6 +14,8 @@ You can specify when you want the displayed data to start. The default is 15 min
 
 You can also specify whether to display the data as an aggregate of all the nodes in the cluster (**Cluster level**) or for each node (**Node level**). The default is to show the data at the cluster level.
 
+Enable **Display Events** for each monitoring category (**Host**, **Connections**, **Transactions**, etc.) to overlay event markers, including schema change events detected by HM. For self-managed clusters monitored through the EDB Postgres AI agent, schema change events appear as event markers rather than in the Cluster Activity Log.
+
 At the cluster level, each ring chart is a single ring showing the average of the data for all nodes in the cluster and graphs are based on a similar aggregation.
 
 At the node level, each chart is a concentric ring chart. Each ring represents a node in the cluster. Graphs are displayed separately for each node.

product_docs/docs/edb-postgres-ai/innovation-release/hybrid-manager/using_hybrid_manager/cluster_management/view_clusters/cluster-overview-tab.mdx

@@ -6,7 +6,7 @@ description: Learn about getting a complete overview of a Hybrid Manager cluster
 
 The **Cluster Overview** tab shows a summary of the cluster's connection string, active alerts, and recent cluster activity.
 
-If the cluster is a single node or primary/standby high-availability cluster, the overview  first shows the [Quick Connect](#getting-your-connection-string) section.
+If the cluster is a single node or primary/standby high-availability cluster, the overview first shows the [Quick Connect](#getting-your-connection-string) section.
 
 If the cluster is a distributed high-availability cluster, the overview first shows the [Data Groups](#data-groups) section.
 
@@ -26,17 +26,17 @@ The status badge indicates the status of the data group. A green circle with a w
 
 -   To restore a data group you deleted, from the ellipsis menu, select **Restore Data Group**.
 
--   To perform a write leader switchover, from the ellispsis menu, select [**Switchover Write Leader**](#switchover-write-leader). 
+-   To perform a write leader switchover, from the ellipsis menu, select [**Switchover Write Leader**](#switchover-write-leader). 
 
 Under **Quick Connect** for the data group, you can get the psql command line connection string for read-write and read-only connections. 
 
 Select **Read-write** or **Read-only** to see the psql command line with a connection string configured for the data group and a user with the edb_admin role to connect to the `bdrdb` database. To connect to the database, you can copy this command and paste it into a terminal. To do so, you need the password for the edb_admin user.
 
 !!! Note
+The **Read-only** connection string isn't available in Hybrid Manager (HM) 1.1.
+!!!
 
-    The **Read-only** connection string isn't available in Hybrid Manager 1.1.
-
-To toggle the display of a cluster architecture diagram, select the **Cluster Architecture Diagram** heading. (The diagram is hidden by default.) This diagram shows the architecture of the cluster, including the data groups, witness groups and proxies, and the interconnection between them.
+To toggle the display of a cluster architecture diagram, select the **Cluster Architecture Diagram** heading. (The diagram is hidden by default.) This diagram shows the architecture of the cluster, including the data groups, witness groups, and proxies, and the interconnection between them.
 
 ### Switchover Write Leader
 
@@ -58,5 +58,9 @@ The number of currently active alerts are listed in three categories: High Sever
 
 You can view the recent activity logged on the cluster, including creation, configuration updates, and other major events in the cluster's lifecycle. Active elements don't appear here. For more details on the events, select the [**Logs**](cluster-logs-tab) tab.
 
+When HM detects a schema change in an HM-managed database, it automatically inserts an event entry in the Cluster Activity Log. You can use these entries to track when schema changes occurred and correlate them with changes in cluster performance.
 
+!!! Note
+The Cluster Activity Log isn't available for self-managed clusters. Schema change events for self-managed clusters appear as event markers on the [**Monitoring**](cluster-monitoring-tab) tab instead.
+!!!