Perses Query Builder

Build and optimize queries for Perses dashboard panels.

Overview

This skill constructs, validates, and optimizes queries embedded in Perses panel definitions. It handles PromQL (Prometheus), LogQL (Loki), and TraceQL (Tempo) with correct variable interpolation and datasource binding. The workflow progresses through three phases: identifying query requirements, building the query with proper templating, and optimizing for performance and correctness.

Instructions

Phase 1: IDENTIFY

Goal: Determine query type, datasource, and variable context.

Blockers: Do not proceed if any of these are unresolved (because Perses requires them for runtime resolution and query validation):

1. Datasource unknown — The target datasource name and kind have not been confirmed. Perses resolves datasources at runtime using the kind and name pair; queries cannot be validated without this.