DOKK / manpages / debian 10 / prometheus / promtool.1.en
promtool(1) 2.7.1+ds promtool(1)

promtool - Tooling for the Prometheus monitoring system

Tooling for the Prometheus monitoring system.

Show context-sensitive help (also try --help-long and --help-man).
Show application version.

help [<command>...]

Show help.

check config <config-files>...

Check if the config files are valid or not.

check rules <rule-files>...

Check if the rule files are valid or not.

check metrics

Pass Prometheus metrics over stdin to lint them for consistency and correctness.

examples:

$ cat metrics.prom | promtool check metrics

$ curl -s http://localhost:9090/metrics | promtool check metrics

query instant <server> <expr>

Run instant query.

query range [<flags>] <server> <expr>

Run range query.

Query range start time (RFC3339 or Unix timestamp).
Query range end time (RFC3339 or Unix timestamp).
Query step size (duration).

query series --match=MATCH [<flags>] <server>

Run series query.

Series selector. Can be specified multiple times.
Start time (RFC3339 or Unix timestamp).
End time (RFC3339 or Unix timestamp).

query labels <server> <name>

Run labels query.

debug metrics <server>

Fetch metrics debug information.

debug all <server>

Fetch all debug information.

test rules <test-rule-file>...

Unit tests for rules.

promtool, version