Dec 18, 2019 - Explore Templates807's board 'Dashboard Template', followed by 1308 people on Pinterest. See more ideas about dashboard template, dashboard design, dashboard. An Excel dashboard is a place where you can have a quickview of the key performance indicators in one place. Dashboards usually fall into one of these three (3) types: 1. Aug 25, 2020 React Dashboard Template - Argon Dashboard, main screen. React Dashboard - Compile from sources. To compile and start the project locally we need NodeJS and optionally GIT to download the source code from the public repository: React Dashboard Argon.
-->Template format
To create a Microsoft.Portal/dashboards resource, add the following JSON to the resources section of your template.
Bicep is currently in preview. For more information, see Project Bicep.
Property values
The following tables describe the values you need to set in the schema.
Microsoft.Portal/dashboards object
Note
In Bicep, type and apiVersion are specified in the first line of the resource declaration. Use the format <type>@<apiVersion>. Don't set those properties in the resource body.
| Name | Type | Required | Value |
|---|---|---|---|
| name | string | Yes | The name of the dashboard. |
| type | enum | Yes | For JSON - Microsoft.Portal/dashboards |
| apiVersion | enum | Yes | For JSON - 2020-09-01-preview |
| properties | object | Yes | The shared dashboard properties. - DashboardProperties object |
| location | string | Yes | Resource location |
| tags | object | No | Resource tags |
DashboardProperties object
| Name | Type | Required | Value |
|---|---|---|---|
| lenses | array | No | The dashboard lenses. - DashboardLens object |
| metadata | object | No | The dashboard metadata. |
DashboardLens object
| Name | Type | Required | Value |
|---|---|---|---|
| order | integer | Yes | The lens order. |
| parts | array | Yes | The dashboard parts. - DashboardParts object |
| metadata | object | No | The dashboard len's metadata. |
DashboardParts object
| Name | Type | Required | Value |
|---|---|---|---|
| position | object | Yes | The dashboard's part position. - DashboardPartsPosition object |
| metadata | object | No | The dashboard part's metadata. - DashboardPartMetadata object |
DashboardPartsPosition object
| Name | Type | Required | Value |
|---|---|---|---|
| x | integer | Yes | The dashboard's part x coordinate. |
| y | integer | Yes | The dashboard's part y coordinate. |
| rowSpan | integer | Yes | The dashboard's part row span. |
| colSpan | integer | Yes | The dashboard's part column span. |
| metadata | object | No | The dashboard part's metadata. |
DashboardPartMetadata object
| Name | Type | Required | Value |
|---|---|---|---|
| type | string | Yes |
Quickstart templates
The following quickstart templates deploy this resource type.
| Template | Description |
|---|---|
| Create an Azure portal dashboard | This template creates an example dashboard in the Azure portal, showing performance of an existing virtual machine in your subscription, as well as some static information and links. |
| Shared default dashboard | In order to make an application operational it helps to have a shared dashboard view of the services that make up the system. This dashboard provides a quickstart for customizing and sharing that with others on the team. |
This article walks you through the process of programmatically creating and publishing Azure dashboards. The dashboard shown below is referenced throughout the document.
Overview
Shared dashboards in the Azure portal are resources just like virtual machines and storage accounts. You can manage resources programmatically by using the Azure Resource Manager REST APIs, the Azure CLI, and Azure PowerShell commands.
Many features build on these APIs to make resource management easier. Each of these APIs and tools offers ways to create, list, retrieve, modify, and delete resources. Since dashboards are resources, you can pick your favorite API or tool to use.
Whichever tools you use, to create a dashboard programmatically, you construct a JSON representation of your dashboard object. This object contains information about the tiles on the dashboard. It includes sizes, positions, resources they're bound to, and any user customizations.
The most practical way to build up this JSON document is to use the Azure portal. You can interactively add and position your tiles. Then export the JSON and create a template from the result for later use in scripts, programs, and deployment tools.
Create a dashboard
To create a dashboard, select Dashboard from the Azure portal menu, then select New dashboard.
Use the tile gallery to find and add tiles. Tiles are added by dragging and dropping them. Some tiles support resizing by using a drag handle.
Others have fixed sizes to choose from in their context menu.
Share the dashboard
After you configure the dashboard, the next step is to publish the dashboard using the Share command.
Selecting Share prompts you to choose which subscription and resource group to publish to. You must have write access to the subscription and resource group that you choose. For more information, see Assign Azure roles using the Azure portal.
Fetch the JSON representation of the dashboard
Publishing only takes a few seconds. When it's done, the next step is to fetch the JSON using the Download command.
Create a template from the JSON
The next step is to create a template from this JSON. Use that template programmatically with the appropriate resource management APIs, command-line tools, or within the portal.
You don't have to fully understand the dashboard JSON structure to create a template. In most cases, you want to preserve the structure and configuration of each tile. Then parameterize the set of Azure resources that the tiles point to. Look at your exported JSON dashboard and find all occurrences of Azure resource IDs. Our example dashboard has multiple tiles that all point at a single Azure virtual machine. That's because our dashboard only looks at this single resource. If you search the sample JSON, included at the end of the document, for '/subscriptions', you find several occurrences of this ID.
/subscriptions/6531c8c8-df32-4254-d717-b6e983273e5d/resourceGroups/contoso/providers/Microsoft.Compute/virtualMachines/myVM1
To publish this dashboard for any virtual machine in the future, parameterize every occurrence of this string within the JSON.
There are two approaches for APIs that create resources in Azure:
- Imperative APIs create one resource at a time. For more information, see Resources.
- A template-based deployment system that creates multiple, dependent resources with a single API call. For more information, see Deploy resources with Resource Manager templates and Azure PowerShell.
Template-based deployment supports parameterization and templating. We use this approach in this article.
Programmatically create a dashboard from your template using a template deployment
Azure offers the ability to orchestrate the deployment of multiple resources. You create a deployment template that expresses the set of resources to deploy and the relationships between them. The JSON format of each resource is the same as if you were creating them one by one. The difference is that the template language adds a few concepts like variables, parameters, basic functions, and more. This extended syntax is only supported in the context of a template deployment. It doesn't work if used with the imperative APIs discussed earlier. For more information, see Understand the structure and syntax of Azure Resource Manager templates.
Parameterization should be done using the template's parameter syntax. You replace all instances of the resource ID we found earlier as shown here.
Example JSON property with hard-coded resource ID:
Example JSON property converted to a parameterized version based on template parameters
Declare required template metadata and the parameters at the top of the JSON template like this:
Once you've configured your template, deploy it using any of the following methods:
Next you'll see two versions of our example dashboard JSON. The first is the version that we exported from the portal that was already bound to a resource. The second is the template version that can be programmatically bound to any virtual machine and deployed using Azure Resource Manager.
JSON representation of our example dashboard before templating
This example shows what you can expect to see if you followed along with this article. The instructions exported the JSON representation of a dashboard that is already deployed. The hard-coded resource identifiers show that this dashboard is pointing at a specific Azure virtual machine.
Template representation of our example dashboard
The template version of the dashboard has defined three parameters called virtualMachineName, virtualMachineResourceGroup, and dashboardName. The parameters let you point this dashboard at a different Azure virtual machine every time you deploy. This dashboard can be programmatically configured and deployed to point to any Azure virtual machine. To test this feature, copy the following template and paste it into the Azure portal template deployment page.
This example deploys a dashboard by itself, but the template language lets you deploy multiple resources, and bundle one or more dashboards along side them.
Now that you've seen an example of using a parameterized template to deploy a dashboard, you can try deploying the template by using the Azure Resource Manager REST APIs, the Azure CLI, or Azure PowerShell commands.
Programmatically create a dashboard by using Azure CLI
Prepare your environment for the Azure CLI.
Use the Bash environment in Azure Cloud Shell.
If you prefer, install the Azure CLI to run CLI reference commands.
If you're using a local installation, sign in to the Azure CLI by using the az login command. To finish the authentication process, follow the steps displayed in your terminal. For additional sign-in options, see Sign in with the Azure CLI.
When you're prompted, install Azure CLI extensions on first use. For more information about extensions, see Use extensions with the Azure CLI.
Run az version to find the version and dependent libraries that are installed. To upgrade to the latest version, run az upgrade.
- These examples use the following dashboard: portal-dashboard-template-testvm.json. Replace content in angled brackets with your values.
Run the az portal dashboard create command to create a dashboard:
You can update a dashboard by using the az portal dashboard update command:
See the details of a dashboard by running the az portal dashboard show command:
Excel Dashboards Examples
To see all the dashboards for the current subscription, use az portal dashboard list:
Outline Dashboard Login
You can also see all the dashboards for a resource group:
Next steps
How To Create A Dashboard In Excel
For more information about desktops, see Manage Azure portal settings and preferences.
Outline Dashboard Meaning
For more information about Azure CLI support for dashboards, see az portal dashboard.