Merge pull request #292254 from maud-lv/ml-grafanarefresh

Refresh content

Author: ttorble

articles/managed-grafana/encryption.md

@@ -1,11 +1,11 @@
 ---
 title: Encryption in Azure Managed Grafana
-description: Learn how data is encrypted in Azure Managed Grafana.
+description: In this guide, learn basic information about data storage and encryption within Azure Managed Grafana.
 author: maud-lv
 ms.author: malev
 ms.service: azure-managed-grafana
-ms.topic: conceptual
-ms.date: 03/23/2023
+ms.topic: concept-article
+ms.date: 12/22/2024
 ms.custom: concept, engagement-fy23
 ---
 

articles/managed-grafana/how-to-connect-azure-data-explorer.md

@@ -8,7 +8,7 @@ ms.service: azure-managed-grafana
 ms.custom: devx-track-azurecli
 zone_pivot_groups: azure-red-hat-openshift-service-principal
 ms.topic: how-to
-ms.date: 11/29/2023
+ms.date: 12/19/2024
 # CustomerIntent: As an Azure Managed Grafana customer, I want to add and configure Azure Data Explorer so that I can use an Azure Data Explorer datasource in a Grafana dashboard.
 ---
 
@@ -29,11 +29,7 @@ Add an Azure Data Explorer data source to Grafana by following the steps below.
 
 1. Open an Azure Managed Grafana instance in the Azure portal.
 1. In the **Overview** section, open the **Endpoint** URL.
-1. In the Grafana portal, deploy the menu on the left and select **Connections** > **Connect data**.
-
-    :::image type="content" source="media\azure-data-explorer\connect-data.png" alt-text="Screenshot of the Grafana platform showing the Connect data option.":::
-
-1. Select **Azure Data Explorer Datasource** from the list, and add it to Grafana by selecting **Create a Azure Data Explorer Datasource data source**.
+1. In the Grafana portal, go to **Connections** > **Data sources** > **Add new data source**, then search and select **Azure Data Explorer Datasource**.
 
 ## Configure an Azure Data Explorer data source
 
@@ -53,11 +49,8 @@ Enter Azure Data Explorer configuration settings.
     #### Add a new permission
 
     1. In the Azure portal, open your Azure Data Explorer cluster.
-    1. In the **Overview** section, select the database that contains your data.
+    1. Select **Data** > **Databases** from the left menu, then select the database that contains your data.
     1. Select **Permissions > Add > Viewer**.
-
-        :::image type="content" source="media\azure-data-explorer\add-permission.png" alt-text="Screenshot of the Azure platform showing a user adding a viewer permission in an Azure Data Explorer database.":::
-
     1. In the search box, enter your Azure Managed Grafana workspace name, select the workspace and then choose **Select**. A success notification appears.
 
     #### Configure the data source in Grafana

articles/managed-grafana/how-to-connect-azure-monitor-workspace.md

@@ -1,11 +1,11 @@
 ---
 title: Add an Azure Monitor workspace to Azure Managed Grafana
-description: Learn how to add an Azure Monitor workspace to Azure Managed Grafana to collect Prometheus data.
+description: Learn how to connect an Azure Monitor workspace to Azure Managed Grafana to collect Prometheus data.
 ms.service: azure-managed-grafana
 ms.topic: how-to
 author: maud-lv
 ms.author: malev
-ms.date: 01/22/2024
+ms.date: 12/19/2024
 --- 
 
 # Add an Azure Monitor workspace to Azure Managed Grafana to collect Prometheus data
@@ -38,9 +38,6 @@ To assign the Monitoring Data Reader role:
 
 1. Open your Azure Managed Grafana workspace.
 1. In the left menu, select **Integrations** > **Azure Monitor workspaces**.
-
-    :::image type="content" source="media\monitor-integration\add-azure-monitor.png" alt-text="Screenshot of the Grafana roles in the Azure platform.":::
-
 1. Select **Add**.
 1. In the pane that opens, select an Azure Monitor workspace from the list and confirm with **Add**.
 1. Once the operation is complete, Azure displays all the Azure Monitor workspaces added to the Azure Managed Grafana workspace. You can add more Azure Monitor workspaces by selecting **Add** again.

articles/managed-grafana/how-to-data-source-plugins-managed-identity.md

@@ -5,7 +5,7 @@ author: maud-lv
 ms.author: malev 
 ms.service: azure-managed-grafana
 ms.topic: how-to
-ms.date: 12/08/2023
+ms.date: 12/18/2024
 ---
 
 # How to manage data sources in Azure Managed Grafana
@@ -86,13 +86,12 @@ To add a data source to Azure Managed Grafana, follow the steps below.
 
 ### [Portal](#tab/azure-portal)
 
-1. [Core Grafana plugins](https://grafana.com/docs/grafana/latest/datasources/#built-in-core-data-sources) are installed in your workspace by default. If you want to use another type of data source, you first need to install its plugin. To install a new data source plugin, follow the instructions available at [Add a plugin](how-to-manage-plugins.md#add-a-plugin).
+1. [Core Grafana plugins](https://grafana.com/docs/grafana/latest/datasources/#built-in-core-data-sources) are installed in your workspace by default. If you want to use another type of data source, you first need to install its plugin by following the instructions available at [Add a plugin](how-to-manage-plugins.md#add-a-plugin).
 1. Add the data source to your instance.
 
    1. Open your Azure Managed Grafana workspace in the Azure portal and go to **Overview** > **Endpoint** to open the Grafana UI.
-   1. In the Grafana portal, deploy the menu on the left and select **Connections** > **Data sources** > **Add new data source**.
-   1. Select a data source from the list. The data source is added to your instance.
-   1. Fill out the required fields and select **Save & test** to update the data source configuration and make sure it works.
+   1. In the Grafana UI, deploy the menu on the left and select **Connections** > **Data sources** > **Add new data source**.
+   1. Select a data source from the list, then fill out the required fields and select **Save & test** to update the data source configuration and test it.
 
    :::image type="content" source="media/data-sources/add-data-source.png" alt-text="Screenshot of the Add data source page in Grafana.":::
 
@@ -140,10 +139,8 @@ The Azure Monitor data source is automatically added to all new Managed Grafana
 
    :::image type="content" source="media/data-sources/configuration.png" alt-text="Screenshot of the Add data sources page.":::
 
-1. Azure Monitor is listed as a built-in data source for your Managed Grafana instance. Select **Azure Monitor**.
-1. In the **Settings** tab, authenticate through **Managed Identity** and select your subscription from the dropdown list, or alternatively enter your **App Registration** details. When you select **Managed identity**, the authentication and authorization are made through the system-assigned or the user-assigned managed identity you [configured in your Azure Managed Grafana workspace](how-to-authentication-permissions.md). Using a managed identity lets you assign permissions for your Managed Grafana instance to access Azure Monitor data without having to manually manage service principals in Microsoft Entra ID.
-
-   :::image type="content" source="media/data-sources/configure-Azure-Monitor.png" alt-text="Screenshot of the Azure Monitor page in data sources.":::
+1. Azure Monitor is listed as a built-in data source for your Azure Managed Grafana instance. Select **Azure Monitor**.
+1. In the **Settings** tab, authenticate through **Managed Identity** and select your subscription from the dropdown list, or alternatively enter your **App Registration** details. When you select **Managed identity**, the authentication and authorization are made through the system-assigned or the user-assigned managed identity you [configured in your Azure Managed Grafana workspace](how-to-authentication-permissions.md). Using a managed identity lets you assign permissions for your Azure Managed Grafana instance to access Azure Monitor data without having to manually manage service principals in Microsoft Entra ID.
 
 ### [Azure CLI](#tab/azure-cli)
 

articles/managed-grafana/how-to-deterministic-ip.md

@@ -1,11 +1,12 @@
 ---
-title: How to set up and use deterministic outbound APIs in Azure Managed Grafana
-description: Learn how to set up and use deterministic outbound APIs in Azure Managed Grafana
+title: How to set up and use deterministic outbound APIs
+titleSuffix: Azure Managed Grafana
+description: Learn how to activate deterministic outbound IP support used by Azure Managed Grafana to communicate with data sources.
 ms.service: azure-managed-grafana
 ms.topic: how-to
 author: maud-lv
 ms.author: malev
-ms.date: 10/06/2023
+ms.date: 12/20/2024
 --- 
 
 # Use deterministic outbound IPs

articles/managed-grafana/how-to-enable-zone-redundancy.md

@@ -1,12 +1,12 @@
 ---
 title: How to enable zone redundancy in Azure Managed Grafana
-description: Learn how to create a zone-redundant Managed Grafana instance. 
+description: Learn how to create a zone-redundant Managed Grafana instance for protection against datacenter failure.
 ms.service: azure-managed-grafana
 ms.topic: how-to
 author: maud-lv
 ms.author: malev
 ms.custom: engagement-fy23
-ms.date: 10/06/2023
+ms.date: 12/20/2024
 
 --- 
 
@@ -39,7 +39,7 @@ Open your CLI and run the `az login` command to sign in to Azure.
 az login
 ```
 
-This command will prompt your web browser to launch and load an Azure sign-in page. If the browser fails to open, use device code flow with `az login --use-device-code`. For more sign-in options, go to [sign in with the Azure CLI](/cli/azure/authenticate-azure-cli).
+This command prompts your web browser to launch and load an Azure sign-in page. If the browser fails to open, use device code flow with `az login --use-device-code`. For more sign-in options, go to [sign in with the Azure CLI](/cli/azure/authenticate-azure-cli).
 
 ---
 
@@ -62,7 +62,7 @@ Create a workspace and enable zone redundancy with the Azure portal or the CLI.
     | Subscription ID     | Select the Azure subscription you want to use.                                                         | *my-subscription*   |
     | Resource group name | Create a resource group for your Azure Managed Grafana resources.                                      | *my-resource-group* |
     | Location            | Specify the geographic location in which to host your resource. Choose the location closest to you.    | *(US) East US*      |
-    | Name                | Enter a unique resource name. It will be used as the domain name in your Managed Grafana instance URL. | *my-grafana*        |
+    | Name                | Enter a unique resource name. It is used as the domain name in your Managed Grafana instance URL. | *my-grafana*        |
     | Pricing plan        | Select the **Standard** plan to get access to the zone redundancy feature. This feature is only available for customers using a [Standard plan](overview.md#service-tiers).                             | *Standard*          |
     | Zone Redundancy     | Set **Enable Zone Redundancy** to **Enable**.                                                          | *Enabled*           |
 
@@ -99,7 +99,7 @@ Create a workspace and enable zone redundancy with the Azure portal or the CLI.
     az grafana create --name <managed-grafana-resource-name> --resource-group <resource-group-name> --zone-redundancy enabled
     ```
 
-Once the deployment is complete, you'll see a note in the output of the command line stating that the instance was successfully created, alongside with additional information about the deployment.
+Once the deployment is complete, you see a note in the output of the command line stating that the instance was successfully created, alongside with additional information about the deployment.
 
 > [!NOTE]
 > The CLI experience for Azure Managed Grafana is part of the amg extension for the Azure CLI (version 2.30.0 or higher). The extension will automatically install the first time you run an `az grafana` command.

articles/managed-grafana/how-to-manage-plugins.md

@@ -5,7 +5,7 @@ author: maud-lv
 ms.author: malev 
 ms.service: azure-managed-grafana
 ms.topic: how-to
-ms.date: 01/22/2024
+ms.date: 12/19/2024
 ---
 
 # How to manage Grafana plugins
@@ -32,32 +32,26 @@ To install Grafana plugins, follow the process below.
    > [!NOTE]
    > This page only shows optional plugins. Core Grafana plugins that are included in your pricing plan by default aren't listed here.
 
-1. Select a plugin to add to your Grafana instance by checking its checkbox. A refresh icon appears in the table next to the plugin you selected, indicating that a change is pending.
+1. Select a plugin to add to your Grafana instance by checking its checkbox.
 
-   :::image type="content" source="media/plugin-management/add-plugin.png" alt-text="Screenshot of the Plugin management feature data source page.":::
+   :::image type="content" source="media/plugin-management/add-plugin.png" alt-text="Screenshot of the Plugin management feature data source page."lightbox="media/plugin-management/add-plugin.png":::
 
-1. Select **Save**. Azure displays a message stating which plugins will be added or removed. Select **Yes** to confirm.
-1. An **Updating** status bar indicates that the update is in progress. The update might take a while.
-1. A notification appears, indicating if the update operation has been successful.
-1. Select **Refresh** above the table to get an updated list of installed plugins.
+1. Select **Save**. Azure displays a message stating which plugins will be added or removed. Select **Yes** to confirm. Once the update is complete, a success message is displayed and the list of plugins is updated.
 
 ## Remove a plugin
 
-To remove a plugin that isn't part of the Grafana built-in core plugins, follow the steps below:
+To remove a plugin that isn't part of the Grafana built-in core plugins, follow the steps below.
 
-1. Open your Azure Managed Grafana instance in the Azure portal.
-1. Select **Plugin management**. This page displays a table with data source plugins. It contains three columns including checkboxes, plugin names, and plugin IDs. Review the checkboxes. A checked box indicates that the corresponding plugin is already installed and can be removed, an unchecked box indicates that the corresponding plugin can be added.
-1. Select a plugin to remove from your Grafana instance by unchecking its checkbox. A refresh icon appears in the table next to the plugin you selected, indicating that a change is pending.
+> [!CAUTION]
+> Removing a data source that is used in a dashboard will make the dashboard unable to collect the corresponding data and will trigger an error or result in no data being shown in the panel.
 
-   :::image type="content" source="media/plugin-management/remove-plugin.png" alt-text="Screenshot of the Plugin management feature data source page. Remove plugin.":::
+1. Open your Azure Managed Grafana instance in the Azure portal.
+1. Select **Plugin management**. This page displays a table with data source plugins. It contains three columns including checkboxes, plugin names, and plugin IDs. Installed plugins are displayed at the top of the list and have an **Installed** tag.
+1. Select a plugin to remove from your Grafana instance by checking its checkbox.
 
-1. Select **Save**. Azure displays a message stating which plugins will be added or removed. Select **Yes** to confirm.
-1. An **Updating** status bar indicates that the update is in progress. The update might take a while.
-1. A notification appears, indicating if the update operation has been successful.
-1. Select **Refresh** above the table to get an updated list of installed plugins.
+   :::image type="content" source="media/plugin-management/remove-plugin.png" alt-text="Screenshot of the Plugin management feature data source page. Remove plugin."lightbox="media/plugin-management/remove-plugin.png":::
 
-> [!CAUTION]
-> Removing a data source that is used in a dashboard will make the dashboard unable to collect the corresponding data and will trigger an error or result in no data being shown in the panel.
+1. Select **Save**. Azure displays a message stating which plugins will be added or removed. Select **Yes** to confirm. Once the update is complete, a success message is displayed and the list of plugins is updated.
 
 ## Next steps
 

articles/managed-grafana/how-to-set-up-private-access.md

@@ -7,7 +7,7 @@ author: maud-lv
 ms.author: malev
 ms.service: azure-managed-grafana
 ms.topic: how-to 
-ms.date: 01/31/2024
+ms.date: 12/19/2024
 ms.custom: how-to, devx-track-azurecli
 ---
 
@@ -161,7 +161,7 @@ Go to **Networking** > **Private Access** in your Azure Managed Grafana workspac
 
 1. To manually approve, reject or remove a connection, select the checkbox next to the endpoint you want to edit and select an action item from the top menu.
 
-1. Select the name of the private endpoint to open the private endpoint resource and access more information or to edit the private endpoint.
+1. Optionally select the name of the private endpoint to open the private endpoint resource and access more information or to edit the private endpoint.
 
     :::image type="content" source="media/private-endpoints/create-endpoint-approval.png" alt-text="Screenshot of the Azure portal, manage private endpoint.":::
 
@@ -207,6 +207,9 @@ For more CLI commands, go to [az network private-endpoint-connection](/cli/azure
 
 If you have issues with a private endpoint, check the following guide: [Troubleshoot Azure Private Endpoint connectivity problems](../private-link/troubleshoot-private-endpoint-connectivity.md).
 
-## Next steps
+## Next step
 
-In this how-to guide, you learned how to set up private access from your users to an Azure Managed Grafana workspace. To learn how to configure private access between a Managed Grafana workspace and a data source, see [Connect to a data source privately](how-to-connect-to-data-source-privately.md).
+In this how-to guide, you learned how to set up private access from your users to an Azure Managed Grafana workspace. To learn how to configure private access between a Managed Grafana workspace and a data source, see:
+
+> [!div class="nextstepaction"]
+> [Connect to a data source privately](how-to-connect-to-data-source-privately.md)

articles/managed-grafana/how-to-use-azure-monitor-alerts.md

@@ -1,11 +1,11 @@
 ---
 title: Use Azure Monitor alerts with Azure Managed Grafana
-description: Learn how to set up Azure Monitor alerts and use them with Azure Managed Grafana
+description: Learn how to set up Azure Monitor alerts and use them with Azure Managed Grafana to monitor and respond to important events.
 ms.service: azure-managed-grafana
 ms.topic: how-to
 author: maud-lv
 ms.author: malev
-ms.date: 11/14/2023
+ms.date: 12/19/2024
 --- 
 
 # Use Azure Monitor alerts with Grafana
@@ -42,6 +42,6 @@ Define alert rules in Azure Monitor based on the type of alerts:
 
 You can view alert state and conditions using the Azure Alert Consumption dashboard in your Azure Managed Grafana workspace.
 
-## Next steps
+## Related content
 
 In this how-to guide, you learned how to set up alerts for Azure Monitor and consume them in Azure Managed Grafana. To learn how to use Grafana alerts for other data sources, see [Grafana alerting](https://grafana.com/docs/grafana/latest/alerting/) and [setting up email notifications in Azure Managed Grafana](how-to-smtp-settings.md).