Last updated: March 3, 2026
Build Queries
Overview
The Query Builder provides a visual interface for constructing data queries without writing PromQL directly.
It is designed to make complex query construction accessible to users who may not be familiar with PromQL syntax.
Use the Query Builder
When editing a panel, open the Query Builder from the panel's data configuration area.
The builder guides you through selecting metrics, applying filters, and choosing aggregation functions.
The resulting PromQL expression is generated automatically and can be viewed or edited directly.
Add Multiple Queries
A single panel supports multiple independent queries. Each query operates as a separate data source and can target different signal types. Queries can be reordered and individually assigned display colors.
The query panel provides tabs for isolating queries by signal type:
- Services
- Tracing
- Logging
- Metrics
- Web Events
Interpret Query Warnings
When a query returns more time series than the panel's display limit allows, a query warning is shown.
This alerts you that the visualization is incomplete and that you should either refine the query or adjust the panel's limit setting.
