OS Manuals

/usr/bin/pmm-agent

PMM agent that supervises exporters and reports to PMM Server

From pmm-agent 3.10.0-r6 (enterprise-packages), captured 2026-11-08 by running pmm-agent --help (exit 0). permalink

usage: pmm-agent [<flags>] <command> [<args> ...]

Version 3.10.0


Flags:
  -h, --[no-]help                Show context-sensitive help (also try --help-long and --help-man)
      --config-file=</path/to/pmm-agent.yaml>
                                 Configuration file path [PMM_AGENT_CONFIG_FILE]
                                 ($PMM_AGENT_CONFIG_FILE)
      --config-file-key-file=CONFIG-FILE-KEY-FILE
                                 Path to the key file used to encrypt/decrypt the configuration file
                                 ($PMM_AGENT_CONFIG_FILE_KEY_FILE)
      --config-file-key-password=CONFIG-FILE-KEY-PASSWORD
                                 Password for the key file (if required)
                                 ($PMM_AGENT_CONFIG_FILE_KEY_PASSWORD)
      --id=ID                    ID of this pmm-agent [PMM_AGENT_ID] ($PMM_AGENT_ID)
      --listen-address=LISTEN-ADDRESS
                                 Agent local API address [PMM_AGENT_LISTEN_ADDRESS]
                                 ($PMM_AGENT_LISTEN_ADDRESS)
      --listen-port=LISTEN-PORT  Agent local API port [PMM_AGENT_LISTEN_PORT]
                                 ($PMM_AGENT_LISTEN_PORT)
      --runner-capacity=RUNNER-CAPACITY
                                 Agent internal actions/jobs runner capacity
                                 [PMM_AGENT_RUNNER_CAPACITY] ($PMM_AGENT_RUNNER_CAPACITY)
      --runner-max-connections-per-service=RUNNER-MAX-CONNECTIONS-PER-SERVICE
                                 Agent internal action/job runner connection limit per DB instance
                                 ($PMM_AGENT_RUNNER_MAX_CONNECTIONS_PER_SERVICE)
      --server-address=<host:port>
                                 PMM Server address [PMM_AGENT_SERVER_ADDRESS]
                                 ($PMM_AGENT_SERVER_ADDRESS)
      --server-username=SERVER-USERNAME
                                 Username to connect to PMM Server [PMM_AGENT_SERVER_USERNAME]
                                 ($PMM_AGENT_SERVER_USERNAME)
      --server-password=SERVER-PASSWORD
                                 Password to connect to PMM Server [PMM_AGENT_SERVER_PASSWORD]
                                 ($PMM_AGENT_SERVER_PASSWORD)
      --[no-]server-insecure-tls
                                 Skip PMM Server TLS certificate validation
                                 [PMM_AGENT_SERVER_INSECURE_TLS] ($PMM_AGENT_SERVER_INSECURE_TLS)
      --paths-base=PATHS-BASE    Base path for exporters/collectors/tools to use
                                 [PMM_AGENT_PATHS_BASE] ($PMM_AGENT_PATHS_BASE)
      --paths-exporters_base=PATHS-EXPORTERS_BASE
                                 Base path for exporters to use [PMM_AGENT_PATHS_EXPORTERS_BASE]
                                 ($PMM_AGENT_PATHS_EXPORTERS_BASE)
      --paths-node_exporter=PATHS-NODE_EXPORTER
                                 Path to node_exporter to use [PMM_AGENT_PATHS_NODE_EXPORTER]
                                 ($PMM_AGENT_PATHS_NODE_EXPORTER)
      --paths-mysqld_exporter=PATHS-MYSQLD_EXPORTER
                                 Path to mysqld_exporter to use [PMM_AGENT_PATHS_MYSQLD_EXPORTER]
                                 ($PMM_AGENT_PATHS_MYSQLD_EXPORTER)
      --paths-mongodb_exporter=PATHS-MONGODB_EXPORTER
                                 Path to mongodb_exporter to use [PMM_AGENT_PATHS_MONGODB_EXPORTER]
                                 ($PMM_AGENT_PATHS_MONGODB_EXPORTER)
      --paths-postgres_exporter=PATHS-POSTGRES_EXPORTER
                                 Path to postgres_exporter to use
                                 [PMM_AGENT_PATHS_POSTGRES_EXPORTER]
                                 ($PMM_AGENT_PATHS_POSTGRES_EXPORTER)
      --paths-proxysql_exporter=PATHS-PROXYSQL_EXPORTER
                                 Path to proxysql_exporter to use
                                 [PMM_AGENT_PATHS_PROXYSQL_EXPORTER]
                                 ($PMM_AGENT_PATHS_PROXYSQL_EXPORTER)
      --paths-azure_exporter=PATHS-AZURE_EXPORTER
                                 Path to azure_exporter to use [PMM_AGENT_PATHS_AZURE_EXPORTER]
                                 ($PMM_AGENT_PATHS_AZURE_EXPORTER)
      --paths-valkey-exporter=PATHS-VALKEY-EXPORTER
                                 Path to valkey_exporter to use [PMM_AGENT_PATHS_VALKEY_EXPORTER]
                                 ($PMM_AGENT_PATHS_VALKEY_EXPORTER)
      --paths-pt-summary=PATHS-PT-SUMMARY
                                 Path to pt summary to use [PMM_AGENT_PATHS_PT_SUMMARY]
                                 ($PMM_AGENT_PATHS_PT_SUMMARY)
      --paths-pt-pg-summary=PATHS-PT-PG-SUMMARY
                                 Path to pt-pg-summary to use [PMM_AGENT_PATHS_PT_PG_SUMMARY]
                                 ($PMM_AGENT_PATHS_PT_PG_SUMMARY)
      --paths-pt-mongodb-summary=PATHS-PT-MONGODB-SUMMARY
                                 Path to pt mongodb summary to use
                                 [PMM_AGENT_PATHS_PT_MONGODB_SUMMARY]
                                 ($PMM_AGENT_PATHS_PT_MONGODB_SUMMARY)
      --paths-pt-mysql-summary=PATHS-PT-MYSQL-SUMMARY
                                 Path to pt my sql summary to use [PMM_AGENT_PATHS_PT_MYSQL_SUMMARY]
                                 ($PMM_AGENT_PATHS_PT_MYSQL_SUMMARY)
      --paths-nomad=PATHS-NOMAD  Path to nomad binary. Can be overridden using
                                 [PMM_AGENT_PATHS_NOMAD] ($PMM_AGENT_PATHS_NOMAD)
      --paths-nomad-data-dir=PATHS-NOMAD-DATA-DIR
                                 Nomad data directory [PMM_AGENT_PATHS_NOMAD_DATA_DIR]
                                 ($PMM_AGENT_PATHS_NOMAD_DATA_DIR)
      --paths-tempdir=PATHS-TEMPDIR
                                 Temporary directory for exporters [PMM_AGENT_PATHS_TEMPDIR]
                                 ($PMM_AGENT_PATHS_TEMPDIR)
      --ports-min=PORTS-MIN      Minimal allowed port number for listening sockets
                                 [PMM_AGENT_PORTS_MIN] ($PMM_AGENT_PORTS_MIN)
      --ports-max=PORTS-MAX      Maximal allowed port number for listening sockets
                                 [PMM_AGENT_PORTS_MAX] ($PMM_AGENT_PORTS_MAX)
      --window-connected-time=WINDOW-CONNECTED-TIME
                                 Window time for which we track the status of connection between
                                 agent and server ($PMM_AGENT_WINDOW_CONNECTED_TIME)
      --log-level=LOG-LEVEL      Set logging level [PMM_AGENT_LOG_LEVEL] ($PMM_AGENT_LOG_LEVEL)
      --[no-]debug               Enable debug output [PMM_AGENT_DEBUG] ($PMM_AGENT_DEBUG)
      --[no-]trace               Enable trace output (implies debug) [PMM_AGENT_TRACE]
                                 ($PMM_AGENT_TRACE)
      --log-lines-count=1024     Take and return N most recent log lines in logs.zip
                                 for each: server, every configured exporters and agents
                                 [PMM_AGENT_LOG_LINES_COUNT] ($PMM_AGENT_LOG_LINES_COUNT)
      --perfschema-refresh-rate=PERFSCHEMA-REFRESH-RATE
                                 Change how often PMM scrapes data from Performance
                                 Schema (in seconds) [PMM_AGENT_PERFSCHEMA_REFRESH_RATE]
                                 ($PMM_AGENT_PERFSCHEMA_REFRESH_RATE)
      --[no-]json                Enable JSON output
  -v, --[no-]version             Show application version

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

run*
    Run pmm-agent (default command)

setup [<flags>] <node-address> [<node-type>] [<node-name>]
    Configure local pmm-agent
Options (35)
OptionDescriptionSource
-hShow context-sensitive help (also try --help-long and --help-man)help
--config-file /path/to/pmm-agent.yamlConfiguration file path [PMM_AGENT_CONFIG_FILE] ($PMM_AGENT_CONFIG_FILE)help
--config-file-key-file CONFIG-FILE-KEY-FILEPath to the key file used to encrypt/decrypt the configuration file ($PMM_AGENT_CONFIG_FILE_KEY_FILE)help
--config-file-key-password CONFIG-FILE-KEY-PASSWORDPassword for the key file (if required) ($PMM_AGENT_CONFIG_FILE_KEY_PASSWORD)help
--id IDID of this pmm-agent [PMM_AGENT_ID] ($PMM_AGENT_ID)help
--listen-address LISTEN-ADDRESSAgent local API address [PMM_AGENT_LISTEN_ADDRESS] ($PMM_AGENT_LISTEN_ADDRESS)help
--listen-port LISTEN-PORTAgent local API port [PMM_AGENT_LISTEN_PORT] ($PMM_AGENT_LISTEN_PORT)help
--runner-capacity RUNNER-CAPACITYAgent internal actions/jobs runner capacity [PMM_AGENT_RUNNER_CAPACITY] ($PMM_AGENT_RUNNER_CAPACITY)help
--runner-max-connections-per-service RUNNER-MAX-CONNECTIONS-PER-SERVICEAgent internal action/job runner connection limit per DB instance ($PMM_AGENT_RUNNER_MAX_CONNECTIONS_PER_SERVICE)help
--server-address host:portPMM Server address [PMM_AGENT_SERVER_ADDRESS] ($PMM_AGENT_SERVER_ADDRESS)help
--server-username SERVER-USERNAMEUsername to connect to PMM Server [PMM_AGENT_SERVER_USERNAME] ($PMM_AGENT_SERVER_USERNAME)help
--server-password SERVER-PASSWORDPassword to connect to PMM Server [PMM_AGENT_SERVER_PASSWORD] ($PMM_AGENT_SERVER_PASSWORD)help
--paths-base PATHS-BASEBase path for exporters/collectors/tools to use [PMM_AGENT_PATHS_BASE] ($PMM_AGENT_PATHS_BASE)help
--paths-exporters_base PATHS-EXPORTERS_BASEBase path for exporters to use [PMM_AGENT_PATHS_EXPORTERS_BASE] ($PMM_AGENT_PATHS_EXPORTERS_BASE)help
--paths-node_exporter PATHS-NODE_EXPORTERPath to node_exporter to use [PMM_AGENT_PATHS_NODE_EXPORTER] ($PMM_AGENT_PATHS_NODE_EXPORTER)help
--paths-mysqld_exporter PATHS-MYSQLD_EXPORTERPath to mysqld_exporter to use [PMM_AGENT_PATHS_MYSQLD_EXPORTER] ($PMM_AGENT_PATHS_MYSQLD_EXPORTER)help
--paths-mongodb_exporter PATHS-MONGODB_EXPORTERPath to mongodb_exporter to use [PMM_AGENT_PATHS_MONGODB_EXPORTER] ($PMM_AGENT_PATHS_MONGODB_EXPORTER)help
--paths-postgres_exporter PATHS-POSTGRES_EXPORTERPath to postgres_exporter to use [PMM_AGENT_PATHS_POSTGRES_EXPORTER] ($PMM_AGENT_PATHS_POSTGRES_EXPORTER)help
--paths-proxysql_exporter PATHS-PROXYSQL_EXPORTERPath to proxysql_exporter to use [PMM_AGENT_PATHS_PROXYSQL_EXPORTER] ($PMM_AGENT_PATHS_PROXYSQL_EXPORTER)help
--paths-azure_exporter PATHS-AZURE_EXPORTERPath to azure_exporter to use [PMM_AGENT_PATHS_AZURE_EXPORTER] ($PMM_AGENT_PATHS_AZURE_EXPORTER)help
--paths-valkey-exporter PATHS-VALKEY-EXPORTERPath to valkey_exporter to use [PMM_AGENT_PATHS_VALKEY_EXPORTER] ($PMM_AGENT_PATHS_VALKEY_EXPORTER)help
--paths-pt-summary PATHS-PT-SUMMARYPath to pt summary to use [PMM_AGENT_PATHS_PT_SUMMARY] ($PMM_AGENT_PATHS_PT_SUMMARY)help
--paths-pt-pg-summary PATHS-PT-PG-SUMMARYPath to pt-pg-summary to use [PMM_AGENT_PATHS_PT_PG_SUMMARY] ($PMM_AGENT_PATHS_PT_PG_SUMMARY)help
--paths-pt-mongodb-summary PATHS-PT-MONGODB-SUMMARYPath to pt mongodb summary to use [PMM_AGENT_PATHS_PT_MONGODB_SUMMARY] ($PMM_AGENT_PATHS_PT_MONGODB_SUMMARY)help
--paths-pt-mysql-summary PATHS-PT-MYSQL-SUMMARYPath to pt my sql summary to use [PMM_AGENT_PATHS_PT_MYSQL_SUMMARY] ($PMM_AGENT_PATHS_PT_MYSQL_SUMMARY)help
--paths-nomad PATHS-NOMADPath to nomad binary.help
--paths-nomad-data-dir PATHS-NOMAD-DATA-DIRNomad data directory [PMM_AGENT_PATHS_NOMAD_DATA_DIR] ($PMM_AGENT_PATHS_NOMAD_DATA_DIR)help
--paths-tempdir PATHS-TEMPDIRTemporary directory for exporters [PMM_AGENT_PATHS_TEMPDIR] ($PMM_AGENT_PATHS_TEMPDIR)help
--ports-min PORTS-MINMinimal allowed port number for listening sockets [PMM_AGENT_PORTS_MIN] ($PMM_AGENT_PORTS_MIN)help
--ports-max PORTS-MAXMaximal allowed port number for listening sockets [PMM_AGENT_PORTS_MAX] ($PMM_AGENT_PORTS_MAX)help
--window-connected-time WINDOW-CONNECTED-TIMEWindow time for which we track the status of connection between agent and server ($PMM_AGENT_WINDOW_CONNECTED_TIME)help
--log-level LOG-LEVELSet logging level [PMM_AGENT_LOG_LEVEL] ($PMM_AGENT_LOG_LEVEL)help
--log-lines-count 1024Take and return N most recent log lines in logs.zip for each: server, every configured exporters and agents [PMM_AGENT_LOG_LINES_COUNT] ($PMM_AGENT_LOG_LINES_COUNT)help
--perfschema-refresh-rate PERFSCHEMA-REFRESH-RATEChange how often PMM scrapes data from Performance Schema (in seconds) [PMM_AGENT_PERFSCHEMA_REFRESH_RATE] ($PMM_AGENT_PERFSCHEMA_REFRESH_RATE)help
-vShow application versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.