mirror of
https://github.com/grafana/grafana.git
synced 2025-07-29 11:42:36 +08:00

* new refactored panel docs * fixed links * removed xtra sharing link, added links to panel display option tasks * fixed typo * add aliases * incorporate PM feedback * intermediate commit to resolve merge conflict * final changes to resolve merge conflicts
57 lines
2.2 KiB
Markdown
57 lines
2.2 KiB
Markdown
+++
|
|
title = "Status history"
|
|
description = "Status history visualization"
|
|
keywords = ["grafana", "docs", "status history", "panel"]
|
|
aliases = ["/docs/grafana/latest/panels/visualizations/status-history/"]
|
|
weight = 900
|
|
+++
|
|
|
|
# Status history
|
|
|
|
The Status history visualization shows periodic states over time. Each field or series is rendered as a horizontal row. Boxes are rendered and centered around each value.
|
|
|
|
{{< figure src="/static/img/docs/status-history-panel/status-history-example-v8-0.png" max-width="1025px" caption="Status history example" >}}
|
|
|
|
## Supported data
|
|
|
|
Status history visualization works with string, boolean and numerical fields or time series. A time field is required. You can use value mappings to color strings or assign text values to numerical ranges.
|
|
|
|
## Display options
|
|
|
|
Use these options to refine the visualization.
|
|
|
|
### Show values
|
|
|
|
Controls whether values are rendered inside the value boxes. Auto will render values if there is sufficient space.
|
|
|
|
### Column width
|
|
|
|
Controls the width of boxes. 1 = maximum space and 0 = minimum space.
|
|
|
|
### Line width
|
|
|
|
Controls line width of state regions.
|
|
|
|
### Fill opacity
|
|
|
|
Controls the opacity of state regions.
|
|
|
|
## Value mappings
|
|
|
|
To assign colors to boolean or string values, use the [Value mappings](< {{ refref "../value-mappings.md"}} >).
|
|
|
|
{{< figure src="/static/img/docs/v8/value_mappings_side_editor.png" max-width="300px" caption="Value mappings side editor" >}}
|
|
|
|
## Time series data with thresholds
|
|
|
|
The panel can be used with time series data as well. In this case, the thresholds are used to color the boxes. You can also
|
|
use gradient color schemes to color values.
|
|
|
|
{{< figure src="/static/img/docs/v8/state_timeline_time_series.png" max-width="1025px" caption="state timeline with time series" >}}
|
|
|
|
## Legend options
|
|
|
|
When the legend option is enabled it can show either the value mappings or the threshold brackets. To show the value mappings in the legend, it's important that the `Color scheme` as referenced in [Apply color to a series and fields]({{< relref "../panels/working-with-panels/apply-color-to-series.md" >}}) is set to `Single color` or `Classic palette`. To see the threshold brackets in the legend set the `Color scheme` to `From thresholds`.
|
|
|
|
{{< docs/shared "visualizations/legend-mode.md" >}}
|