Merge pull request #272767 from MicrosoftDocs/release-preview-site-manager

Release preview site manager--scheduled release at 10am of 4/22

Author: huypub

articles/azure-arc/index.yml

@@ -169,3 +169,7 @@ additionalContent:
         - title: Azure IoT Operations Preview – enabled by Azure Arc
           summary: Azure IoT Operations is a unified data plane for the edge that helps organizations deploy the industrial metaverse.
           url: /azure/iot-operations/
+        # Card
+        - title: Azure Arc site manager (preview)
+          summary: Use Arc sites to represent your on-premises environments and see centralized monitoring information across your edge infrastructure.
+          url: /azure/azure-arc/site-manager/

articles/azure-arc/site-manager/breadcrumb/toc.yml

@@ -0,0 +1,11 @@
+- name: Azure
+  tocHref: /azure
+  topicHref: /azure/index
+  items:
+  - name: Azure Arc
+    tocHref: /azure/azure-arc
+    topicHref: /azure/azure-arc
+    items:
+    - name: Site manager
+      tocHref: /azure/azure-arc/site-manager
+      topicHref: /azure/azure-arc/site-manager

articles/azure-arc/site-manager/faq.md

@@ -0,0 +1,34 @@
+---
+title: Frequently asked questions
+description: "Frequently asked questions to understand and troubleshoot Azure Arc sites and site manager"
+author: kgremban
+ms.author: kgremban
+ms.service: azure-arc
+#ms.subservice: site-manager
+ms.topic: faq #Don't change
+ms.date: 02/16/2024
+ms.custom: references_regions
+
+#customer intent: As a customer, I want answers to questions so that I can answer my own questions.
+
+---
+
+# Frequently asked questions: Azure Arc site manager (preview)
+
+The following are frequently asked questions and answers for Azure Arc site manager.
+
+**Question:** I have resources in the resource group, which aren't yet supported by site manager. Do I need to move them?
+
+**Answer:** Site manager provides status aggregation for only the supported resource types. Resources of other types won't be managed via site manager. They continue to function normally as they would without otherwise.
+
+**Question:** Does site manager have a subscription or fee for usage?
+
+**Answer:** Site manager is free. However, the Azure services that integrated with sites and site manager might have a fee. Additionally, alerts used with site manager via monitor might have fees as well.
+
+**Question:** What regions are currently supported via site manager? What regions of these supported regions aren't fully supported?
+
+**Answer:** Site manager supports resources that exist in [supported regions](https://azure.microsoft.com/explore/global-infrastructure/products-by-region/?products=azure-arc&regions=all), with a few exceptions. For the following regions, connectivity and update status aren't supported for Arc-enabled machines or Arc-enabled Kubernetes clusters:
+
+* Brazil South
+* UAE North
+* South Africa North

articles/azure-arc/site-manager/how-to-configure-monitor-site.md

@@ -0,0 +1,54 @@
+---
+title: "How to configure Azure Monitor alerts for a site"
+description: "Describes how to create and configure alerts using Azure Monitor to manage resources in an Azure Arc site."
+author: kgremban
+ms.author: kgremban
+ms.service: azure-arc
+#ms.subservice: site-manager
+ms.topic: how-to #Don't change
+ms.date: 04/18/2024
+
+#customer intent: As a site admin, I want to know where to create a alert in Azure for my site so that I can deploy monitoring for resources in my site.
+
+---
+
+# Monitor sites in Azure Arc
+
+Azure Arc sites provide a centralized view to monitor  groups of resources, but don't provide monitoring capabilities for the site overall. Instead, customers can set up alerts and monitoring for supported resources within a site. Once alerts are set up and triggered depending on the alert criteria, Azure Arc site manager (preview) makes the resource alert status visible within the site pages.
+
+If you aren't familiar with Azure Monitor, learn more about how to [monitor Azure resources with Azure Monitor](../../azure-monitor/essentials/monitor-azure-resource.md).
+
+## Prerequisites
+
+* An Azure subscription. If you don't have a service subscription, create a [free trial account in Azure](https://azure.microsoft.com/free/).
+* Azure portal access
+* Internet connectivity
+* A resource group or subscription in Azure with at least one resource for a site. For more information, see [Supported resource types](./overview.md#supported-resource-types).
+
+## Configure alerts for sites in Azure Arc
+
+This section provides basic steps for configuring alerts for sites in Azure Arc. For more detailed information about Azure Monitor, see [Create or edit an alert rule](../../azure-monitor/alerts/alerts-create-metric-alert-rule.md).
+
+To configure alerts for sites in Azure Arc, follow the below steps.
+
+1. Navigate to Azure Monitor by searching for **monitor** within the Azure portal. Select **Monitor** as shown.
+
+   :::image type="content" source="./media/how-to-configure-monitor-site/search-monitor.png" alt-text="Screenshot that shows searching for monitor within the Azure portal.":::
+
+1. On the **Monitor** overview, select **Alerts** in either the navigation menu or the boxes shown in the primary screen.
+
+   :::image type="content" source="./media/how-to-configure-monitor-site/select-alerts-monitor.png" alt-text="Screenshot that shows selecting the Alerts option on the Monitor overview.":::
+
+1. On  the **Alerts** page, you can manage existing alerts or create new ones.
+
+   Select **Alert rules** to see all of the alerts currently in effect in your subscription.
+
+   Select **Create** to create an alert rule for a specific resource. If a resource is managed as part of a site, any alerts triggered via its rule appear in the site manager overview.
+
+   :::image type="content" source="./media/how-to-configure-monitor-site/create-alert-monitor.png" alt-text="Screenshot that shows the Create and Alert rules actions on the Alerts page.":::
+
+By having either existing alert rules or creating a new alert rule, once the rule is in place for resources supported by Azure Arc site monitor, any alerts that are trigger on that resource will be visible on the sites overview tab.
+
+## Next steps
+
+To learn how to view alerts triggered from Azure Monitor for supported resources within site manager, see [How to view alerts in site manager](./how-to-view-alerts.md).

articles/azure-arc/site-manager/how-to-crud-site.md

@@ -0,0 +1,101 @@
+---
+title: "How to create and manage an Azure Arc site"
+description: "Describes how to create, view, delete, or modify an Azure Arc site in the Azure portal using site manager."
+author: kgremban
+ms.author: kgremban
+ms.service: azure-arc
+#ms.subservice: site-manager
+ms.topic: how-to #Don't change
+ms.date: 04/18/2024
+
+#customer intent: As a site admin, I want to know how to create, delete, and modify sites so that I can manage my site.
+
+---
+
+# Create and manage sites
+
+This article guides you through how to create, modify, and delete a site using Azure Arc site manager (preview).
+
+## Prerequisites
+
+* An Azure subscription. If you don't have a service subscription, create a [free trial account in Azure](https://azure.microsoft.com/free/).
+* Azure portal access
+* Internet connectivity
+* A resource group or subscription in Azure with at least one resource for a site. For more information, see [Supported resource types](./overview.md#supported-resource-types).
+
+## Open Azure Arc site manager
+
+In the [Azure portal](https://portal.azure.com), search for and select **Azure Arc**. Select **Site manager (preview)** from the Azure Arc navigation menu.
+
+:::image type="content" source="./media/how-to-crud-site/arc-portal-main.png" alt-text="Screenshot that shows selecting Site manager from the Azure Arc overview.":::
+
+Alternatively, you can also search for Azure Arc site manager directly in the Azure portal using terms such as **site**, **Arc Site**, **site manager** and so on.
+
+## Create a site
+
+Create a site to manage geographically related resources.
+
+1. From the main **Site manager** page in **Azure Arc**, select the blue **Create a site** button.
+
+   :::image type="content" source="./media/how-to-crud-site/create-a-site-button.png" alt-text="Screenshot that shows creating a site from the site manager overview.":::
+
+1. Provide the following information about your site:
+
+   | Parameter | Description |
+   |--|--|
+   | **Site name** | Custom name for site. |
+   | **Display name** | Custom display name for site. |
+   | **Site scope** | Either **Subscription** or **Resource group**. The scope can only be defined at the time of creating a site and can't be modified later. All the resources in the scope can be viewed and managed from site manager. |
+   | **Subscription** | Subscription for the site to be created under. |
+   | **Resource group** | The resource group for the site, if the scope was set to resource group. |
+   | **Address** | Physical address for a site. |
+
+1. Once these details are provided, select **Review + create**.
+
+   :::image type="content" source="./media/how-to-crud-site/create-a-site-page-los-angeles.png" alt-text="Screenshot that shows all the site details filled in to create a site and then select review + create.":::
+
+1. On the summary page, review and confirm the site details then select **Create** to create your site.
+
+   :::image type="content" source="./media/how-to-crud-site/final-create-screen-arc-site.png" alt-text="Screenshot that shows the validation and review page for a new site and then select create.":::
+
+If a site is created from a resource group or subscription that contains resources that are supported by site, these resources will automatically be visible within the created site. 
+
+## View and modify a site
+
+Once you create a site, you can access it and its managed resources through site manager.
+
+1. From the main **Site manager** page in **Azure Arc**, select **Sites** to view all existing sites.
+
+   :::image type="content" source="./media/how-to-crud-site/sites-button-from-site-manager.png" alt-text="Screenshot that shows selecting Sites to view all sites.":::
+
+1. On the **Sites** page, you can view all existing sites. Select the name of the site that you want to delete.
+
+   :::image type="content" source="./media/how-to-crud-site/los-angeles-site-select.png" alt-text="Screenshot that shows selecting a site to manage from the list of sites.":::
+
+1. On a specific site's resource page, you can:
+
+   * View resources
+   * Modify resources (modifications affect the resources elsewhere as well)
+   * View connectivity status
+   * View update status
+   * View alerts
+   * Add new resources
+
+Currently, only some aspects of a site can be modified. These are as follows:
+
+| Site Attribute | Modification that can be done |
+|--|--|
+| Display name | Update the display name of a site to a new unique name. |
+| Address | Update the address of a site to an existing or new address. |
+
+## Delete a site
+
+Deleting a site doesn't affect the resources, resource group, or subscription in its scope. After a site is deleted, the resources of that site will still exist but can't be viewed or managed from site manager. You can create a new site for the resource group or the subscription after the original site is deleted.
+
+1. From the main **Site manager** page in **Azure Arc**, select **Sites** to view all existing sites.
+
+1. On the **Sites** page, you can view all existing sites. Select the name of the site that you want to delete.
+
+1. On the site's resource page, select **Delete**.
+
+   :::image type="content" source="./media/how-to-crud-site/los-angeles-site-main-page-delete.png" alt-text="Screenshot that shows selecting Delete on the details page of a site.":::

articles/azure-arc/site-manager/how-to-view-alerts.md

@@ -0,0 +1,62 @@
+---
+title: "How to view alerts for a site"
+description: "How to view and create alerts for a site"
+author: kgremban
+ms.author: kgremban
+ms.service: azure-arc
+#ms.subservice: site-manager
+ms.topic: how-to #Don't change
+ms.date: 04/18/2024
+
+---
+
+# How to view alert status for an Azure Arc site
+
+This article details how to view the alert status for an Azure Arc site. A site's alert status reflects the status of the underlying resources. From the site status view, you can find detailed status information for the supported resources as well.
+
+## Prerequisites
+
+* An Azure subscription. If you don't have a service subscription, create a [free trial account in Azure](https://azure.microsoft.com/free/).
+* Azure portal access
+* Internet connectivity
+* A resource group or subscription in Azure with at least one resource for a site. For more information, see [Supported resource types](./overview.md#supported-resource-types).
+* A site created for the associated resource group or subscription. If you don't have one, see [Create and manage sites](./how-to-crud-site.md).
+
+## Alert status colors and meanings
+
+In the Azure portal, status is indicated using color.
+
+* Green: **Up to Date**
+* Blue: **Info**
+* Purple: **Verbose**
+* Yellow: **Warning**
+* Orange: **Error**
+* Red: **Critical**
+
+## View alert status
+
+View alert status for an Arc site from the main page of Azure Arc site manager (preview).
+
+1. From the [Azure portal](https://portal.azure.com), navigate to **Azure Arc** and select **Site manager (preview)** to open site manager.
+
+1. From Azure Arc site manager, navigate to the **Overview** page.
+
+   :::image type="content" source="./media/how-to-view-alerts/overview-sites-page.png" alt-text="Screenshot that shows selecting the overview page from site manager.":::
+
+1. On the **Overview** page, you can view the summarized alert statuses of all sites. This site-level alert status is an aggregation of all the alert statuses of the resources in that site. In the following example, sites are shown with different statuses.
+
+   :::image type="content" source="./media/how-to-view-alerts/site-manager-overview-alerts.png" alt-text="Screenshot that shows viewing the alert status on the site manager overview page." lightbox="./media/how-to-view-alerts/site-manager-overview-alerts.png":::
+
+1. To understand which site has which status, select either the **Sites** tab or the blue status text.
+
+   :::image type="content" source="./media/how-to-view-alerts/site-manager-overview-alerts-details.png" alt-text="Screenshot of site manager overview page directing to the sites page to view more details." lightbox="./media/how-to-view-alerts/site-manager-overview-alerts-details.png":::
+
+1. The **sites** page shows the top-level status for each site, which reflects the most significant status for the site.
+
+   :::image type="content" source="./media/how-to-view-alerts/site-manager-overview-alerts-details-status-site-page.png" alt-text="Screenshot that shows the top level alerts status for each site." lightbox="./media/how-to-view-alerts/site-manager-overview-alerts-details-status-site-page.png":::
+
+1. If there's an alert, select the status text to open details for a given site. You can also select the name of the site to open its details.
+
+1. On a site's resource page, you can view the alert status for each resource within the site, including the resource responsible for the top-level most significant status.
+
+   :::image type="content" source="./media/how-to-view-alerts/site-manager-overview-alerts-details-status-los-angeles.png" alt-text="Screenshot that shows the site detail page with alert status for each resource." lightbox="./media/how-to-view-alerts/site-manager-overview-alerts-details-status-los-angeles.png":::

articles/azure-arc/site-manager/how-to-view-connectivity-status.md

@@ -0,0 +1,60 @@
+---
+title: "How to view connectivity status"
+description: "How to view the connectivity status of an Arc Site and all of its managed resources through the Azure portal."
+author: kgremban
+ms.author: kgremban
+ms.service: azure-arc
+#ms.subservice: site-manager
+ms.topic: how-to #Don't change
+ms.date: 04/18/2024
+
+# As a site admin, I want to know how to view update status so that I can use my site.
+
+---
+# How to view connectivity status for an Arc site
+
+This article details how to view the connectivity status for an Arc site. A site's connectivity status reflects the status of the underlying resources. From the site status view, you can find detailed status information for the supported resources as well.
+
+## Prerequisites
+
+* An Azure subscription. If you don't have a service subscription, create a [free trial account in Azure](https://azure.microsoft.com/free/).
+* Azure portal access
+* Internet connectivity
+* A resource group or subscription in Azure with at least one resource for a site. For more information, see [Supported resource types](./overview.md#supported-resource-types).
+* A site created for the associated resource group or subscription. If you don't have one, see [Create and manage sites](./how-to-crud-site.md).
+
+## Connectivity status colors and meanings
+
+In the Azure portal, status is indicated using color.
+
+* Green: **Connected**
+* Yellow: **Not Connected Recently**
+* Red: **Needs Attention**
+
+## View connectivity status
+
+You can view connectivity status for an Arc site as a whole from the main page of Azure Arc site manager (preview).
+
+1. From the [Azure portal](https://portal.azure.com), navigate to **Azure Arc** and select **Site manager (preview)** to open site manager.
+
+1. From Azure Arc site manager, navigate to the **Overview** page.
+
+   :::image type="content" source="./media/how-to-view-connectivity-status/overview-sites-page.png" alt-text="Screenshot that shows selecting the Overview page in site manager.":::
+
+1. On the **Overview** page, you can see a summary of the connectivity statuses of all your sites. The connectivity status of a given site is an aggregation of the connectivity status of its resources. In the following example, sites are shown with different statuses.
+
+   :::image type="content" source="./media/how-to-view-connectivity-status/site-connection-overview.png" alt-text="Screenshot that shows the connectivity view in the sites overview page." lightbox="./media/how-to-view-connectivity-status/site-connection-overview.png":::
+
+1. To understand which site has which status, select either the **sites** tab or the blue colored status text to be directed to the **sites** page.
+
+   :::image type="content" source="./media/how-to-view-connectivity-status/click-connectivity-status-site-details.png" alt-text="Screenshot that shows selecting the Sites tab to get more detail about connectivity status." lightbox="./media/how-to-view-connectivity-status/click-connectivity-status-site-details.png":::
+
+1. On the **Sites** page, you can view the top-level status for each site. This site-level status reflects the most significant resource-level status for the site.
+
+1. Select the **Needs attention** link to view the resource details.
+
+   :::image type="content" source="./media/how-to-view-connectivity-status/site-connectivity-status-from-sites-page.png" alt-text="Screenshot that shows selecting the connectivity status for a site to see the resource details." lightbox="./media/how-to-view-connectivity-status/site-connectivity-status-from-sites-page.png":::
+
+1. On the site's resource page, you can view the connectivity status for each resource within the site, including the resource responsible for the top-level most significant status.
+
+   :::image type="content" source="./media/how-to-view-connectivity-status/los-angeles-resource-status-connectivity.png" alt-text="Screenshot that shows using the site details page to identify resources with connectivity issues." lightbox="./media/how-to-view-connectivity-status/los-angeles-resource-status-connectivity.png":::