mirror of
https://github.com/grafana/grafana.git
synced 2025-02-25 18:55:37 -06:00
1b091454ec
As documented under [Advanced variable format options – Query parameters](https://grafana.com/docs/grafana/latest/variables/advanced-variable-format-options/#query-parameters), the option is `queryparam`, not `queryparams`. I have verified in Grafana 8.5.3 that the former works while the latter doesn't.
63 lines
2.4 KiB
Markdown
63 lines
2.4 KiB
Markdown
---
|
|
aliases:
|
|
- /docs/grafana/latest/linking/data-link-variables/
|
|
- /docs/grafana/latest/variables/url-variables/
|
|
- /docs/grafana/latest/variables/variable-types/url-variables/
|
|
keywords:
|
|
- grafana
|
|
- url variables
|
|
- documentation
|
|
- variables
|
|
- data link
|
|
title: URL variables
|
|
weight: 400
|
|
---
|
|
|
|
# Data link variables
|
|
|
|
You can use variables in data links to refer to series fields, labels, and values. For more information about data links, refer to [Data links]({{< relref "data-links/" >}}).
|
|
|
|
To see a list of available variables, type `$` in the data link **URL** field to see a list of variables that you can use.
|
|
|
|
> **Note:** These variables changed in 6.4 so if you have an older version of Grafana, then use the version picker to select docs for an older version of Grafana.
|
|
|
|
You can also use template variables in your data links URLs, refer to [Templates and variables]({{< relref "../variables/" >}}) for more information on template variables.
|
|
|
|
## Time range panel variables
|
|
|
|
These variables allow you to include the current time range in the data link URL.
|
|
|
|
- `__url_time_range` - current dashboard's time range (i.e. `?from=now-6h&to=now`)
|
|
- `$__from and $__to` - For more information, refer to [Global variables]({{< relref "../variables/variable-types/global-variables/#__from-and-__to" >}}).
|
|
|
|
## Series variables
|
|
|
|
Series specific variables are available under `__series` namespace:
|
|
|
|
- `__series.name` - series name to the URL
|
|
|
|
## Field variables
|
|
|
|
Field-specific variables are available under `__field` namespace:
|
|
|
|
- `__field.name` - the name of the field
|
|
- `__field.labels.<LABEL>` - label's value to the URL. If your label contains dots, then use `__field.labels["<LABEL>"]` syntax.
|
|
|
|
## Value variables
|
|
|
|
Value-specific variables are available under `__value` namespace:
|
|
|
|
- `__value.time` - value's timestamp (Unix ms epoch) to the URL (i.e. `?time=1560268814105`)
|
|
- `__value.raw` - raw value
|
|
- `__value.numeric` - numeric representation of a value
|
|
- `__value.text` - text representation of a value
|
|
- `__value.calc` - calculation name if the value is result of calculation
|
|
|
|
## Template variables
|
|
|
|
When linking to another dashboard that uses template variables, select variable values for whoever clicks the link.
|
|
|
|
`${myvar:queryparam}` - where `myvar` is a name of the template variable that matches one in the current dashboard that you want to use.
|
|
|
|
If you want to add all of the current dashboard's variables to the URL, then use `__all_variables`.
|