Prometheus: List Metrics
prometheus_list_metricsRead-only
Find metric names, types, and help text, and search them by name or help text before writing a PromQL query against an unfamiliar metric.
Instructions
Find metric names, with their type (counter, gauge, histogram, summary) and help text. search matches the name or the help text, so disk finds node_filesystem_avail_bytes by its description. Use this before writing a query against a metric you have not seen, then prometheus_describe_metric for its labels. Counters need rate() or increase(); summing a raw counter is the most common PromQL mistake.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Only consider series with samples before this: now, now-1h, -30m, an RFC3339 timestamp (2026-01-31T12:00:00Z) or unix seconds. Defaults to now. | |
| limit | No | Maximum metrics to return (1-1000). Defaults to 100. | |
| match | No | A series selector to restrict to, e.g. `{namespace="monitoring"}` or `up{job=~"kube.*"}`. A selector only — no functions or operators. An empty matcher set `{}` is rejected by Prometheus; use at least one non-empty matcher such as `{job=~".+"}`. | |
| start | No | Only consider series with samples after this: now, now-1h, -30m, an RFC3339 timestamp (2026-01-31T12:00:00Z) or unix seconds. Defaults to now-1h, i.e. series that exist now. Pass now-30d to include ones that have since gone away. | |
| search | No | Case-insensitive substring to filter by, e.g. `http`. | |
| metadata | No | Include type and help per metric. false returns bare names, about a fifth the size. |