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.
Note
Azure Managed Grafana now has two pricing plans. 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. We are working on enabling the creation of a workspace in the Essential (preview) plan using the Azure CLI.
Prerequisites
- An Azure account for work or school and an active subscription. Create an account.
- The Azure CLI.
- 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.
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.
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.
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. | chinanorth |
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.
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).
Access your new Managed Grafana instance
Now let's check if you can access your new Managed Grafana instance.
Take note of the endpoint URL ending by
eus.grafana.azure.com, listed in the CLI output.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.
You can now start interacting with the Grafana application to configure data sources, create dashboards, reports and alerts.
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