Merge pull request #30315 from dimitri-furman/database-watcher

Clarify cross-subscription monitoring

Author: prmerger-automator[bot]

azure-sql/database-watcher-faq.yml

@@ -5,7 +5,7 @@ metadata:
   description: Frequently asked questions about database watcher for Azure SQL
   author: dimitri-furman
   ms.author: dfurman
-  ms.date: 03/21/2024
+  ms.date: 04/08/2024
   ms.reviewer: wiassaf
   ms.service: sql-db-mi
   ms.subservice: monitoring
@@ -67,6 +67,10 @@ sections:
           Can I monitor a large Azure SQL estate?
         answer: Yes. For more information, see [Monitor large estates](database-watcher-manage.md#monitor-large-estates).
 
+      - question: |
+          Does it support cross-subscription and cross-tenant monitoring?
+        answer: The watcher and the SQL targets it monitors can be in different subscriptions within the same Microsoft Entra ID tenant. The watcher and its data store can be in different subscriptions in the same Microsoft Entra ID tenant, or in different tenants.
+
   - name: Watcher
     questions:
       - question: |

azure-sql/database-watcher-manage.md

@@ -5,7 +5,7 @@ description: Setup and configuration details for database watcher
 author: dimitri-furman
 ms.author: dfurman
 ms.reviewer: wiassaf
-ms.date: 04/05/2024
+ms.date: 04/08/2024
 ms.service: sql-db-mi
 ms.subservice: monitoring
 ms.topic: how-to
@@ -125,7 +125,7 @@ In the Azure portal, you can add or remove targets, create or delete private end
 To enable database watcher monitoring for an Azure SQL database, elastic pool, or SQL managed instance, you need to add this resource as a SQL target.
 
 1. To add a target, on the **SQL targets** page, select **Add**. 
-1. Find the Azure SQL resource you want to monitor. Select the resource type and subscription, and then select the SQL target from the list of resources.
+1. Find the Azure SQL resource you want to monitor. Select the resource type and subscription, and then select the SQL target from the list of resources. The SQL target can be in any subscription within the same Microsoft Entra ID tenant as the watcher.
 1. To monitor the primary replica and a high availability [secondary replica](./database/read-scale-out.md) of a database, elastic pool, or SQL managed instance, add two separate targets for the same resource, and check the **Read intent** box for *one of them*. 
     - Checking the **Read intent** box configures the watcher to monitor the high availability secondary replica only.
     - Do not check the **Read intent** box if you want to monitor only the primary replica, or if a high availability secondary replica does not exist for this resource, or if the read scale-out feature is disabled.

azure-sql/database-watcher-overview.md

@@ -5,7 +5,7 @@ description: An overview of database watcher for Azure SQL, a managed monitoring
 author: dimitri-furman
 ms.author: dfurman
 ms.reviewer: wiassaf
-ms.date: 03/27/2024
+ms.date: 04/08/2024
 ms.service: sql-db-mi
 ms.subservice: monitoring
 ms.topic: conceptual
@@ -43,6 +43,8 @@ Database watcher supports all service tiers, compute tiers, and service objectiv
 
 Database watcher can monitor all types of secondary [readable replicas](./database/read-scale-out.md), including high availability replicas, [geo-replicas](./database/active-geo-replication-overview.md), and Hyperscale [named secondary](./database/service-tier-hyperscale-replicas.md) replicas.
 
+For a given watcher, the SQL targets can be in any subscription within the same Microsoft Entra ID tenant.
+
 ## Database watcher price
 
 Database watcher costs are incurred by its individual components, as follows:

azure-sql/database-watcher-quickstart.md

@@ -5,7 +5,7 @@ description: Learn how to create a new database watcher to monitor an Azure SQL
 author: dimitri-furman
 ms.author: dfurman
 ms.reviewer: wiassaf
-ms.date: 03/28/2024
+ms.date: 04/08/2024
 ms.service: sql-db-mi
 ms.subservice: monitoring
 ms.topic: quickstart
@@ -16,7 +16,7 @@ monikerRange: "=azuresql||=azuresql-db||=azuresql-mi"
 
 # Quickstart: Create a database watcher to monitor Azure SQL (preview)
 
-This article shows you how to create a new database watcher to monitor an Azure SQL database, elastic pool, or SQL managed instance. For an introduction to database watcher, see [Monitor Azure SQL workloads with database watcher](database-watcher-overview.md).
+This article shows you how to create a new database watcher to monitor an Azure SQL database, elastic pool, or SQL managed instance. For an introduction to database watcher, see [Monitor Azure SQL workloads with database watcher](database-watcher-overview.md). For a detailed description of database watcher setup and configuration, see [Create and configure a database watcher](database-watcher-manage.md).
 
 Follow the steps to create a database watcher and start monitoring your Azure SQL resources in minutes. The watcher you create uses Microsoft Entra authentication and private connectivity to the monitoring targets.