Kubesense

Top List

The Top List visualization displays a ranked list of values, ideal for identifying the highest or lowest contributors in your data.

Top List

When to Use

  • Identifying top services by error count or latency
  • Showing the most active endpoints or users
  • Ranking categories by any aggregated metric
  • Quickly spotting the slowest resources or highest consumers

Building a Top List Panel

  1. Open the Data Explorer
  2. Select your data source (Metrics, Logs, or Traces)
  3. Configure your query with a Group By attribute (see Query Builder)
  4. Set the Sort By and Sort Order to rank results (e.g., DESC for top values)
  5. Set a Limit to control how many items appear in the list
  6. Select Top List as the Panel Type in the right sidebar
  7. Click Run to render the list

In the example above, the panel queries Traces data filtered by protocol:HTTP, with p99 aggregation on duration, grouped by resource. The list is sorted in descending order with a limit of 5, showing the slowest resources by P99 latency. Each row displays a horizontal bar proportional to its value.

Multiple Queries

Add multiple queries to combine ranked data from different sources. Each query is labeled alphabetically (A, B, C, etc.).

Formulas

Use formulas to create computed rankings from your queries. Click Add Formula and enter an expression combining your queries (e.g., A / B). See Time Series — Formulas for more details.

Panel Configuration

Panel Options

OptionDescription
NameDisplay name shown in the panel header
DescriptionOptional description for additional context

Standard Options

OptionDescription
UnitUnit formatter for the displayed values — choose from 100+ units including bytes, percentage, duration, requests/sec, and more
Color PaletteColor scheme for the list bars

Thresholds

Add thresholds to color-code list items based on their values. Enable thresholds in the right sidebar, then click Add Threshold and set the value. Items exceeding a threshold will be highlighted with the corresponding color.