Merge pull request #292054 from maud-lv/ml-grafanacli2

Engagement updates

Author: Court72

articles/managed-grafana/index.yml

@@ -33,52 +33,76 @@ landingContent:
     linkLists:
       - linkListType: how-to-guide
         links:
-          - text: Manage data sources
-            url: how-to-data-source-plugins-managed-identity.md
-          - text: Manage plugins
-            url: how-to-manage-plugins.md
-          - text: Add an Azure Monitor workspace
-            url: how-to-connect-azure-monitor-workspace.md
           - text: Create a dashboard
             url: how-to-create-dashboard.md
+          - text: Manage data sources
+            url: how-to-data-source-plugins-managed-identity.md
           - text: Share a dashboard
             url: how-to-share-dashboard.md
           - text: Use reporting and image rendering
             url: how-to-use-reporting-and-image-rendering.md
+          - text: Use service accounts
+            url: how-to-service-accounts.md
+  
+  - title: Manage data sources
+    linkLists:
+      - linkListType: how-to-guide
+        links:
+          - text: Manage data sources
+            url: how-to-data-source-plugins-managed-identity.md
+          - text: Manage plugins
+            url: how-to-manage-plugins.md
+          - text: Add an Azure Monitor workspace
+            url: how-to-connect-azure-monitor-workspace.md
+          - text: Configure Azure Data Explorer
+            url: how-to-connect-azure-data-explorer.md
+          - text: Enable Grafana Enterprise
+            url: how-to-grafana-enterprise.md
+      - linkListType: tutorial
+        links:
+          - text: Connect to self-hosted Prometheus via managed private endpoint
+            url: tutorial-mpe-oss-prometheus.md
 
   - title: Manage access and networking
     linkLists:
       - linkListType: how-to-guide
         links:
-          - text: Share an instance
+          - text: Share a workspace
             url: how-to-share-grafana-workspace.md
-          - text: Use Microsoft Entra groups
-            url: how-to-sync-teams-with-entra-groups.md
           - text: Set up authentication and permissions
             url: how-to-authentication-permissions.md
+          - text: Use Microsoft Entra groups
+            url: how-to-sync-teams-with-entra-groups.md
           - text: Modify access to Azure Monitor
             url: how-to-permissions.md
           - text: Connect to a data source privately
             url: how-to-connect-to-data-source-privately.md
           - text: Set up private access
             url: how-to-set-up-private-access.md
-          - text: Connect to self-hosted Prometheus via managed private endpoint
-            url: tutorial-mpe-oss-prometheus.md
           - text: Call Grafana APIs programmatically
             url: how-to-api-calls.md
           - text: Grafana settings
             url: grafana-settings.md
-
-  - title: Set up Grafana monitoring
+          - text: Use deterministic outbound IPs
+            url: how-to-deterministic-ip.md
+      - linkListType: concept
+        links:
+          - text: Encryption
+            url: encryption.md
+          - text: Azure RBAC
+            url: concept-role-based-access-control.md
+  - title: Configure monitoring
     linkLists:
       - linkListType: how-to-guide
         links:
           - text: Monitor an instance
             url: how-to-monitor-managed-grafana-workspace.md
           - text: Configure SMTP settings
             url: how-to-smtp-settings.md
+          - text: Use Azure Monitor alerts with Grafana
+            url: how-to-use-azure-monitor-alerts.md
 
-  - title: Manage availability
+  - title: Understand availability
     linkLists:
       - linkListType: concept
         links:

articles/managed-grafana/known-limitations.md

@@ -1,20 +1,20 @@
 ---
-title: Azure Managed Grafana service limitations
+title: Azure Managed Grafana service limits
 titlesuffix: Azure Managed Grafana
-description: Learn about current technical or feature limitations you may encounter in the Azure Managed Grafana service.
+description: Learn about current service limits, quotas, and constraints you may encounter using Azure Managed Grafana.
 ms.service: azure-managed-grafana
 ms.topic: troubleshooting
-ms.date: 10/08/2024
+ms.date: 12/17/2024
 ms.author: malev
 ms.custom: engagement-fy23
 author: maud-lv
 ---
 
-# Limitations of Azure Managed Grafana
+# Service limits, quotas, and constraints
 
 Azure Managed Grafana delivers the native Grafana functionality in the highest possible fidelity. There are some differences between what it provides and what you can get by self-hosting Grafana. As a general rule, Azure Managed Grafana disables features and settings that might affect the security or reliability of the service and individual Grafana instances it manages.
 
-## Current limitations
+## Service limits
 
 Azure Managed Grafana has the following known limitations:
 

articles/managed-grafana/quickstart-managed-grafana-cli.md

@@ -1,31 +1,35 @@
 ---
-title: Create an Azure Managed Grafana instance using the Azure CLI
-description: Learn how to create a Managed Grafana instance using the Azure CLI
+title: Create an Azure Managed Grafana instance with the Azure CLI
+description: Learn how to get started with Azure Managed Grafana and create an Azure Managed Grafana instance using the Azure CLI.
 ms.service: azure-managed-grafana
 ms.topic: quickstart
 author: maud-lv
 ms.author: malev
-ms.date: 10/06/2023
+ms.date: 12/17/2024
 ms.devlang: azurecli
 ms.custom: engagement-fy23, devx-track-azurecli
+# customer intent: As a developer or a data analyst, I want to create a new Azure Managed Grafana workspace using the Azure CLI.
 --- 
 
 # Quickstart: Create an Azure Managed Grafana instance using the Azure CLI
 
-Get started by creating an Azure Managed Grafana workspace using the Azure CLI. Creating a workspace will generate a Grafana instance.
+Get started using Azure Managed Grafana by creating an Azure Managed Grafana workspace using the Azure CLI.
 
 >[!NOTE]
-> Azure Managed Grafana now has [two pricing plans](overview.md#service-tiers). This guides takes you through creating a new workspace in the Standard plan. To generate a workspace in the newly released Essential (preview) plan, [use the Azure portal](quickstart-managed-grafana-portal.md). We are working on enabling the creation of a workspace in the Essential (preview) plan using the Azure CLI.
+> Azure Managed Grafana has [two pricing plans](overview.md#service-tiers). This guides takes you through creating a new workspace in the Standard plan. To generate a workspace in the Essential (preview) plan, [use the Azure portal](quickstart-managed-grafana-portal.md).
 
 ## Prerequisites
 
-- An Azure account for work or school and an active subscription. [Create an account for free](https://azure.microsoft.com/free).
-- The [Azure CLI](/cli/azure/install-azure-cli).
+- An Azure account for work or school with an active subscription. [Create an account for free](https://azure.microsoft.com/free).
+
 - Minimum required role to create an instance: resource group Contributor.
+
 - Minimum required role to access an instance: resource group Owner.
     >[!NOTE]
     > If you don't meet this requirement, once you've created a new Azure Managed Grafana instance, ask a User Access Administrator, subscription Owner or resource group Owner to grant you a Grafana Admin, Grafana Editor or Grafana Viewer role on the instance.
 
+[!INCLUDE [azure-cli-prepare-your-environment-no-header.md](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
+
 ## Sign in to Azure
 
 Open your CLI and run the `az login` command:
@@ -34,26 +38,26 @@ Open your CLI and run the `az login` command:
 az login
 ```
 
-This command will prompt your web browser to launch and load an Azure sign-in page.
+This command prompts your web browser to launch and load an Azure sign-in page.
 
-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 the `az grafana` command.
+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 automatically installs the first time you run the `az grafana` command.
 
 ## Create a resource group
 
-Run the code below to create resource group to organize the Azure resources needed to complete this quickstart. Skip this step if you already have a resource group you want to use.
+Run the following code to create a resource group to organize the Azure resources needed to complete this quickstart. Skip this step if you already have a resource group you want to use.
 
 | Parameter    | Description                                      | Example |
 |--------------|-----------------------------------------------------------------------------------------|----------|
 | --name | Choose a unique name for your new resource group. | *grafana-rg*     |
-| --location    | Choose an Azure region where Managed Grafana is available. For more info, go to [Products available by region](https://azure.microsoft.com/global-infrastructure/services/?products=managed-grafana).| *eastus*     |
+| --location    | Choose an Azure region where Azure Managed Grafana is available. For more info, go to [Products available by region](https://azure.microsoft.com/global-infrastructure/services/?products=managed-grafana).| *eastus*     |
 
 ```azurecli
 az group create --location <location> --name <resource-group-name>
 ```
 
 ## Create an Azure Managed Grafana workspace
 
-Run the code below to create an Azure Managed Grafana workspace.
+Run the following code to create an Azure Managed Grafana workspace.
 
 | Parameter    | Description                                      | Example |
 |--------------|-----------------------------------------------------------------------------------------|----------|
@@ -64,30 +68,30 @@ Run the code below to create an Azure Managed Grafana workspace.
    az grafana create --name <managed-grafana-resource-name> --resource-group <resource-group-name>
 ```
 
-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]
-   >Azure Managed Grafana has a system-assigned managed identity enabled by default. You can use a user-assigned managed identity or a service principal instead. To learn more, go to [Set up Azure Managed Grafana authentication and permissions (preview)](how-to-authentication-permissions.md).
+   > Azure Managed Grafana has a system-assigned managed identity enabled by default. You can use a user-assigned managed identity or a service principal instead. To learn more, go to [Set up Azure Managed Grafana authentication and permissions (preview)](how-to-authentication-permissions.md).
 
 ## Access your new Managed Grafana instance
 
 Now let's check if you can access your new Managed Grafana instance.
 
 1. Take note of the **endpoint** URL ending by `eus.grafana.azure.com`, listed in the CLI output.  
 
-1. Open a browser and enter the endpoint URL. Single sign-on via Microsoft Entra ID has been configured for you automatically. If prompted, enter your Azure account. You should now see your Azure Managed Grafana instance. From there, you can finish setting up your Grafana installation.
+1. Open a browser and enter the endpoint URL. Single sign-on via Microsoft Entra ID is automatically configured. If prompted, log in with your Azure account. You should now see your Azure Managed Grafana instance. From there, you can finish setting up your Grafana installation.
 
    :::image type="content" source="media/quickstart-portal/grafana-ui.png" alt-text="Screenshot of a Managed Grafana instance.":::
 
-You can now start interacting with the Grafana application to configure data sources, create dashboards, reports and alerts. Suggested read: [Monitor Azure services and applications using Grafana](/azure/azure-monitor/visualize/grafana-plugin).
-
 ## Clean up resources
 
 In the preceding steps, you created an Azure Managed Grafana workspace in a new resource group. If you don't expect to need these resources again in the future, delete the resource group.
 
 `az group delete -n <resource-group-name> --yes`
 
-## Next steps
+## Related content
+
+You can now start interacting with the Grafana application to configure data sources, create dashboards, reports, and alerts. Suggested read: 
 
-> [!div class="nextstepaction"]
-> [How to configure data sources for Azure Managed Grafana](./how-to-data-source-plugins-managed-identity.md)
+- [Monitor Azure services and applications using Grafana](/azure/azure-monitor/visualize/grafana-plugin).
+- [Configure data sources for Azure Managed Grafana](./how-to-data-source-plugins-managed-identity.md)

articles/managed-grafana/toc.yml

@@ -5,6 +5,8 @@ items:
   items:
     - name: About Azure Managed Grafana
       href: overview.md
+    - name: Service limits
+      href: known-limitations.md
 - name: Quickstarts
   expanded: true
   items:
@@ -64,15 +66,15 @@ items:
       href: how-to-create-dashboard.md
     - name: Share a dashboard
       href: how-to-share-dashboard.md
+    - name: Use reporting and image rendering
+      href: how-to-use-reporting-and-image-rendering.md
   - name: Alerts and notifications
     expanded: false
     items:
     - name: Use Azure Monitor alerts with Grafana
       href: how-to-use-azure-monitor-alerts.md
     - name: Configure SMTP settings
       href: how-to-smtp-settings.md
-    - name: Use reporting and image rendering
-      href: how-to-use-reporting-and-image-rendering.md
   - name: Networking
     expanded: false
     items:
@@ -100,8 +102,6 @@ items:
     href: how-to-migrate.md
   - name: Troubleshoot common issues
     href: troubleshoot-managed-grafana.md
-  - name: Known limitations
-    href: known-limitations.md
 - name: Reference
   items:
   - name: Azure CLI