Docs: Updated data links content (#27110)

* updated content * updated content * Update data-link-variables.md * Update global-variables.md * updated content * Update best-practices-for-managing-dashboards.md * Update docs/sources/linking/data-link-variables.md Co-authored-by: Torkel Ödegaard <torkel@grafana.org> * Update docs/sources/linking/data-link-variables.md Co-authored-by: Torkel Ödegaard <torkel@grafana.org> * Update docs/sources/linking/data-link-variables.md Co-authored-by: Torkel Ödegaard <torkel@grafana.org> * Update docs/sources/linking/data-link-variables.md Co-authored-by: Torkel Ödegaard <torkel@grafana.org> * Update docs/sources/linking/data-links.md Co-authored-by: Torkel Ödegaard <torkel@grafana.org> * Update docs/sources/linking/dashboard-links.md Co-authored-by: Torkel Ödegaard <torkel@grafana.org> * Update dashboard-links.md Co-authored-by: Torkel Ödegaard <torkel@grafana.org>
2020-09-02 07:07:31 -07:00
parent 19c8097595
commit 15c72c2739
9 changed files with 72 additions and 63 deletions
@@ -0,0 +1,55 @@
+++
+title = "URL variables"
+keywords = ["grafana", "url variables", "documentation", "variables", "data link"]
+aliases = ["/docs/grafana/latest/variables/url-variables.md","/docs/grafana/latest/variables/variable-types/url-variables.md"]
+type = "docs"
+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.md" >}}).
+
+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/templates-and-variables.md" >}}) 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.md#__from-and-__to" >}}).
+
+## Series variables
+
+Series specific variables are available under ``__series`` namespace:
+
+* ``__series.name`` - series name to the URL
+* ``__series.labels.<LABEL>`` - label's value to the URL. If your label contains dots use ``__series.labels["<LABEL>"]`` syntax
+
+## Field variables
+
+Field-specific variables are available under ``__field`` namespace:
+
+* ``__field.name`` - the name of the field
+
+## 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.
+
+``var-myvar=${myvar}`` - 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``.