diff --git a/docs/sources/panels-visualizations/configure-data-links/index.md b/docs/sources/panels-visualizations/configure-data-links/index.md index 683e1a8a9de..d265641034c 100644 --- a/docs/sources/panels-visualizations/configure-data-links/index.md +++ b/docs/sources/panels-visualizations/configure-data-links/index.md @@ -26,13 +26,23 @@ weight: 80 # Configure data links -You can use data link variables or data links to create links between panels. +Data links allow you to provide more granular context to your links. You can create links that include the series name or even the value under the cursor. For example, if your visualization shows four servers, you can add a data link to one or two of them. You can also link panels using data links. + +The link itself is accessible in different ways depending on the visualization. For the time series visualization you need to click a data point or line: + +![Time series visualization with a data link displayed](/media/docs/grafana/panels-visualizations/screenshot-time-series-data-link-v10.3.png) + +For visualizations like stat, gauge, or bar gauge you can click anywhere on the visualization to open the context menu: + +![Stat visualization with a data link displayed](/media/docs/grafana/panels-visualizations/screenshot-stat-data-link-v10.3.png) + +If there's only one data link in the visualization, clicking anywhere on the visualization opens the link rather than the context menu. ## 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](#data-links). +Variables in data links let you send people to a detailed dashboard with preserved data filters. For example, you could use variables to specify a label, time range, series, or variable selection. -To see a list of available variables, type `$` in the data link **URL** field to see a list of variables that you can use. +To see a list of available variables, enter `$` in the data link **URL** field. {{% admonition type="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. @@ -40,50 +50,61 @@ These variables changed in 6.4 so if you have an older version of Grafana, then Azure Monitor, [CloudWatch][], and [Google Cloud Monitoring][] have pre-configured data links called _deep links_. -You can also use template variables in your data links URLs, refer to [Templates and variables][] for more information on template variables. +You can also use template variables in your data links URLs. For more information, refer to [Templates and variables][]. -## Time range panel variables +### Time range panel variables -These variables allow you to include the current time range in the data link URL. +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][]. +| Variable | Description | +| ------------------ | ------------------------------------------------------------------- | +| `__url_time_range` | Current dashboard's time range (for example, `?from=now-6h&to=now`) | +| `__from` | For more information, refer to [Global variables][]. | +| `__to` | For more information, refer to [Global variables][]. | -## Series variables +### Series variables Series-specific variables are available under `__series` namespace: -- `__series.name` - series name to the URL +| Variable | Description | +| --------------- | ---------------------- | +| `__series.name` | Series name to the URL | -## Field variables +### Field variables Field-specific variables are available under `__field` namespace: -- `__field.name` - the name of the field -- `__field.labels.