mirror of
https://github.com/timberjoegithub/grafana-statusmap.git
synced 2026-07-21 23:42:03 +00:00
90 lines
3.1 KiB
Markdown
90 lines
3.1 KiB
Markdown
# Statusmap panel for Grafana
|
|
|
|
|
|
|
|
## Features
|
|
|
|
* Group values into rows and buckets by query's legend
|
|
* User defined color mapping
|
|
* Multiple values in bucket display in tooltip
|
|
* Interval shaping to better visual representation
|
|
* Represent null values as empty bucket or as zero value
|
|
|
|
### Supported environment
|
|
|
|
* Prometheus datasource
|
|
* Tested with Grafana 5.1.3
|
|
|
|
|
|
## Motivation
|
|
|
|
This plugin emerges from our needs to visually represent history of changes for a set of objects
|
|
with discrete statuses.
|
|
_Objects_ can be hosts, Kubernetes pods or coffee makers and _discrete statuses_ are a set
|
|
of predefined values: something like `ok` = 0, `off` = 1, `fail` = 2.
|
|
|
|
## Configuration
|
|
|
|
Recommended setup is to create query for each possible status value with similar legend:
|
|
|
|
|
|
|
|
Next define color mapping for status values in __Discrete__ color mode.
|
|
|
|
|
|
|
|
|
|
__Spectrum__ and __Opacity__ color modes works as in a [Heatmap](https://grafana.com/plugins/heatmap) plugin.
|
|
|
|
|
|
### More options
|
|
|
|
|
|
|
|
__Multiple values__ check determine multiple values display mode. If check is unset then multiple values
|
|
for one bucket treated as error. If check is on then color for bucket determined
|
|
by value with least index in color mapping.
|
|
|
|
|
|
|
|
__Null values__ can be treated as empty buckets or displayed as color of 0 value.
|
|
|
|
|
|
|
|
__Min width__ and __spacing__ are determine minimal bucket width and vertical and horizontal spacing between buckets.
|
|
__Rounding__ is for round edges.
|
|
|
|
|
|
|
|
|
|
## Development
|
|
|
|
The easy way to test and develop plugin is to run Grafana instance in docker with following command in the directory containing the plugin.
|
|
This will expose the local plugin on your machine to the Grafana container.
|
|
|
|
```
|
|
docker run --rm -it -v $PWD:/var/lib/grafana/plugins/flant-statusmap-panel \
|
|
-p 3000:3000 --name grafana.docker \
|
|
--env=GF_USERS_DEFAULT_THEME=light \
|
|
grafana/grafana:5.1.3
|
|
```
|
|
|
|
Now run `grunt` to compile dist directory and start changes watcher:
|
|
|
|
```
|
|
grunt watch
|
|
```
|
|
|
|
## Acknowledgements
|
|
|
|
Idea of a plugin comes from Dmitry Stolyarov @distol, initial version written by Sergey Gnuskov @gsmetal and final changes made by Ivan Mikheykin @diafour.
|
|
|
|
This plugin is based on a "Heatmap" panel by Grafana and inspired by ideas from Carpet plot, Discrete panel, Status Panel, Status Dot, Status By Group.
|
|
|
|
#### Changelog
|
|
|
|
##### v0.0.1
|
|
|
|
- First public release
|
|
|