[ACDU翻译] MySQL PMM pmm-agent - PMM 客户端代理

简介

pmm-agent - PMM 客户端守护程序。

概要

pmm-agent [command] [options]

描述

pmm-agent是 PMM 客户端软件包的一部分，在所有受监控的主机上作为守护进程运行。

命令

pmm-agent run

运行 pmm-agent（默认）。

pmm-agent setup [node-address] [node-type] [node-name]

配置本地pmm-agent（需要root权限）

pmm-agent help [command]

显示帮助（用于命令）并退出。

选项和环境

大多数选项可以通过环境变量设置（显示在括号中）。

paths-base标志的用法和例子

自 2.23.0 起，此标志可用于更轻松地设置 pmm 代理。有了这个标志，不再需要 PMM 客户端的 root 权限，它将完全正常工作。

例子：

• 情况 1：/usr/local/percona/pmm2文件夹没有 root 权限或需要更改 PMM 文件的默认文件夹。命令：

  pmm-agent setup --paths-base=/home/user/custom/pmm2 --config-file=pmm-agent-dev.yaml --server-insecure-tls --server-address=127.0.0.1:443 --server-username=admin --server-password=admin
  复制

  配置输出：

  # Updated by `pmm-agent setup`.
  ---
  id: /agent_id/be568008-b1b4-4bd9-98c7-392d1f4b724e
  listen-address: 127.0.0.1
  listen-port: 7777
  server:
      address: 127.0.0.1:443
      username: admin
      password: admin
      insecure-tls: true
  paths:
      paths_base: /home/user/custom/pmm2
      exporters_base: /home/user/custom/pmm2/exporters
      node_exporter: /home/user/custom/pmm2/exporters/node_exporter
      mysqld_exporter: /home/user/custom/pmm2/exporters/mysqld_exporter
      mongodb_exporter: /home/user/custom/pmm2/exporters/mongodb_exporter
      postgres_exporter: /home/user/custom/pmm2/exporters/postgres_exporter
      proxysql_exporter: /home/user/custom/pmm2/exporters/proxysql_exporter
      rds_exporter: /home/user/custom/pmm2/exporters/rds_exporter
      azure_exporter: /home/user/custom/pmm2/exporters/azure_exporter
      vmagent: /home/user/custom/pmm2/exporters/vmagent
      tempdir: /tmp
      pt_summary: /home/user/custom/pmm2/tools/pt-summary
      pt_pg_summary: /home/user/custom/pmm2/tools/pt-pg-summary
      pt_mysql_summary: /home/user/custom/pmm2/tools/pt-mysql-summary
      pt_mongodb_summary: /home/user/custom/pmm2/tools/pt-mongodb-summary
  ports:
      min: 42000
      max: 51999
  debug: false
  trace: false
  复制

  从上面可以看出，所有出口商和工具的基础仅通过设置--paths-base. 使用此标记可以指定不需要 root 访问权限的 PMM 文件夹。

  
  

• 情况 2：旧--paths-exporters_base标志可以与--paths-base 命令一起传递：

  pmm-agent setup --paths-base=/home/user/custom/pmm2 --paths-exporters_base=/home/user/exporters --config-file=pmm-agent-dev.yaml --server-insecure-tls --server-address=127.0.0.1:443 --server-username=admin --server-password=admin
  复制

  配置输出：

  # Updated by `pmm-agent setup`.
  ---
  id: /agent_id/afce1917-8836-4857-b3e5-ad372c2ddbe5
  listen-address: 127.0.0.1
  listen-port: 7777
  server:
      address: 127.0.0.1:443
      username: admin
      password: admin
      insecure-tls: true
  paths:
      paths_base: /home/user/custom/pmm2
      exporters_base: /home/user/exporters
      node_exporter: /home/user/exporters/node_exporter
      mysqld_exporter: /home/user/exporters/mysqld_exporter
      mongodb_exporter: /home/user/exporters/mongodb_exporter
      postgres_exporter: /home/user/exporters/postgres_exporter
      proxysql_exporter: /home/user/exporters/proxysql_exporter
      rds_exporter: /home/user/exporters/rds_exporter
      azure_exporter: /home/user/exporters/azure_exporter
      vmagent: /home/user/exporters/vmagent
      tempdir: /tmp
      pt_summary: /home/user/custom/pmm2/tools/pt-summary
      pt_pg_summary: /home/user/custom/pmm2/tools/pt-pg-summary
      pt_mysql_summary: /home/user/custom/pmm2/tools/pt-mysql-summary
      pt_mongodb_summary: /home/user/custom/pmm2/tools/pt-mongodb-summary
  ports:
      min: 42000
      max: 51999
  debug: false
  trace: false
  复制

  从上面可以看出， 的行为--paths-base是相同的，但所有出口商的路径都被--paths-exporter_base标志覆盖。

  
  

总结： Flag--paths-base将为所有出口商和工具设置路径，但每个出口商和工具都可以被特定的标志覆盖（例如--paths-mongodb_exporter，--paths-pt-mysql-summary等等）。

日志记录

默认情况下，pmm-agent 将消息发送到 stderr 和系统日志（syslogd或journald在 Linux 上）。

要获得单独的日志文件，请编辑pmm-agent启动脚本。

systemd基于系统

• 脚本文件： /usr/lib/systemd/system/pmm-agent.service
• 范围： StandardError
• 默认值： file:/var/log/pmm-agent.log

例子：

StandardError=file:/var/log/pmm-agent.log
复制

initd基于系统

• 脚本文件： /etc/init.d/pmm-agent
• 范围： pmm_log
• 默认值： /var/log/pmm-agent.log

例子：

pmm_log="/var/log/pmm-agent.log"
复制

如果更改默认日志文件名，请反映日志轮换规则文件中的更改/etc/logrotate.d/pmm-agent-logrotate。

•  页面更新 2021-10-21