Prometheus: Describe Metric
prometheus_describe_metricInspect a Prometheus metric's type, help, unit, series count, labels, cardinality, and example values before writing a PromQL selector to choose filters and group-by fields.
Instructions
Everything needed to query one metric: type, help, unit, how many series it has, and each label with its number of distinct values and examples. Read this before writing a selector — it shows which labels exist to filter and group by, and whether a label is high-cardinality (pod, uid) and so a bad thing to group by.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"metric": "<metric>"
},
"name": "prometheus_describe_metric"
}
}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. | |
| 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 an hour before end (now-1h when end is not given), i.e. series that exist now. Pass now-30d to include ones that have since gone away. | |
| metric | Yes | A metric name, e.g. `http_requests_total`. For a histogram or summary, the base name (`http_request_duration_seconds`) covers its _bucket, _count and _sum series. | |
| examples | No | Example values to show per label (0-50). Defaults to 8. |