Top List
The Top List panel ranks metric values and displays them in list format. Use it to identify the highest or lowest values for a specific metric across labels such as hosts, namespaces, or services.
Add a Top List Panel
-
Open the dashboard where you want the panel.
-
Click Add Panel.
-
In Choose Visualization, select Top List.
-
In Graph your data, click Select a metric to start building your query.
-
Enter a descriptive Title.
-
Click Save to add the panel.
Build queries (Graph your data)
The query builder defines which metrics are ranked and how they are displayed.
-
Click Add Query to create a query. Repeat to add more.
-
Click Select a metric to choose the metric name.
-
Use From to pick the metric source or namespace.
-
Click Add Label to group results by label values (for example,
host,pod,region). -
Select an Aggregation (for example,
sum,avg,max,min) to combine values per label. -
Use the Select dropdown (if available) to set the aggregation interval.
-
Click Add Functions to apply transformations (for example, scaling or unit conversion).
|
If multiple queries are added, you can sort and display results from each independently or combine them using formulas. |
Configure ranking
-
Sort order — Choose ascending (lowest first) or descending (highest first).
-
Limit — Set the number of results to display (for example, Top 5, Top 10).
-
Display units — Apply unit formatting to values (for example, bytes, ms, percentage).
Apply functions
Functions let you modify the values before ranking.
Examples: * scale() — Multiply all values by a constant. * round() — Reduce decimal precision. * moving_avg() — Smooth values before sorting.
|
Applying expensive transformations to large datasets can impact performance. Test with shorter time ranges when building complex panels. |
Add formulas
Formulas can calculate new values before ranking.
Example — double the values:
2*a
Example — compute percentage change between two queries:
((a - b) / b) * 100
|
Use short aliases ( |
