mirror of https://github.com/grafana/grafana.git
68 lines
3.6 KiB
Markdown
68 lines
3.6 KiB
Markdown
|
---
|
||
|
|
aliases:
|
||
|
|
- /docs/grafana/latest/datasources/azuremonitor/template-variables/
|
||
|
|
- /docs/grafana/latest/data-sources/azure-monitor/template-variables/
|
||
|
|
description: Using template variables with Azure Monitor in Grafana
|
||
|
|
keywords:
|
||
|
|
- grafana
|
||
|
|
- microsoft
|
||
|
|
- azure
|
||
|
|
- monitor
|
||
|
|
- application
|
||
|
|
- insights
|
||
|
|
- log
|
||
|
|
- analytics
|
||
|
|
- templates
|
||
|
|
- variables
|
||
|
|
- queries
|
||
|
|
menuTitle: Template variables
|
||
|
|
title: Azure Monitor template variables
|
||
|
|
weight: 400
|
||
|
|
---
|
||
|
|
|
||
|
|
# Azure Monitor template variables
|
||
|
|
|
||
|
|
Instead of hard-coding details such as resource group or resource name values in metric queries, you can use variables.
|
||
|
|
This helps you create more interactive, dynamic, and reusable dashboards.
|
||
|
|
Grafana refers to such variables as template variables.
|
||
|
|
|
||
|
|
For an introduction to templating and template variables, refer to the [Templating]({{< relref "../../../dashboards/variables" >}}) and [Add and manage variables]({{< relref "../../../dashboards/variables/add-template-variables" >}}) documentation.
|
||
|
|
|
||
|
|
## Use query variables
|
||
|
|
|
||
|
|
You can specify these Azure Monitor data source queries in the Variable edit view's **Query Type** field.
|
||
|
|
|
||
|
|
| Name | Description |
|
||
|
|
| ------------------- | -------------------------------------------------------------------------------------------- |
|
||
|
|
| **Subscriptions** | Returns subscriptions. |
|
||
|
|
| **Resource Groups** | Returns resource groups for a specified subscription. |
|
||
|
|
| **Namespaces** | Returns metric namespaces for the specified subscription and resource group. |
|
||
|
|
| **Resource Names** | Returns a list of resource names for a specified subscription, resource group and namespace. |
|
||
|
|
| **Metric Names** | Returns a list of metric names for a resource. |
|
||
|
|
| **Workspaces** | Returns a list of workspaces for the specified subscription. |
|
||
|
|
| **Logs** | Use a KQL query to return values. |
|
||
|
|
| **Resource Graph** | Use an ARG query to return values. |
|
||
|
|
|
||
|
|
Any Log Analytics Kusto Query Language (KQL) query that returns a single list of values can also be used in the Query field.
|
||
|
|
For example:
|
||
|
|
|
||
|
|
| Query | List of values returned |
|
||
|
|
| ----------------------------------------------------------------------------------------- | --------------------------------------- |
|
||
|
|
| `workspace("myWorkspace").Heartbeat \| distinct Computer` | Virtual machines |
|
||
|
|
| `workspace("$workspace").Heartbeat \| distinct Computer` | Virtual machines with template variable |
|
||
|
|
| `workspace("$workspace").Perf \| distinct ObjectName` | Objects from the Perf table |
|
||
|
|
| `workspace("$workspace").Perf \| where ObjectName == "$object"` `\| distinct CounterName` | Metric names from the Perf table |
|
||
|
|
|
||
|
|
### Query variable example
|
||
|
|
|
||
|
|
This time series query uses query variables:
|
||
|
|
|
||
|
|
```kusto
|
||
|
|
Perf
|
||
|
|
| where ObjectName == "$object" and CounterName == "$metric"
|
||
|
|
| where TimeGenerated >= $__timeFrom() and TimeGenerated <= $__timeTo()
|
||
|
|
| where $__contains(Computer, $computer)
|
||
|
|
| summarize avg(CounterValue) by bin(TimeGenerated, $__interval), Computer
|
||
|
|
| order by TimeGenerated asc
|
||
|
|
```
|