This is a plugin meant to be used as a centralized view for the status of component in a glance. It is very similar to the Single Stat panel, but it can hold multiple values from the same data source. Each value can be used to customize the panel in different ways:
- Mark the severity of the component
- Mark if the component is disabled
- Show extra data in the panel about the component
Lets say that you want to monitor a bunch of servers, and you want to keep track of multiple stats for each of them, and see in a glance the status of all of them.
This plugin will make it easier to do. You just add all the metrics you want to track, and choose how you want their values to be treated:
- Component severity marker - Set the threshold for each and you get an overview that will report to you if there is anything wrong with any metrics. That means that if all the metrics are in the OK zone, the panel will be green. If evan one of the metrics is in the WARNING zone, it will be yellow, and red if any of them is CRITICAL.
- Component disable marker - Set the exact value that represent if the component is disabled, the panel will be grey.
- Annotation - show extra information about the component in the top left side of the panel.
Note: The disable markers are prioritized over the severity ones.
You can also repeat the panel on a template if you have multiple instances that you want to watch.
- Copy the contents of "Grafana_Status_panel" to the "/var/lib/grafana/plugins" folder
- Restart grafana by using "service grafana-server restart"
- Now this panel should be installed.
- Add the queries you want to the panel and give each of them a unique alias
- Choose the name of the panel to be displayed in the
Panel Title
field. Note: this field supports Grafana templates, so if you repeat the panel the correct name will show - Go the the Options tab, and choose the how to treat each metric.
- For severity disply, select the
Threshold
option type underStatus Type
. Enter theWarning
andCritical
thresholds for each of your queries.- If you want the result to always be displayed with it's value (regardless to the thresholds), check the box titled
Show Value
- The plugin automatically detects if higher values are good, or lower values are good by checking which threshold is higher/lower. i.e. if in your metric higher values are better, put a lower value in the "critical" threshold than the "warning" threshold.
- If you want the result to always be displayed with it's value (regardless to the thresholds), check the box titled
- For disable display, select the
Disable Criteria
option type under "Status Type". Enter theDisable Value
for each of your queries. - For annotation, select the "Annotation" option type under "Status Type". The alias + the value of the metric will be shown on the top left.
- For severity disply, select the
- If the query returns multiple values, choose the type of aggregation you want to be used (
None
will just use the most first result)
The plugins has a 'Remove Prefix' field in the configuration. This field is is meant for easier renaming of the panels when you repeat them from a Grafana template.
i.e. you recognize your servers by domain, and they are all name in the following way www.general-prefix.server.com
, and you would like to remove the prefix from the display, then you enter www.general-prefix.
and all the panels will only display the server.com
part.
Lets say that you want your user to be able to get instructions on what to do when a certain metric is at Warning or Critical levels. Just put a link in this field and the name will become clickable, and send your user to any URL you desire (like an internal wiki).
If there is not data from any of the metrics, you can show the panel as disabled (in Grey), by checking the value Make panel gray when no data
on the top of the options tab
Currently the plugin was tested with influxDB and Graphite. Support for other data sources could be added by demand
See the LICENSE file for license rights and limitations (Apache License, Version 2.0)