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