|
|
|
@ -1,6 +1,6 @@ |
|
|
|
|
+++ |
|
|
|
|
title = "Variables" |
|
|
|
|
keywords = ["grafana", "templating", "documentation", "guide"] |
|
|
|
|
keywords = ["grafana", "templating", "documentation", "guide", "template", "variable"] |
|
|
|
|
type = "docs" |
|
|
|
|
[menu.docs] |
|
|
|
|
name = "Variables" |
|
|
|
@ -80,6 +80,73 @@ Option | Description |
|
|
|
|
*Regex* | Regex to filter or capture specific parts of the names return by your data source query. Optional. |
|
|
|
|
*Sort* | Define sort order for options in dropdown. **Disabled** means that the order of options returned by your data source query will be used. |
|
|
|
|
|
|
|
|
|
#### Using regex to filter/modify values in the Variable dropdown |
|
|
|
|
|
|
|
|
|
Using the Regex Query Option, you filter the list of options returned by the Variable query or modify the options returned. |
|
|
|
|
|
|
|
|
|
Examples of filtering on the following list of options: |
|
|
|
|
|
|
|
|
|
```text |
|
|
|
|
backend_01 |
|
|
|
|
backend_02 |
|
|
|
|
backend_03 |
|
|
|
|
backend_04 |
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
##### Filter so that only the options that end with `01` or `02` are returned: |
|
|
|
|
|
|
|
|
|
Regex: |
|
|
|
|
|
|
|
|
|
```regex |
|
|
|
|
/.*[01|02]/ |
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
Result: |
|
|
|
|
|
|
|
|
|
```text |
|
|
|
|
backend_01 |
|
|
|
|
backend_02 |
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
##### Filter and modify the options using a regex capture group to return part of the text: |
|
|
|
|
|
|
|
|
|
Regex: |
|
|
|
|
|
|
|
|
|
```regex |
|
|
|
|
/.*(01|02)/ |
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
Result: |
|
|
|
|
|
|
|
|
|
```text |
|
|
|
|
01 |
|
|
|
|
02 |
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
#### Filter and modify - Prometheus Example |
|
|
|
|
|
|
|
|
|
List of options: |
|
|
|
|
|
|
|
|
|
```text |
|
|
|
|
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000 |
|
|
|
|
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000 |
|
|
|
|
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000 |
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
Regex: |
|
|
|
|
|
|
|
|
|
```regex |
|
|
|
|
/.*instance="([^"]*).*/ |
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
Result: |
|
|
|
|
|
|
|
|
|
```text |
|
|
|
|
demo.robustperception.io:9090 |
|
|
|
|
demo.robustperception.io:9093 |
|
|
|
|
demo.robustperception.io:9100 |
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
### Query expressions |
|
|
|
|
|
|
|
|
|
The query expressions are different for each data source. |
|
|
|
|