Grafana Status Panel

This project was originally contributed by Vonage - thanks for all your great work!

The previous published version of the plugin relied on AngularJS which is deprecated. We reached out to Vonage to support publishing an updated version based on the changes made in the source repo, but they were unable to pursue this at the time.

We have stepped up for the time being to minimize disruption, but would be happy to hand maintainership back at any point in the future.

We have republished under the same plugin ID, but with the Grafana signature. This means you can simply update your plugin version. A new ID would have required manual updates to your dashboards. We changed the signature to Grafana to reflect the change in publisher and so that it is clear we are not impersonating the original authors. For additional information on the changes, see the Notices.

⚠️ This project is not actively maintained by Grafana Labs. Pull requests are welcome and will be reviewed on a best-effort basis. Contact integrations@grafana.com if you are interested in taking on this project longer term. We will be happy to work with and eventually hand over to people who are interested in maintaining it again.

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

The General Idea

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:

1. 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 of the metrics. This means that if all the metrics are in the OK state, the panel will be green. If even one of the metrics is in the WARNING state, it will be yellow, and red if any of them is CRITICAL.
2. Component disable marker - Set the exact value that represents if the component is disabled, the panel will be grey.
3. Display as text - show extra information about the component in the panel.

Severity and text values can be shown in 2 modes:

1. Regular - under the panel title.
2. Annotation - 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.

How to install (for debugging purposes only)

1. Copy the contents of "Grafana_Status_panel" to the "/var/lib/grafana/plugins" folder
2. Restart grafana by using "service grafana-server restart"
3. Now this panel should be installed.

How to use

1. Add the queries you want to the panel and give each of them a unique alias
2. 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
3. Go to the Options tab, and choose how to treat each metric.
   1. For severity display, select one of the Threshold option types (Number Threshold / String Threshold / Date Threshold) under Handler Type. Enter the Warning and Critical thresholds for each of your queries.
      • You can configure when the alias name and its value will be displayed in the dashboard panel by changing the fields: Display Alias, Display Value
      • String Threshold option makes equality check to the values
      • Number Threshold and Date Threshold options make range check with the values. 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.
   2. For disable display, select the Disable Criteria option type under Handler Type. Enter the Disable Value for each of your queries.
   3. For display the text without any condition, select the Text Only option type under Handler Type. The alias + the value of the metric will be shown on the panel by the Display Type value.
4. If the query returns multiple values, choose the type of aggregation you want to be used (None will use first item from the result)

Other Features

Remove Prefix

The plugins has a 'Remove Prefix' field in the configuration. This field 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 named 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.

Display Value by Regex

When you want to display just part of the value for a specific metric in the screen, you can pass a regex in the Value Regex field, and if there is match, Only the first match will be displayed. Otherwise, the original value will be displayed.

Measurement URL

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 the URL (like an internal wiki).

Threshold preferences

Panel display tuning is available when metric value gets to different states (ok / warning / critical / disabled):

1. You can change the relevant color for each state.
2. You can configure if the color will change the panel background or the metric text.
3. You can change the text format (bold / italic) for metric text in warning / critical / disabled states.

Show disable for no data

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

Supported Data Sources

Currently the plugin was tested with influxDB and Graphite. Support for other data sources could be added by demand

Release Notes

Upgrading Tips

When upgrading there might be some changes in the data the plugin uses and saves, so some of the configurations you made might be removed by accident. To prevent this loss of configuration you should save the panel JSON of all panels you have (by exporting the panel or dashboards) and keep them somewhere safe until you made sure everything is working after the upgrade.

Version 1.0.8 - What's new?

• Adding support for Grafana 5.0.x:
  • Added option to auto scroll the alerts in case the text overflows the panel view
  • Fix header padding when title is absent

Screenshots

Panel States

The end result should look like this

License

See the LICENSE file for license rights and limitations (Apache License, Version 2.0)