grafana/docs/sources/administration/correlations/_index.md
Kristina aa2f74a6c6
Navigation: More updates to the docs for admin subsections (#78857)
* Add more subnav to docs

* Add bold around UX text
2023-11-30 08:19:07 -06:00

2.1 KiB

keywords labels title weight
correlations
Explore
products
enterprise
oss
Correlations 900

Correlations

You can create interactive links for Explore visualizations to run queries related to presented data by setting up Correlations.

A correlation defines how data in one [data source]({{< relref "../../datasources" >}}) is used to query data in another data source. Some examples:

  • an application name returned in a logs data source can be used to query metrics related to that application in a metrics data source, or
  • a user name returned by an SQL data source can be used to query logs related to that particular user in a logs data source

[Explore]({{< relref "../../explore" >}}) takes user-defined correlations to display links inside the visualizations. You can click on a link to run the related query and see results in [Explore Split View]({{< relref "../../explore#split-and-compare" >}}).

Explore visualizations that currently support showing links based on correlations:

  • [Logs Panel]({{< relref "./use-correlations-in-visualizations#correlations-in-logs-panel">}})
  • [Table]({{< relref "./use-correlations-in-visualizations#correlations-in-table">}})

You can configure correlations using [provisioning]({{< relref "../provisioning" >}}), the Administration > Plugins and data > Correlations page in Grafana or directly in [Explore]({{< relref "../../explore/correlations-editor-in-explore" >}}).

{{% admonition type="note" %}} Correlations are available in Grafana 10.0+ as an opt-in beta feature. Modify the Grafana [configuration file]({{< relref "../../setup-grafana/configure-grafana#configuration-file-location" >}}) to enable the correlations [feature toggle]({{< relref "../../setup-grafana/configure-grafana#feature_toggles" >}}) to use it. {{% /admonition %}}

{{< figure src="/static/img/docs/correlations/correlations-in-explore-10-0.gif" alt="Demonstration of following a correlation link in Grafana Explore" caption="Correlations links in Explore" >}}

See also:

{{< section >}}