Provided by: prometheus-alertmanager_0.23.0-5_amd64 bug

NAME

       promtool - Tooling for the Prometheus alert manager

SYNOPSIS

       amtool [<flags>] <command> [<args> ...]

DESCRIPTION

       View and modify the current Alertmanager state.

       Config  File: The alertmanager tool will read a config file in YAML format from one of two
       default       config       locations:        $HOME/.config/prometheus/amtool.yml        or
       /etc/prometheus/amtool.yml

       All  flags  can  be  given in the config file, but the following are the suited for static
       configuration:

            alertmanager.url           Set a default alertmanager url for each request

            author           Set a default author value for new silences. If this argument is not
                 specified then the username will be used

            require-comment            Bool,  whether  to  require a comment on silence creation.
       Defaults to true

            output           Set a default output type. Options are (simple, extended, json)

            date.format           Sets the output  format  for  dates.  Defaults  to  "2006-01-02
       15:04:05 MST"

            tls.insecure.skip.verify            Skips  TLS certificate verification for all HTTPS
       requests.            Defaults to false.

OPTIONS

       -h, --help
              Show context-sensitive help (also try --help-long and --help-man).

       --date.format="2006-01-02 15:04:05 MST"
              Format of date output

       -v, --verbose
              Verbose running information

       --alertmanager.url=http://localhost:9093/
              Alertmanager to talk to

       -o, --output=simple
              Output formatter (simple, extended, json)

       --timeout=30s
              Timeout for the executed command

       --tls.insecure.skip.verify
              Skip TLS certificate verification

       --version-check
              Check alertmanager version. Use --no-version-check to disable.

       --version
              Show application version.

COMMANDS

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

   alert query [<flags>] [<matcher-groups>...]
       View and search through current alerts.

       Amtool has a simplified prometheus query syntax, but  contains  robust  support  for  bash
       variable  expansions.  The  non-option  section of arguments constructs a list of "Matcher
       Groups" that will be used to filter your query. The following  examples  will  attempt  to
       show this behaviour in action:

       amtool alert query alertname=foo node=bar

            This query will match all alerts with the alertname=foo and node=bar label      value
       pairs set.

       amtool alert query foo node=bar

            If alertname is omitted and the first argument does not contain a '=' or a       '=~'
       then it will be assumed to be the value of the alertname pair.

       amtool alert query 'alertname=~foo.*'

            As  well  as  direct  equality,  regex  matching  is  also supported. The '=~' syntax
            (similar to prometheus) is used to represent a regex match. Regex  matching       can
       be used in combination with a direct match.

       Amtool  supports  several  flags  for  filtering  the returned alerts by state (inhibited,
       silenced, active, unprocessed). If none of these flags is given, only  active  alerts  are
       returned.

       -i, --inhibited
              Show inhibited alerts

       -s, --silenced
              Show silenced alerts

       -a, --active
              Show active alerts

       -u, --unprocessed
              Show unprocessed alerts

       -r, --receiver=RECEIVER
              Show alerts matching receiver (Supports regex syntax)

   alert add [<flags>] [<labels>...]
       Add a new alert.

       This command is used to add a new alert to Alertmanager.

       To add a new alert with labels:

            amtool alert add alertname=foo node=bar

       If  alertname  is  omitted  and  the first argument does not contain a '=' then it will be
       assumed to be the value of the alertname pair.

            amtool alert add foo node=bar

       One or more annotations can be added using the --annotation flag:

            amtool alert  add  foo  node=bar            --annotation=runbook='http://runbook.biz'
               --annotation=summary='summary              of              the              alert'
               --annotation=description='description of the alert'

       Additional flags such as --generator-url, --start, and --end are also supported.

       --generator-url=GENERATOR-URL
              Set the URL of the source that generated the alert

       --start=START
              Set when the alert should start. RFC3339 format 2006-01-02T15:04:05-07:00

       --end=END
              Set when the alert should should end. RFC3339 format 2006-01-02T15:04:05-07:00

       --annotation=ANNOTATION
              Set an annotation to be included with the alert

   silence add [<flags>] [<matcher-groups>...]
       Add a new alertmanager silence

            This statement will add a silence that matches alerts with the      alertname=foo and
       node=bar label value pairs set.

            If  alertname is omitted and the first argument does not contain a '=' or a      '=~'
       then it will be assumed to be the value of the alertname pair.

            As well as direct equality,  regex  matching  is  also  supported.  The  '=~'  syntax
            (similar  to  Prometheus) is used to represent a regex match. Regex matching      can
       be used in combination with a direct match.

       -a, --author=AUTHOR
              Username for CreatedBy field

       -d, --duration="1h"
              Duration of silence

       --start=START
              Set when the silence should start. RFC3339 format 2006-01-02T15:04:05-07:00

       --end=END
              Set  when  the  silence  should   end   (overwrites   duration).   RFC3339   format
              2006-01-02T15:04:05-07:00

       -c, --comment=COMMENT
              A comment to help describe the silence

   silence expire [<silence-ids>...]
       expire an alertmanager silence

   silence import [<flags>] [<input-file>]
       Import alertmanager silences from JSON file or stdin

       This  command  can  be  used  to  bulk  import  silences from a JSON file created by query
       command. For example:

       amtool silence query -o json foo > foo.json

       amtool silence import foo.json

       JSON data can also come from stdin if no param is specified.

       -f, --force
              Force adding new silences even if it already exists

       -w, --worker=8
              Number of concurrent workers to use for import

   silence query [<flags>] [<matcher-groups>...]
       Query Alertmanager silences.

       Amtool has a simplified prometheus query syntax, but  contains  robust  support  for  bash
       variable  expansions.  The  non-option  section of arguments constructs a list of "Matcher
       Groups" that will be used to filter your query. The following  examples  will  attempt  to
       show this behaviour in action:

       amtool silence query alertname=foo node=bar

            This  query  will  match  all  silences  with  the  alertname=foo  and node=bar label
            value pairs set.

       amtool silence query foo node=bar

            If alertname is omitted and the first argument does not contain a '=' or a       '=~'
       then it will be assumed to be the value of the alertname pair.

       amtool silence query 'alertname=~foo.*'

            As  well  as  direct  equality,  regex  matching  is  also supported. The '=~' syntax
            (similar to prometheus) is used to represent a regex match. Regex  matching       can
       be used in combination with a direct match.

       In  addition  to filtering by silence labels, one can also query for silences that are due
       to expire soon with the "--within" parameter. In the event that you want  to  preemptively
       act upon expiring silences by either fixing them or extending them. For example:

       amtool silence query --within 8h

       returns  all  the  silences due to expire within the next 8 hours. This syntax can also be
       combined with the label based filtering above for more flexibility.

       The "--expired"  parameter  returns  only  expired  silences.  Used  in  combination  with
       "--within=TIME", amtool returns the silences that expired within the preceding duration.

       amtool silence query --within 2h --expired

       returns all silences that expired within the preceding 2 hours.

       --expired
              Show expired silences instead of active

       -q, --quiet
              Only show silence ids

       --within=WITHIN
              Show silences that will expire or have expired within a duration

   silence update [<flags>] [<update-ids>...]
       Update silences

       -q, --quiet
              Only show silence ids

       -d, --duration=DURATION
              Duration of silence

       --start=START
              Set when the silence should start. RFC3339 format 2006-01-02T15:04:05-07:00

       --end=END
              Set   when   the   silence   should   end  (overwrites  duration).  RFC3339  format
              2006-01-02T15:04:05-07:00

       -c, --comment=COMMENT
              A comment to help describe the silence

   check-config [<check-files>...]
       Validate alertmanager config files

       Will validate the syntax and schema for alertmanager config file and associated templates.
       Non existing templates will not trigger errors.

   cluster show
       View cluster status and peers.

   config show
       View current config.

       The amount of output is controlled by the output selection flag:      - Simple: Print just
       the running config      - Extended: Print the running config as well  as  uptime  and  all
       version info      - Json: Print entire config object as json

   config routes show
       Prints alert routing tree

       Will print whole routing tree in form of ASCII tree view.

       Routing is loaded from a local configuration file or a running Alertmanager configuration.
       Specifying --config.file takes precedence over --alertmanager.url.

       Example:

       amtool config routes [show] --config.file=doc/examples/simple.yml

   config routes test [<flags>] [<labels>...]
       Test alert routing

       Will return receiver names which the alert with given labels resolves to.  If the labelset
       resolves  to  multiple  receivers, they are printed out in order as defined in the routing
       tree.

       Routing is loaded from a local configuration file or a running Alertmanager configuration.
       Specifying --config.file takes precedence over --alertmanager.url.

       Example:

       amtool  config  routes test --config.file=doc/examples/simple.yml --verify.receivers=team-
       DB-pager service=database

       --verify.receivers=VERIFY.RECEIVERS
              Checks if specified receivers matches resolved receivers. The command fails if  the
              labelset does not route to the specified receivers.

       --tree Prints out matching routes tree.

   template render --template.glob=TEMPLATE.GLOB --template.text=TEMPLATE.TEXT [<flags>]
       Render a given definition in a template file to standard output.

       --template.glob=TEMPLATE.GLOB
              Glob of paths that will be expanded and used for rendering.

       --template.text=TEMPLATE.TEXT
              The template that will be rendered.

       --template.type=TEMPLATE.TYPE
              The type of the template. Can be either text (default) or html.

       --template.data=TEMPLATE.DATA
              Full  path  to  a  file  which  contains  the  data of the alert(-s) with which the
              --template.text will be rendered. Must be in JSON. File must be formatted according
              to                     the                     following                    layout:
              https://pkg.go.dev/github.com/prometheus/alertmanager/template#Data.  If  none  has
              been specified then a predefined, simple alert will be used for rendering.