This panel plugin provides a D3-based multi-stat panel for Grafana 8.4+.
A hexagon is created for each metric received, with the ability to group metrics into a composite metric, and display the triggered state of the composite.
This plugin supports autoscaling for best-fit sizing of each polygon to the panel size. When the complete text cannot be displayed, only tooltips are active.
This panel provides a large number of customization options, and are searchable from the menu.
By default the plugin with automatically size the polygons to be displayed using a "best fit" calculation based on the size of the panel.
Alternatively, you can specify both the number of columns and rows manually, or automated only one of them.
Max # of columns to create
Max # rows to create
NOTE: if both columns and rows are set, only rows*columns will be displayed, generally one or none should be set.
If there are not enough columns and rows to display all of the data, a warning will be displayed.
Sets a limit for the number of polygons to be displayed. Set this to 0 for no limit (the default value is 100).
The size of the polygon by default is calculated for a best-fit, but it can be manually set if needed.
This section also provides an option to set a border on each polygon (the default value is 2 pixels).
Deselect the auto-size option to manually set a size.
The size of the border for each polygon can be set in this section. The color used can be found in the "Global" section.
The plugin will attempt to display as much text as possible with the largest font possible across all polygons. The color, font size, and font family can be manually set.
You can also set the font family to be used for the rendered text.
Currently the default is Inter, and migrations will convert from Roboto to Inter
Uncheck "Auto Scale Fonts" to manually enter a font size.
Uncheck "Automate Font Color" to manually set the font color. The automated option uses the current theme to pick a color, which may not be suitable for all cases.
Manually Set Font Color with color picker
The order (left to right) of the displayed polygons can be set with the sort options.
The following directions are supported:
And the following fields:
Toggles displaying tooltips for the panel
Sets the font family to be used in tooltips.
Toggles display of the timestamp at the bottom of the tooltip
You can choose to display only metrics that have triggered a threshold in the tooltip, or display all metrics. This is useful when there are many metrics rolled up into a composite.
When there are no threshold violations, this text will be displayed in the tooltip instead of the metric value. Leave blank if you want to show the value.
The following settings are used by composites when there are multiple metrics to be displayed.
Tooltips have a wider set of sort options to aid in displaying important data "at the top" of the tooltip. You can specify a field and direction to first sort by, plus a secondary field and direction. You can also disable sorting if needed.
| Sort Direction | |
|---|---|
| Disabled | No sorting is performed |
| Alphabetical (asc) | Ascending Alphabetical |
| Alphabetical (desc) | Descending Alphabetical |
| Numerical (asc) | Numerical Ascending |
| Numerical (descending) | Numerical Descending |
| Alphabetical (case insensitive, asc) | Case Insensitive Ascending Alphabetical |
| Alphabetical (case insensitive, desc) | Case Insensitive Descending Alphabetical |
The type of sort to be applied to the tooltip metrics.
Which field to sort by
| Sort By Field | |
|---|---|
| Name | name of the field - after all aliasing |
| Threshold Level | from lowest to highest |
| Value | raw value |
The secondary sorting works in the same manner as primary sorting, but can be in a different direction using a different field/threshold/value. This is applied after primary sorting is performed.
The following settings are available in the Global section, and are detailed below.
You can choose to display only metrics that have triggered a threshold or display all metrics.
| Display Mode | |
|---|---|
| All | All polygons are displayed |
| Triggered | Only polygons with a threshold triggered are displayed |
Text to be displayed in polygon when there are no triggered thresholds and global display mode is set to triggered.
Show the value of the metric along with the name.
This option will display the time of the metric in the polygon.
Presets are provided for the timestamp, and the field will also accept a custom format.
The timestamp can be displayed above or below the value. If the value is not displayed, it will be place where the value is normally rendered.
This allows adjust the timestamp up or down to fine tune placement. Positive values move the timestamp down, negative values move it up.
Currently there are three shapes that can be selected, and each use a best fit method to maximize size to the panel.
Hexagon Pointed Top
Circle
Square
This option will apply a shaded color instead of a uniform color.
This is the color used when there are no thresholds that apply to the metric or composite.
The color of the border for each polygon can be set, and is used along with the size setting above.
All of the unit types are available in this selector and will be applied to the value displayed.
Select which statistic to display for the value. The full set of statistics that Grafana provides are available.
This limits the number of decimals displayed.
This set of thresholds are applied to all metrics that do not have a matching override.
See the section thresholds below for details on how thresholds are evaluated.
This clickthrough URL will be applied to all polygons that do not have an override or composite with a clickthrough specified.
Normally this is enabled, and is intended to prevent malicious data entry.
When checked, this will cause a new tab to be opened when you click on a polygon. For drill-down dashboards, disabling this is recommended.
When checked, this will allow you to set a custom value for the target attribute of the clickthrough.
NOTE: This is only visible when Open in New Tab is disabled.
Specify the content for the target attribute of the clickthrough URL.
Typical values are: _blank|_self|_parent|_top|
This field allows you to specify a regular expression to pick a portion of matching metric names to be rendered instead of the full name.
If you have these 3 Queries, returning a series: Foo-A, values 1,2,3 Bar-B, values 4,5,6 Misc, values 7,8,9
Adding the regular expression: /(Foo|Bar)/, will display:
Specify a regular expression to pick a portion of matching metric names.
Overrides are used to apply additional rendering options for metrics, including custom thresholds and clickthroughs.
This is an example override that sets the unit for metrics that match a regular expression:
The same override with thresholds added:
The final result of the above override with thresholds applied:
New in V2 is the ability to name overrides to find them easier when there are many being created. The label is not rendered on the polygon.
The panel will provide "hints" for metric names, and allow you to enter a regular expression to match multiple metrics.
Sets the maximum number of decimals to be displayed. Leave this empty to show all decimals.
This lets you specify a different statistic to use for the matching metric, and will replace the global statistic. As with the global setting, the full set of statistics Grafana provides are available.
All of the unit types are available in this selector and will be applied to the value displayed. A suffix is typically added by the formatter to indicate the unit like "B/sec" or symbols for temperatures, percentages, and similar.
An override can specify a set of thresholds that are to be applied to the matching metric, and will replace any global threshold settings.
See the section thresholds below for details on how thresholds are evaluated.
Text in this field will be prepended to the rendered metric.
Text in this field will be appended to the rendered metric after any unit text is applied.
Use this to specify an URL to go to when the polygon is clicked on. Regular expression capture groups and template variables are available to form the URL.
For example, if we have multiple metrics like this:
hera_memutil
plex_memutil
And a regular expression for the override:
/(.*)_mem/The capture group $1 can be used in the url:
/dashboard/detail-dash?var-HOSTNAME=$1
The url will end up being:
https://myserver/dashboard/detail-dash?var-HOSTNAME=hera
For more examples using template variables and regular expression capture groups see this section on templating
Normally this is enabled, and is intended to prevent malicious data entry.
When checked, this will cause a new tab to be opened when you click on the polygon. For drill-down dashboards, disabling this is recommended.
When checked, this will allow you to set a custom value for the target attribute of the clickthrough.
NOTE: This is only visible when Open URL in New Tab is disabled. This will override the equivalent global setting.
Specify the content for the target attribute of the clickthrough URL. This will override the equivalent global setting.
Typical values are: _blank|_self|_parent|_top|
There is a menu at the bottom right side of the override that provides additional controls.
Up and Down arrows allow you move the override so you can force a different evaluation priority or simply to group similar overrides together.
Use the "eye" icon to enable/disable the override.
This button will make a copy of the current override and append it to the end of the list. It will have a new name with "Copy" at the end.
This button will delete the override completely.
Composites allow you to combine multiple metrics into a single representation that reflects the "worst" state of the metrics combined. This is useful as a roll-up view of more complex systems being monitored.
When there are multiple metrics to be displayed by a composite, the polygon will cycle through each of them depending on the composite configuration.
This is what two composites look like once they are rendered:
This is the tooltip that is displayed when hovering over the composite:
When there are multiple metrics the rendered polygon will cycle through each of them based on the composite settings.
Here's an example of two composites and their animation sequence:
There are two global settings that apply to all composites.
A toggle is provided to quickly disable all composites from being rendered. Additionally each composite has a hide icon to toggle its visibility.
This setting controls how fast the animation cycle occurs (in milliseconds).
Sets the name of the composite to be rendered. This accepts a regular expression along with template variables.
Capture groups are also supported which allows you to simplify the name displayed using the alias option.
This setting will hide/show the name on the displayed polygon.
This setting will hide/show the values on the displayed polygon.
When this is enabled, the composite is shown along with all of the metrics. Typically this is disabled and just the composite is displayed.
This will override the global display mode for just this composite. As with the global setting, you can choose to display only metrics that have triggered a threshold or display all metrics.
| Display Mode | |
|---|---|
| All | All metrics are displayed |
| Triggered | Only metrics with a threshold triggered are displayed |
Use this to specify an URL to go to when the polygon is clicked on. Regular expression capture groups and template variables are available to form the URL. See the overrides section for details on advanced usage.
Normally this is enabled, and is intended to prevent malicious data entry.
When checked, this will cause a new tab to be opened when you click on the polygon. For drill-down dashboards, disabling this is recommended.
When checked, this will allow you to set a custom value for the target attribute of the clickthrough.
NOTE: This is only visible when Open URL in New Tab is disabled.
Specify the content for the target attribute of the clickthrough URL.
Typical values are: _blank|_self|_parent|_top|
There is a menu at the bottom right side of the composite that provides additional controls.
Up and Down arrows allow you move the composite for easier grouping.
Use the "eye" icon to enable/disable the composite.
This button will make a copy of the current composite and append it to the end of the list. It will have a new name with "Copy" at the end.
This button will delete the composite completely.
The "Add Metric" button is used to append to the list of metrics to be included in the composite.
The editor provides a list of metrics returned by your queries and also accepts a regular expression that may also include template variables.
NOTE: Template variables are expanded first, then the regex is applied to further filter which metrics are included in the composite.
If this has any content, it will be used instead of the metric name.
Capture groups from the metric name plus template variables are available to construct a new name to be displayed.
Using template variables, capture groups, and composite variables are detailed in section below
This is a built-in option in Grafana and behaves in the same manner as documented here.
NOTE: Color assignments are ignored, only threshold colors are applied.
This plugin supports "ranged" states.
Thresholds are expected to be sorted by ascending value, where
T0 = lowest decimal value, any state
TN = highest decimal value, any state
Initial state is set to "ok"
A comparison is made using "greater than or equal to" against the value
If value >= thresholdValue state = X
Comparisons are made in reverse order, using the range between the Nth (inclusive) threshold and N+1 (exclusive)
InclusiveValue = T(n).value
ExclusiveValue = T(n+1).value
When there is no n+1 threshold, the highest value threshold T(n), a simple inclusive >= comparison is made
Example 1: (typical linear)
T0 - 5, ok
T1 - 10, warning
T2 - 20, critical
Value >= 20 (Value >= T2)
10 <= Value < 20 (T1 <= Value < T2)
5 <= Value < 10 (T0 <= Value < T1)
Example 2: (reverse linear)
T0 - 50, critical
T1 - 90, warning
T2 - 100, ok
Value >= 100
90 <= value < 100
50 <= value < 90
Example 3: (bounded)
T0 - 50, critical
T1 - 60, warning
T2 - 70, ok
T3 - 80, warning
T4 - 90, critical
Value >= 90
80 <= Value < 90
70 <= Value < 80
60 <= Value < 70
50 <= Value < 60
The "worst" state is returned after checking every threshold range
Template variables are available in the clickThroughUrl setting, specified by using ${varname}. They can also be passed to another dashboard by appending var-VARNAME=value to the url
/dashboard/xyz?var-VARNAME=${VARNAME}Overrides using regular expressions with capture groups provide addition variables that can be referenced in a clickthroughUrl.
Example:
Regular Expression: /TEMP_(?<A_HOST>.*)_/
Clickthrough URL: /grafana/d/eCLHPr57k/drilldown?orgId=1&var-host=${A_HOST}
The above example will expand the capture named group A_HOST and replace the value in the specified URL.
Each polygon represents either a single metric, or a composite metric
An example drilldown clickthrough url can be specified like this:
dashboard/db/drilldown?var-HOSTNAME=${__cell_name}NOTE: Metrics are sorted using the global options "Sorting" settings. Global filters are also applied before dereferencing is performed.
The name and value of a polygon can be referenced using the following syntax:
- Metric Name:
${__cell_name} - Metric Value:
${__cell} - Metric Raw Value:
${__cell:raw}syntax. By default values are URI encoded. Use this syntax to disable encoding
The names and values of a composite polygon can be referenced using the following syntax:
- Composite Name:
${__composite_name} - Metric Name:
${__cell_name_n} - Metric Value:
${__cell_n} - Metric Raw Value:
${__cell_n:raw}syntax. By default values are URI encoded. Use this syntax to disable encoding
This plugin relies on Plugin Tools, typical build sequence:
yarn install
yarn buildThe code will be parsed then copied into "dist" if "tslint" passes without errors.
For development, you can run:
yarn devA docker-compose.yml file is include for easy development and testing, just run
docker-compose upThen browse to http://localhost:3000
- Grafana 8.4+
Grafana TestData is not enabled by default. To enable it, first navigate to the Plugins section, found in your Grafana main menu. Click the Apps tabs in the Plugins section and select the Grafana TestData App. (Or navigate to http://your_grafana_instance/plugins/testdata/edit to go directly there). Finally click the enable button to enable.
This panel is based on this D3 example:
Many thanks to contributors:
- Mathieu Rollet (matletix)
- Mattias Jiderhamn (mjiderhamn)
- AnushaBoggarapu
- KamalakarGoretta
- Rene Hennig (renehennig)
- Hamza Ziyani (HZiyani)
and many others!
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}
