Toplist

A Toplist chart displays the specified number of entities, such as containers, with the most or least of any metric value. This is useful for "ranking" metric values in order, for example, considering hosts that have the highest amount of pods running or the highest consumers of CPU or memory in your infrastructure.

The following types of metric segmentation are supported:

Major Features

  • Toplist supports executing only one query, however, adding a new one and deleting the existing one is allowed.

  • Segmentation is not supported for multiple metrics.

  • Text displayed on the bars in the chart is based on metrics and segmentation.

    • If a single metric is selected, segmentation text is displayed.

    • If multiple segmentations are selected, segmentation texts separated by > sign are displayed.

    • If multiple metrics are selected, the metric name is displayed.

Segmentation

The following types of metric segmentation are supported:

Multi-Segmenting Single Metrics

You can use multiple objects to simultaneously segment a single metric. For example, cpu.used.percent segmented by kubernetes.cluster.name, kubernetes.namespace.name, and kubernetes.deployment.name.

multi-segment.png

In this example, deployments are sequentially listed in the order of resource consumption. Use Display to toggle between descending (Top) and ascending order (Bottom).

Multi-Metrics Without Segmentation

You can add multiple metrics to view the Toplist chart. However, segmentation is disabled for multi-metric selection.

multi-metrics.png

For information on configuring a chart, see Create a New Panel.