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.

Major Features

  • Toplist supports executing multiple queries.

  • Segmentation is supported for all queries.

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

    • If there is a single query without segmentation, the query name is displayed.

    • If there is a single query and multiple segmentations are selected, segmentation texts separated by > sign are displayed.

    • If there are multiple queries, the query name is displayed on the bar.

Segmentation

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.

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

Configure Display Fields

When you specify the time display fields of a Toplist query, you can configure the time series display name using text and values of any of the configured segments as variables, for example, CPU usage % for {{host_hostname}}. In addition to segments as variables, you can also display the value of the query, for example, CPU usage % with value: {{__values__}}