Quickstart: Create a dashboard in the Azure portal by using an ARM template
A dashboard in the Azure portal is a focused and organized view of your cloud resources. This quickstart focuses on the process of deploying an Azure Resource Manager template (ARM template) to create a dashboard. The dashboard shows the performance of a virtual machine (VM), as well as some static information and links.
If your environment meets the prerequisites and you're familiar with using ARM templates, select the Deploy to Azure button. The template will open in the Azure portal.
- If you don't have an Azure subscription, create a free account before you begin.
- An existing VM.
Create a virtual machine
The dashboard you create in the next part of this quickstart requires an existing VM. Create a VM by following these steps.
In the Azure portal, select Cloud Shell.
In the Cloud Shell window, select PowerShell.
Copy the following command and enter it at the command prompt to create a resource group.
New-AzResourceGroup -Name SimpleWinVmResourceGroup -Location EastUS
Copy the following command and enter it at the command prompt to create a VM in the resource group.
New-AzVm ` -ResourceGroupName "SimpleWinVmResourceGroup" ` -Name "SimpleWinVm" ` -Location "East US"
Enter a username and password for the VM. This is a new user name and password; it's not, for example, the account you use to sign in to Azure. For more information, see username requirements and password requirements.
The VM deployment now starts and typically takes a few minutes to complete. After deployment completes, move on to the next section.
Review the template
The template used in this quickstart is from Azure Quickstart Templates. The template for this article is too long to show here. To view the template, see azuredeploy.json. One Azure resource is defined in the template, Microsoft.Portal/dashboards - Create a dashboard in the Azure portal.
Deploy the template
Select the following image to sign in to Azure and open a template.
Select or enter the following values, then select Review + create.
Unless it's specified, use the default values to create the dashboard.
- Subscription: select an Azure subscription.
- Resource group: select SimpleWinVmResourceGroup.
- Location: select East US.
- Virtual Machine Name: enter SimpleWinVm.
- Virtual Machine Resource Group: enter SimpleWinVmResourceGroup.
Select Create or Purchase. After the dashboard has been deployed successfully, you get a notification:
The Azure portal was used to deploy the template. In addition to the Azure portal, you can also use Azure PowerShell, Azure CLI, and REST API. To learn other deployment methods, see Deploy templates.
Review deployed resources
Verify that you can see data about the virtual machine from within the Azure portal dashboard.
In the Azure portal, select Dashboard.
On the dashboard page, select Simple VM Dashboard.
Review the dashboard that the Azure Resource Manager template (ARM template) created. You can see that some of the content is static, but there are also charts that show the performance of the VM you created at the beginning.
Clean up resources
If you want to remove the VM and associated dashboard, delete the resource group that contains them.
In the Azure portal, search for SimpleWinVmResourceGroup, then select it in the search results.
On the SimpleWinVmResourceGroup page, select Delete resource group, enter the resource group name to confirm, then select Delete.
For more information about dashboards in the Azure portal, see: