.TH promtool 1 promtool, version 2.7.1+ds (branch: debian/sid, revision: 2.7.1+ds-3+b11)
.SH "NAME"
promtool - Tooling for the Prometheus monitoring system
.SH "SYNOPSIS"
.TP
\fBpromtool [<flags>] <command> [<args> ...]\fR

.SH "DESCRIPTION"
Tooling for the Prometheus monitoring system.
.SH "OPTIONS"
.TP
\fB-h, --help\fR
Show context-sensitive help (also try --help-long and --help-man).
.TP
\fB--version\fR
Show application version.
.SH "COMMANDS"
.SS
\fBhelp [<command>...]\fR
.PP
Show help.
.SS
\fBcheck config <config-files>...\fR
.PP
Check if the config files are valid or not.
.SS
\fBcheck rules <rule-files>...\fR
.PP
Check if the rule files are valid or not.
.SS
\fBcheck metrics\fR
.PP
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
.SS
\fBquery instant <server> <expr>\fR
.PP
Run instant query.
.SS
\fBquery range [<flags>] <server> <expr>\fR
.PP
Run range query.
.TP
\fB--start=START\fR
Query range start time (RFC3339 or Unix timestamp).
.TP
\fB--end=END\fR
Query range end time (RFC3339 or Unix timestamp).
.TP
\fB--step=STEP\fR
Query step size (duration).
.SS
\fBquery series --match=MATCH [<flags>] <server>\fR
.PP
Run series query.
.TP
\fB--match=MATCH\fR
Series selector. Can be specified multiple times.
.TP
\fB--start=START\fR
Start time (RFC3339 or Unix timestamp).
.TP
\fB--end=END\fR
End time (RFC3339 or Unix timestamp).
.SS
\fBquery labels <server> <name>\fR
.PP
Run labels query.
.SS
\fBdebug metrics <server>\fR
.PP
Fetch metrics debug information.
.SS
\fBdebug all <server>\fR
.PP
Fetch all debug information.
.SS
\fBtest rules <test-rule-file>...\fR
.PP
Unit tests for rules.