Query and analyze metric data

Log Service validates PromQL syntax in real time as you type.

• Valid syntax

  If The syntax is valid. appears, validation succeeded and a syntax parsing tree is generated.

• Invalid syntax

  If an error message appears, validation failed. A partial syntax tree shows the error location and cause.

  In this example, [5] is missing a time unit (m, s, or h), causing the error 4:1 parse error: unexpected <aggr:sum>:

  label_replace(
  sum by(pod_name)(
  rate(container_cpu_usage_seconds_total{namespace= "redash"}[5])
  ), "pod", "$1", "pod_name", "(.+)"
  )

During validation, you can also:

• Click the icon to refresh the syntax parsing tree.

• Click the icon to simplify the node information in the syntax parsing tree.

• Click the or icon to expand or collapse nodes.

• Click the or icon to enable or disable the automatic tree parsing feature.

Click Metrics Explore to browse metrics and their label data. Use the search bar to filter metrics by name. The results table lists metrics such as cpu_count, cpu_guest_util, and cpu_sys_util, along with the total count and time range. Each metric provides Continue to Explore, Copy, and Add actions.

On the Metrics Explore panel:

• Set a time range: The default time range is 5 minutes. To change it, click Change to modify the time range.

  Click the icon to reset the time range.

• Filter metrics: In the search box, enter a metric name to filter metrics.

• Copy a metric name: Click the icon to copy the metric name.

• Add to the query box: Click the icon to add the metric name to the query box.

• Continue to explore: Click Continue to Explore to view label keys, unique value counts, and sample values for a metric.

  Click Filter to filter by label values using four PromQL operators, selectable or manual conditions, and regular expressions.

  The system generates a query based on your filters. Click Copy Query Statement or Add to Search Box to run the query.

By default, legend names combine the metric name and labels. Use {{value_name}} variables to reference specific label values. For example, if a label is {ip="192.0.2.1"}, setting Legend Format to {{ip}} displays 192.0.2.1 as the legend name. Enter a custom format in the Legend Format input box below the query input box.