grafana/docs/sources/visualizations/_index.md
achatterjee-grafana e32e135c73
Docs move "visualizations" folder up one level in TOC (#38523)
* Moved Visualizations folder one level up. Fixed a bunch of broken relrefs.

* More broken relrefs.

* Fixed the last of the broken relrefs

* Adjusted weight and added alias.

* Added aliases to a bunch of visualization topics.

* More topics with aliases.

* More aliases, adjusted some weight and other metadata information.
2021-08-25 14:14:00 -04:00

4.6 KiB

+++ title = "Visualizations" weight = 75 aliases = ["/docs/grafana/latest/panels/visualizations/"] +++

Visualization panels

Grafana offers a variety of visualizations to support different use cases. This section of the documentation highlights the built-in panels, their options and typical usage.

  • Graphs & charts
    • [Time series]({{< relref "./time-series/_index.md" >}}) is the default and main Graph visualization.
    • [State timeline]({{< relref "./state-timeline.md" >}}) for state changes over time.
    • [Status history]({{< relref "./status-history.md" >}}) for periodic state over time.
    • [Bar chart]({{< relref "./bar-chart.md" >}}) shows any categorical data.
    • [Histogram]({{< relref "./histogram.md" >}}) calculates and shows value distribution in a bar chart.
    • [Heatmap]({{< relref "./heatmap.md" >}}).
    • [Pie chart]({{< relref "./pie-chart-panel.md" >}}).
  • Stats & numbers
    • [Stat]({{< relref "./stat-panel.md" >}}) for big stats and optional sparkline.
    • [Gauge]({{< relref "./gauge-panel.md" >}}) is a normal radial gauge.
    • [Bar gauge]({{< relref "./bar-gauge-panel.md" >}}) is a horizontal or vertical bar gauge.
  • Misc
    • [Table]({{< relref "./table/_index.md" >}}) is the main and only table visualization.
    • [Logs]({{< relref "./logs-panel.md" >}}) is the main visualization for logs.
    • [Node Graph]({{< relref "./node-graph.md" >}}) for directed graphs or networks.
  • Widgets
    • [Dashboard list]({{< relref "./dashboard-list-panel.md" >}}) can list dashboards.
    • [Alert list]({{< relref "./alert-list-panel.md" >}}) can list alerts.
    • [Text panel]({{< relref "./alert-list-panel.md" >}}) can show markdown and html.
    • [News panel]({{< relref "./news-panel.md" >}}) can show RSS feeds.

Get more

You can add more visualization types by installing panel panel plugins.

Examples

Below you can find some good examples for how all the visualizations in Grafana can be configured. You can also explore play.grafana.org which has a large set of demo dashboards that showcase all the different visualizations.

Graphs

For time based line, area and bar charts we recommend the default [Time series]({{< relref "./time-series/_index.md" >}}) visualization. This public demo dashboard contains many different examples for how this visualization can be configured and styled.

{{< figure src="/static/img/docs/time-series-panel/time_series_small_example.png" max-width="700px" caption="Time series" >}}

For categorical data use the [Bar chart]({{< relref "./bar-chart.md" >}}) visualization.

{{< figure src="/static/img/docs/bar-chart-panel/barchart_small_example.png" max-width="700px" caption="Bar chart" >}}

Big numbers & stats

The Stat visualization shows one large stat value with an optional graph sparkline. You can control the background or value color using thresholds or color scales.

{{< figure src="/static/img/docs/v66/stat_panel_dark3.png" max-width="1025px" caption="Stat panel" >}}

Gauge

If you want to present a value as it relates to a min and max value you have two options. First a standard [Radial Gauge]({{< relref "./gauge-panel.md" >}}) shown below.

{{< figure src="/static/img/docs/v66/gauge_panel_cover.png" max-width="700px" >}}

Secondly Grafana also has a horizontal or vertical [Bar gauge]({{< relref "./bar-gauge-panel.md" >}}) with three different distinct display modes.

{{< figure src="/static/img/docs/v66/bar_gauge_lcd.png" max-width="700px" >}}

Table

To show data in a table layout, use the [Table]({{< relref "./table/_index.md" >}}) visualization.

{{< figure src="/static/img/docs/tables/table_visualization.png" max-width="700px" lightbox="true" caption="Table visualization" >}}

Pie chart

Grafana now ships with an included [Pie chart]({{< relref "./pie-chart-panel.md" >}}) visualization.

{{< figure src="/static/img/docs/pie-chart-panel/pie-chart-example.png" max-width="700px" lightbox="true" caption="Pie chart visualization" >}}

Heatmaps

To show value distribution over, time use the [heatmap]({{< relref "./heatmap.md" >}}) visualization.

{{< figure src="/static/img/docs/v43/heatmap_panel_cover.jpg" max-width="1000px" lightbox="true" caption="Heatmap" >}}

State timeline

The state timeline panel visualization shows discrete state changes over time. When used with time series, the thresholds are used to turn the numerical values into discrete state regions.

{{< figure src="/static/img/docs/v8/state_timeline_strings.png" max-width="700px" caption="state timeline with string states" >}}