Query profile data

The Pyroscope data source query editor gives you access to a profile type selector, a label selector, and collapsible options.

Query editor
Figure 1. Query editor

To access the query editor:

  1. Sign into Grafana or Grafana Cloud.

  2. Select your Pyroscope data source.

  3. From the menu, choose Explore.

  4. Select a profile type from the drop-down menu.

    Profile selector

    image::select-profile.png

  5. Use the labels selector input to filter by labels. Pyroscope uses similar syntax to Prometheus to filter labels. Refer to Pyroscope documentation for available operators and syntax.

    While the label selector can be left empty to query all profiles without filtering by labels, the profile type or app must be selected for the query to be valid.

    Grafana doesn’t show any data if the profile type or app isn’t selected when a query runs.

    Labels selector

    image::labels-selector.png

  6. Expand the Options section to view Query Type and Group by. image::options-section.png

  7. Select a query type to return the profile data. Data is shown in the Flame Graph, metric data visualized in a graph, or both. You can only select both options in Explore. The panels used on dashboards allow only one visualization.

Using Group by, you can group metric data by a specified label. Without any Group by label, metric data aggregates over all the labels into single time series. You can use multiple labels to group by. Group by only effects the metric data and doesn’t change the profile data results.

Profiles query results

Profiles can be visualized in a flame graph. Refer to the Flame Graph documentation to learn about the visualization and its features.

Flame graph

image::flame-graph.png

Pyroscope returns profiles aggregated over a selected time range. The absolute values in the flame graph grow as the time range gets bigger while keeping the relative values meaningful. You can zoom in on the time range to get a higher granularity profile up to the point of a single scrape interval.

Metrics query results

Metrics results represent the aggregated sum value over time of the selected profile type.

Metrics graph

image::metric-graph.png

This allows you to quickly see any spikes in the value of the scraped profiles and zoom in to a particular time range.