promtool --help

promtool --help

usage: promtool [<flags>] <command> [<args> ...]

Tooling for the Prometheus monitoring system.

Flags:
  -h, --help     Show context-sensitive help (also try --help-long and --help-man).
      --version  Show application version.

Commands:
 help [<command>...]
   Show help.

 check config <config-files>...
   Check if the config files are valid or not.

 check web-config <web-config-files>...
   Check if the web 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 [<flags>] <server> <expr>
   Run instant query.

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

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

 query labels [<flags>] <server> <name>
   Run labels query.

 debug pprof <server>
   Fetch profiling debug information.

 debug metrics <server>
   Fetch metrics debug information.

 debug all <server>
   Fetch all debug information.

 test rules <test-rule-file>...
   Unit tests for rules.

 tsdb bench write [<flags>] [<file>]
   Run a write performance benchmark.

 tsdb analyze [<flags>] [<db path>] [<block id>]
   Analyze churn, label pair cardinality.

 tsdb list [<flags>] [<db path>]
   List tsdb blocks.

 tsdb dump [<flags>] [<db path>]
   Dump samples from a TSDB.

 tsdb create-blocks-from openmetrics <input file> [<output directory>]
   Import samples from OpenMetrics input and produce TSDB blocks. Please refer to the storage docs for more details.

See also

• Prometheus: promtool | check | tsbd | --help
• Prometheus: Prometheus installation, 9090, storage, Prometheus exporters: Node exporter 9100, Blackbox exporter, Prometheus alertmanager (changelog), Prometheus versions, Prometheus Node exporter releases, promtool, amtool, tsdb, /etc/default/prometheus, /etc/prometheus/prometheus.yml, journalctl -u prometheus, /etc/default/prometheus-node-exporter, PromQL, alert:, Prometheus Operator, Thanos, VictoriaMetrics, PushGateway, Prometheus API, values.yml, Amazon Managed Service for Prometheus