> ## Documentation Index
> Fetch the complete documentation index at: https://docs.molesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metrics

> Explore the metric catalog, build PromQL, inspect series quality, and compare related metrics.

Open **Metrics** to query time series stored in metric streams.

## Start from the catalog

The metric catalog lists metric names, types, labels, and indexed dimensions. Select a metric to
seed the editor, or open **PromQL builder** to compose label matchers and aggregations without
writing the full expression.

```promql theme={null}
sum by (service_name) (
  rate(http_server_request_duration_seconds_count[5m])
)
```

See the [PromQL support matrix](/en-US/query/promql-subset) for the implemented functions and
modifiers.

## Work with the chart

* Drag across the plot to zoom into a time range.
* Drag the X-axis to pan.
* Double-click to restore a wider range.
* Use the legend to isolate or compare series.
* Keep the current zoom when pivoting to traces or logs.

## Analyze the result

The metrics workspace exposes more than a chart:

| View                    | Purpose                                                       |
| ----------------------- | ------------------------------------------------------------- |
| **Series overview**     | Current value, labels, and series count.                      |
| **Statistical summary** | Aggregate distribution across returned series.                |
| **Cardinality**         | Label combinations that may increase cost or query load.      |
| **Data quality**        | Counter regressions, out-of-order points, or type mismatches. |
| **Related metrics**     | Other metrics sharing useful labels.                          |
| **Query statistics**    | Scan size and execution time.                                 |

## Correlate a metric spike

Select the spike window, keep service and environment labels, then open related traces or logs.
MoleSignal carries the selected range into the next signal.

## Permissions

Catalog discovery requires `streams.read`. Running PromQL or SQL requires `streams.query`.

<CardGroup cols={2}>
  <Card title="Querying" icon="terminal" href="/en-US/query">
    Learn the shared query contract and asynchronous jobs.
  </Card>

  <Card title="Traces" icon="route" href="/en-US/traces">
    Move from latency or error-rate changes to individual requests.
  </Card>
</CardGroup>