Skip to main content

OpenMetrics Explorer

The OpenMetrics Explorer is a tool that lets you directly query and analyze metrics collected by OpenAgent. Enter a PromQL-format query to immediately view charts and raw data.

Accessing the Explorer​

Navigate to OpenMetrics > OpenMetrics Explorer in the project menu.

  • Click the WhaTap AI button to use WhaTap AI features.

Screen Layout​

The Explorer screen is divided into the Search area, Graph section, and Raw section.

Search area​

ElementDescription
Query type selectorSelect Series or Instant type. Series queries interval data; Instant queries data at a specific point in time.
Time selectorSelect the query period down to the minute. Supports querying up to 31 days of data at a time.
Query inputEnter a PromQL-format query to retrieve the desired data. When Series type is selected, a subquery matching the interval is automatically executed.
+ Add to dashboard buttonAdds the currently viewed metric chart to a Flex board. Flex board edit permission is required.

How to Query Metrics​

  1. Select Series or Instant from the query type selector.

  2. Set the query period in the time selector. Minute-level selection is available, with a maximum range of 31 days.

  3. Enter a PromQL-format query in the query input. In Series type, a subquery matching the entered interval is automatically executed.

  4. Query results are displayed separately in the Graph section (supported in Series type only) and the Raw section.

  5. For frequently used metric charts, click the + Add to dashboard button to save them to a Flex board. Flex board edit permission is required.

Metrics without HELP comments​

Metrics that an exporter exposes without # HELP and # TYPE comments also appear in the metric list and in the metric list of Alert once their values are collected. These metrics are shown without a description, with the type untyped.

  • Metric names are recorded per day, and up to 20,000 per project per day are added to the list.

  • In on-premises environments, you can disable this feature with the collection server option openmx_name_index_enabled (default true), and change the daily recording limit with openmx_name_index_max_per_day (default 20000).

Graph Section​

Supported in Series type only. Displays collected metrics as a time-series chart. Use the Line / Bar toggle button on the right side of the section to switch chart types.

Series distinction criteria​

Each series (line) in the graph is distinguished by a label combination. If label values such as cluster_name, instance, or job differ, they are displayed as separate series rendered in different colors. The legend shows the label combination for each series in JSON format.

{ "cluster_name": "tomcat-proxy-demo-aerospike", "instance": "10.21.11.83:9145", "job": "aerospike-e..." }

Tooltip​

Hovering over a specific point in the graph displays a tooltip with the full list of labels and values for that series.

2026-05-19 07:24:07
{
"cluster_name": "tomcat-proxy-demo-aerospike",
"instance": "10.21.11.83:9145",
"job": "aerospike-exporter",
"le": "8192",
"latitude": "0",
"longitude": "0",
"ns": "demo",
"pcode": "49649",
"service": "10.21.11.83:3000"
}

Raw Section​

The Raw section consists of Table / Raw tabs.

TabDescription
TableLists metric values in a table format. Use this to compare label combinations or accurately check values at a specific point in time.
RawDisplays raw data collected from the endpoint. Use this to verify that collection itself is working correctly and that the label structure is as expected.
Note

If there are no query results, a "No data" message is displayed along with Total: 0.