grafana/docs/sources/linking/data-links.md
Diana Payton 15c72c2739
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

3.1 KiB

+++ title = "Data links" keywords = ["grafana", "data links", "documentation", "playlist"] type = "docs" aliases = ["/docs/grafana/latest/reference/datalinks/"] +++

Data links

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 showed four servers, you could add a data link to one or two of them.

The link itself is accessible in different ways depending on the visualization. For the graph you need to click on a data point or line, for a panel like Stat, Gauge, or Bar Gauge you can click anywhere on the visualization to open the context menu.

Note: For stat, gauge, bar gauge, and table visualizations, you add and edit data links on the Field tab. For the graph visualization, you add and edit data links on the Panel tab.

You can use variables in data links to send people to a detailed dashboard with preserved data filters. For example, you could use variables to specify a time range, series, and variable selection. For more information, refer to [Data link variables]({{< relref "data-link-variables.md" >}}).

Typeahead suggestions

When creating or updating a data link, press Cmd+Space or Ctrl+Space on your keyboard to open the typeahead suggestions to more easily add variables to your URL.

{{< docs-imagebox img="/img/docs/data_link_typeahead.png" max-width= "800px" >}}

  1. Hover your cursor over the panel that you want to add a link to and then press e. Or click the dropdown arrow next to the panel title and then click Edit.

  2. On the Field tab, scroll down to the Data links section. (Panel tab for graph visualizations.)

  3. Expand Data links and then click Add link.

  4. Enter a Title. Title is a human-readable label for the link that will be displayed in the UI.

  5. Enter the URL you want to link to.

    You can even add one of the template variables defined in the dashboard. Click in the URL field and then type $ or press Ctrl+Space or Cmd+Space to see a list of available variables. By adding template variables to your panel link, the link sends the user to the right context, with the relevant variables already set. For more information, refer to [Data link variables]({{< relref "data-link-variables.md" >}}).

  6. If you want the link to open in a new tab, then select Open in a new tab.

  7. Click Save to save changes and close the window.

  8. Click Save in the upper right to save your changes to the dashboard.

  1. On the Field tab, find the link that you want to make changes to. (Panel tab for graph visualizations.)
  2. Click the Edit (pencil) icon to open the Edit link window.
  3. Make any necessary changes.
  4. Click Save to save changes and close the window.
  5. Click Save in the upper right to save your changes to the dashboard.
  1. On the Field tab, find the link that you want to delete. (Panel tab for graph visualizations.)
  2. Click the X icon next to the link you want to delete.
  3. Click Save in the upper right to save your changes to the dashboard.