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 Managed Grafana instance.

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.

Prerequisite

An Azure account with an active subscription. Create an account for free.

Sign in to Azure

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. 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.

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.

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. eastus
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.

Parameter Description Example
--name Choose a unique name for your new Managed Grafana instance. grafana-test
--resource-group Choose a resource group for your Managed Grafana instance. my-resource-group
   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.

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.

  2. Open a browser and enter the endpoint URL. Single sign-on via Azure Active Directory 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.

    Screenshot of a Managed Grafana instance.

    Note

    Azure Managed Grafana doesn't support connecting with personal Microsoft accounts currently.

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.

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