grafana/docs/sources/panels-visualizations/configure-legend/index.md
Jack Baldry 7ef7cedc11
Prepare dashboards, panels, and visualizations for Grafana Cloud mount (#73632)
* Update dashboards pages to use `docs/reference` shortcode

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Update panels-visualizations pages to use `docs/reference` shortcode

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Use raw Markdown admonitions for contextual links

See https://discourse.gohugo.io/t/markdown-reference-links-in-shortcodes/5770/3.
Should be resolved by https://docs.google.com/document/d/19xd4CD3IrAqQqNR3xQeLfuIV-u2iNSQSBEvPZE9J4qU/edit#heading=h.5sybau7waq2q.

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Prefer "Warning" over "Caution"

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

* Prettier

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Fix some links missing destinations

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Fix 'time range controls' link

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Add missing 'HTTP APIs' link

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Fix dashboard links missing destinations

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Fix links missing destinations in panels and visualizations documentation

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Fix dud link

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>

---------

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
2023-09-13 11:39:04 +02:00

4.5 KiB

aliases labels title weight
../panels/working-with-panels/configure-legend/
visualizations/configure-legend/
products
cloud
enterprise
oss
Configure a legend 400

Configure a legend

A panel includes a legend that you can use to interpret data displayed in a visualization. Each legend option adds context and clarity to the data illustrated in a visualization.

Isolate series data in a visualization

Visualizations can often be visually complex, and include many data series. You can simplify the view by removing series data from the visualization, which isolates the data you want to see. Grafana automatically creates a new override in the Override tab.

When you apply your changes, the visualization changes appear to all users of the panel.

  1. Open the panel.

  2. In the legend, click the label of the series you want to isolate.

    The system removes from view all other series data.

  3. To incrementally add series data to an isolated series, press the Ctrl or Command key and click the label of the series you want to add.

  4. To revert back to the default view that includes all data, click any series label twice.

  5. To save your changes so that they appear to all viewers of the panel, click Apply.

This topic currently applies to the following visualizations:

  • [Bar chart][]
  • [Histogram][]
  • [Pie chart][]
  • [State timeline][]
  • [Status history][]
  • [Time series][]

Add values to a legend

As way to add more context to a visualization, you can add series data values to a legend. You can add as many values as you'd like; after you apply your changes, you can horizontally scroll the legend to see all values.

  1. Edit a panel.

  2. In the panel display options pane, locate the Legend section.

  3. In the Legend values field, select the values you want to appear in the legend.

  4. Click Apply to save your changes are navigate back to the dashboard.

Toggle series visibility

Change a series color

By default, Grafana specifies the color of your series data, which you can change.

  1. Edit a panel.

  2. In the legend, click the color bar associated with the series.

  3. Select a pre-set color or a custom color from the color palette.

  4. Click Apply to save your changes are navigate back to the dashboard.

Change legend series color

Sort series

You can change legend mode to Table and choose [calculations][] to be displayed in the legend. Click the calculation name header in the legend table to sort the values in the table in ascending or descending order.

{{% admonition type="note" %}} This feature is only supported in these panels: Bar chart, Histogram, Time series. {{% /admonition %}}

Sort legend series.

{{% docs/reference %}} [Bar chart]: "/docs/grafana/ -> /docs/grafana//panels-visualizations/visualizations/bar-chart" [Bar chart]: "/docs/grafana-cloud/ -> /docs/grafana//panels-visualizations/visualizations/bar-chart"

[State timeline]: "/docs/grafana/ -> /docs/grafana//panels-visualizations/visualizations/state-timeline" [State timeline]: "/docs/grafana-cloud/ -> /docs/grafana//panels-visualizations/visualizations/state-timeline"

[Time series]: "/docs/grafana/ -> /docs/grafana//panels-visualizations/visualizations/time-series" [Time series]: "/docs/grafana-cloud/ -> /docs/grafana//panels-visualizations/visualizations/time-series"

[calculations]: "/docs/grafana/ -> /docs/grafana//panels-visualizations/calculation-types" [calculations]: "/docs/grafana-cloud/ -> /docs/grafana//panels-visualizations/calculation-types"

[Pie chart]: "/docs/grafana/ -> /docs/grafana//panels-visualizations/visualizations/pie-chart" [Pie chart]: "/docs/grafana-cloud/ -> /docs/grafana//panels-visualizations/visualizations/pie-chart"

[Status history]: "/docs/grafana/ -> /docs/grafana//panels-visualizations/visualizations/status-history" [Status history]: "/docs/grafana-cloud/ -> /docs/grafana//panels-visualizations/visualizations/status-history"

[Histogram]: "/docs/grafana/ -> /docs/grafana//panels-visualizations/visualizations/histogram" [Histogram]: "/docs/grafana-cloud/ -> /docs/grafana//panels-visualizations/visualizations/histogram" {{% /docs/reference %}}