Manage an Azure Monitor workspace

This article shows you how to create and delete an Azure Monitor workspace. When you configure Azure Monitor managed service for Prometheus, you can select an existing Azure Monitor workspace or create a new one.

Note

When you create an Azure Monitor workspace, by default a data collection rule and a data collection endpoint in the form <azure-monitor-workspace-name> will automatically be created in a resource group in the form MA_<azure-monitor-workspace-name>_<location>_managed. In case there are any Azure policies with restrictions on resource or resource group names, create an exemption to exempt these resources from evaluation.

Create an Azure Monitor workspace

Azure portal

1. Open the Azure Monitor workspaces menu in the Azure portal.

2. Select Create.

   

3. On the Create an Azure Monitor Workspace page, select a Subscription and Resource group where the workspace is to be created.

4. Provide a Name and a Region for the workspace.

5. Select Review + create to create the workspace.

CLI

Use the following command to create an Azure Monitor workspace using Azure CLI.

az monitor account create --name <azure-monitor-workspace-name> --resource-group <resource-group-name> --location <location>

For more details, visit Azure CLI for Azure Monitor Workspace

Resource Manager

To create an Azure Monitor workspace, use one of the following Resource Manager templates with any of the standard deployment options.

{
    "$schema": "http://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "name": {
            "type": "string"
        },
        "location": {
            "type": "string",
            "defaultValue": ""
        }
    },
    "resources": [
        {
            "type": "microsoft.monitor/accounts",
            "apiVersion": "2021-06-03-preview",
            "name": "[parameters('name')]",
            "location": "[if(empty(parameters('location')), resourceGroup().location, parameters('location'))]"
        }
    ]
}

@description('Specify the name of the workspace.')
param workspaceName string

@description('Specify the location for the workspace.')
param location string = resourceGroup().location

resource workspace 'microsoft.monitor/accounts@2021-06-03-preview' = {
  name: workspaceName
  location: location
}

When you create an Azure Monitor workspace, a new resource group is created. The resource group name has the following format: MA_<azure-monitor-workspace-name>_<location>_managed, where the tokenized elements are lowercased. The resource group contains both a data collection endpoint and a data collection rule with the same name as the workspace. The resource group and its resources are automatically deleted when you delete the workspace.

To connect your Azure Monitor managed service for Prometheus to your Azure Monitor workspace, see Collect Prometheus metrics from AKS cluster

Delete an Azure Monitor workspace

When you delete an Azure Monitor workspace, unlike with a Log Analytics workspace, there's no soft delete operation. The data in the workspace is immediately deleted, and there's no recovery option.

Azure portal

1. Open the Azure Monitor workspaces menu in the Azure portal.

2. Select your workspace.

3. Select Delete.

   

CLI

To delete an AzureMonitor workspace use az resource delete

For example:

  az monitor account delete --name <azure-monitor-workspace-name> --resource-group <resource-group-name>

For more details, visit Azure CLI for Azure Monitor Workspace

Resource Manager

For information on deleting resources and Azure Resource Manager, see Azure Resource Manager resource group and resource deletion

Link a Grafana workspace

Connect an Azure Monitor workspace to an Azure Managed Grafana workspace to allow Grafana to use the Azure Monitor workspace data in a Grafana dashboard. An Azure Monitor workspace can be connected to multiple Grafana workspaces, and a Grafana workspace can be connected to multiple Azure Monitor workspaces. Azure Managed Grafana and your Azure Monitor workspace can be in different regions.

Note

When you add the Azure Monitor workspace as a data source to Grafana, it islisted in as Prometheus_<azure monitor workspace query endpoint>.

Azure portal

1. Open the Azure Monitor workspace menu in the Azure portal.
2. Select your workspace.
3. Select Linked Grafana workspaces.
4. Select a Grafana workspace.

CLI

Create a link between the Azure Monitor workspace and the Grafana workspace by updating the Azure Kubernetes Service cluster that you're monitoring.

If your cluster is already configured to send data to an Azure Monitor managed service for Prometheus, you must disable it first using the following command:

az aks update --disable-azure-monitor-metrics -g <cluster-resource-group> -n <cluster-name> 

Then, either enable or re-enable using the following command:

az aks update --enable-azure-monitor-metrics -n <cluster-name> -g <cluster-resource-group> --azure-monitor-workspace-resource-id 
<azure-monitor-workspace-name-resource-id> --grafana-resource-id  <grafana-workspace-name-resource-id>

Output

"azureMonitorProfile": {
    "metrics": {
        "enabled": true,
        "kubeStateMetrics": {
            "metricAnnotationsAllowList": "",
            "metricLabelsAllowlist": ""
        }
    }
}

Resource Manager

To set up an Azure monitor workspace as a data source for Grafana using a Resource Manager template, see Collect Prometheus metrics from AKS cluster

If your Grafana instance is self managed, see Use Azure Monitor managed service for Prometheus as data source for self-managed Grafana using managed system identity

Next steps

• Learn more about the Azure Monitor data platform.
• Azure Monitor workspace Overview