Skip to content

Aggregate Graphs With Group Selectors

Some aggregate graphs need more than the current group as input.

This page documents the group selector pattern used on the Group page for those graphs.

Overview

When an aggregate graph defines selector metadata, the Group page renders extra group pickers automatically.

  • The current page group is always group_id.
  • Additional selected groups are passed as group_id_b, group_id_c, and so on.
  • URLs are shareable/bookmarkable because selector values are part of the URL.

User Experience

  • If a graph has one selector, the page auto-refreshes when you pick a value.
  • If a graph has multiple selectors, an Apply button is shown so you can set all values first.

Currently Available Selector-Based Graphs

Sensor Groups

  • PUE (Facility/IT) (agg_graph=pue)
  • group_id: Facility power group
  • group_id_b: IT power group

Port Groups

  • Bits Compare (2 Groups) (agg_graph=bits_compare2)
  • group_id: Primary port group

  • group_id_b: Comparison port group

  • Bits Compare (3 Groups) (agg_graph=bits_compare3)

  • group_id: Primary port group
  • group_id_b: Comparison port group B
  • group_id_c: Comparison port group C

URL Examples

Text Only
1
2
3
/group/group_id=46/view=basic/agg_graph=pue/group_id_b=47/
/group/group_id=10/view=basic/agg_graph=bits_compare2/group_id_b=11/
/group/group_id=10/view=basic/agg_graph=bits_compare3/group_id_b=11/group_id_c=12/

For Developers

Selector metadata is declared in the entity definition for an aggregate graph:

PHP
1
2
3
'group_selectors' => [
  [ 'var' => 'group_id_b', 'label' => 'Compare Group', 'entity_type' => 'port' ]
]

Selector fields:

  • var: selector variable name (group_id_b, group_id_c, ...)
  • label: UI label in the Group page form
  • entity_type: group type to list (port, sensor, ...)
  • allow_current: optional, allow selecting the current group