有多种方法可以在节点上安装 PMM 客户端并将其注册到 PMM 服务器。从中选择:
Docker:将 PMM 客户端作为 Docker 容器直接运行或使用 Docker compose 运行。
包管理器:
在 Debian 或 Red Hat Linux 上,安装
percona-release
并使用 Linux 包管理器 (apt
/dnf
) 来安装 PMM 客户端。在 Debian 或 Red Hat 上,下载
.deb
/.rpm
PMM 客户端软件包并手动安装它们。
二进制是没有 root 权限安装 PMM 客户端的唯一方法
二进制包:对于其他 Linux 发行版,下载并解压通用 PMM 客户端 Linux 二进制文件。
安装 PMM 客户端后,您必须:
如果需要,您可以取消注册、删除服务或删除 PMM 客户端。
以下是选择的概述。
在你开始之前
使用可从客户端节点访问的已知 IP 地址设置 PMM 服务器。
您在客户端主机上拥有超级用户 (root) 访问权限。
您拥有对要监视的任何数据库服务器的超级用户访问权限。
这些 Linux 软件包已安装:
curl
、gnupg
、sudo
、wget
。如果使用它,请安装Docker。
如果使用它,请安装Docker compose。
系统要求:
操作系统 – PMM 客户端可在任何现代 64 位 Linux 发行版上运行。它在支持的 Debian、Ubuntu、CentOS 和 Red Hat Enterprise Linux 版本上进行了测试。(请参阅Percona 软件支持生命周期)。
磁盘 – 安装 PMM 客户端软件包至少需要 100 MB 的存储空间。通过与 PMM 服务器的良好连接,不需要额外的存储。但是,客户端需要存储它无法立即分发的任何收集的数据,因此如果连接不稳定或吞吐量低,则可能需要额外的存储。(缓存仅适用于 Query Analytics 数据;VictoriaMetrics 数据从不缓存在客户端。)
安装
Docker
该PMM客户泊坞窗图像是运行PMM客户端作为一个预配置的便捷方式泊坞窗容器。
拉取 PMM 客户端泊坞窗图像。
docker pull \
percona/pmm-client:2复制使用图像作为模板来创建持久数据存储,在更新图像时保留本地数据。
docker create \
--volume /srv \
--name pmm-client-data \
percona/pmm-client:2 /bin/true复制运行容器以在设置模式下启动PMM 代理。设置
X.X.X.X
为 PMM 服务器的 IP 地址。(不要使用该docker --detach
选项,因为 PMM 代理仅登录到控制台。)PMM_SERVER=X.X.X.X:443
docker run \
--rm \
--name pmm-client \
-e PMM_AGENT_SERVER_ADDRESS=${PMM_SERVER} \
-e PMM_AGENT_SERVER_USERNAME=admin \
-e PMM_AGENT_SERVER_PASSWORD=admin \
-e PMM_AGENT_SERVER_INSECURE_TLS=1 \
-e PMM_AGENT_SETUP=1 \
-e PMM_AGENT_CONFIG_FILE=pmm-agent.yml \
--volumes-from pmm-client-data \
percona/pmm-client:2复制
提示
您可以在此处找到兼容环境变量的完整列表。
检查状态。
docker exec pmm-client \
pmm-admin status复制在 PMM 用户界面中,您还将看到受监控节点数量的增加。
您现在可以pmm-admin
通过在命令前加上前缀来添加服务docker exec pmm-client
。
提示
调整主机防火墙和路由规则以允许 Docker 通信。(阅读更多)
求助:
docker run --rm percona/pmm-client:2 --help
Docker 组合
将此文本复制并粘贴到名为
docker-compose.yml
.version: '2'
services:
pmm-client:
image: percona/pmm-client:2
hostname: pmm-client-myhost
container_name: pmm-client
restart: always
ports:
- "42000:42000"
- "42001:42001"
logging:
driver: json-file
options:
max-size: "10m"
max-file: "5"
volumes:
- ./pmm-agent.yaml:/etc/pmm-agent.yaml
- pmm-client-data:/srv
environment:
- PMM_AGENT_CONFIG_FILE=/etc/pmm-agent.yaml
- PMM_AGENT_SERVER_USERNAME=admin
- PMM_AGENT_SERVER_PASSWORD=admin
- PMM_AGENT_SERVER_ADDRESS=X.X.X.X:443
- PMM_AGENT_SERVER_INSECURE_TLS=true
entrypoint: pmm-agent setup
volumes:
pmm-client-data:复制检查该
environment
部分中的值是否与您的 PMM 服务器的值匹配。(X.X.X.X
是 PMM 服务器的 IP 地址。)在所有 PMM 客户端中使用唯一的主机名(值为
services.pmm-client.hostname
)。
确保一个可写的代理配置文件。
touch pmm-agent.yaml && chmod 0666 pmm-agent.yaml
复制运行 PMM 代理设置。这将运行和停止。
docker-compose up
复制编辑
docker-compose.yml
,注释掉该entrypoint
行(插入 a#
)并保存。...
# entrypoint: pmm-agent setup复制再次运行,这次使用 Docker分离选项。
docker-compose up -d
复制核实。
在命令行上。
docker exec pmm-client pmm-admin status
复制在图形用户界面中。
选择PMM Dashboards → System (Node) → Node Overview。
在节点名称菜单中,选择新节点。
更改时间范围以查看数据。
危险
pmm-agent.yaml
包含敏感凭据,不应共享。
包管理器
提示
如果您以前使用percona-release
过,请禁用并重新启用存储库:
percona-release disable all
percona-release enable original release复制
基于 Debian
配置存储库。
wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb
dpkg -i percona-release_latest.generic_all.deb复制安装 PMM 客户端软件包。
根权限
apt update
apt install -y pmm2-client复制查看。
pmm-admin --version
复制注册节点。
基于红帽
配置存储库。
yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
复制安装 PMM 客户端软件包。
yum install -y pmm2-client
复制查看。
pmm-admin --version
复制注册节点。
包管理器 - 手动下载
在Version: 下,选择您想要的(通常是最新的)。
在Software: 下,选择与您的软件平台匹配的项目。
点击下载打包文件:
对于 Debian、Ubuntu:
.deb
对于 Red Hat、CentOS、Oracle Linux:
.rpm
(或者,复制链接并用于wget
下载。)
以下是每个受支持平台的下载页面链接。
基于 Debian
dpkg -i *.deb复制
基于红帽
dnf localinstall *.rpm复制
二进制包
下载 PMM 客户端包:
wget https://downloads.percona.com/downloads/pmm2/2.23.0/binary/tarball/pmm2-client-2.23.0.tar.gz
复制下载 PMM 客户端包校验和文件:
wget https://downloads.percona.com/downloads/pmm2/2.23.0/binary/tarball/pmm2-client-2.23.0.tar.gz.sha256sum
复制验证下载。
sha256sum -c pmm2-client-2.23.0.tar.gz.sha256sum
复制解压包并进入目录。
tar xfz pmm2-client-2.23.0.tar.gz && cd pmm2-client-2.23.0
复制选择以下两个命令之一(取决于您的权限):
没有root权限
export PMM_DIR=YOURPATH
复制其中 YOURPATH 替换为您需要访问的真实路径。
有root权限
export PMM_DIR=/usr/local/percona/pmm2
复制运行安装程序。
Root 权限(如果您跳过了非 root 用户的第 5 步)
./install_tarball
复制改变路径。
PATH=$PATH:$PMM_DIR/bin
复制设置代理(根据权限为您选择命令)
根权限
pmm-agent setup --config-file=/usr/local/percona/pmm2/config/pmm-agent.yaml --server-address=192.168.1.123 --server-insecure-tls --server-username=admin --server-password=admin
复制非root用户
pmm-agent setup --config-file=${PMM_DIR}/config/pmm-agent.yaml --server-address=192.168.1.123 --server-insecure-tls --server-username=admin --server-password=admin --paths-tempdir=${PMM_DIR}/tmp --paths-base=${PMM_DIR}
复制运行代理。
pmm-agent --config-file=${PMM_DIR}/config/pmm-agent.yaml
复制打开一个新终端并检查。
pmm-admin status
复制
登记
向 PMM 服务器注册您的客户端节点。
pmm-admin config --server-insecure-tls --server-url=https://admin:admin@X.X.X.X:443复制
X.X.X.X
是您的 PMM 服务器的地址。443
是默认端口号。admin
/admin
是默认的 PMM 用户名和密码。这与您用于登录 PMM 用户界面的帐户相同,您可以在首次登录时选择更改该帐户。
重要的
客户端必须使用安全通道向 PMM 服务器注册。如果您使用 http 作为您的服务器 URL,PMM 将尝试通过端口 443 上的 https 进行连接。如果无法建立 TLS 连接,您将收到错误消息,您必须将 https 与适当的安全端口一起使用。
例子
192.168.33.14
使用默认admin/admin
用户名和密码在 PMM 服务器上注册具有 IP 地址的IP 地址192.168.33.23
、类型generic
和名称的节点mynode
。
pmm-admin config --server-insecure-tls --server-url=https://admin:admin@192.168.33.14:443 192.168.33.23 generic mynode复制
添加服务
您必须根据服务类型配置和添加服务。
提示
要更改先前添加的服务的参数,请删除该服务并使用新参数重新添加它。
删除
如何删除(卸载)PMM 客户端。
Docker
警告
这些步骤将删除 PMM 客户端 Docker 映像和客户端服务配置数据。
停止 pmm-client 容器。
docker stop pmm-client
复制移除容器。
docker rm pmm-client
复制删除图像。
docker rmi $(docker images | grep "percona/pmm-client" | awk {'print $3'})
复制删除卷。
docker volume rm pmm-client-data
复制
包管理器
基于 Debian 的发行版
卸载 PMM 客户端软件包。
apt remove -y pmm2-client
复制删除 Percona 存储库
dpkg -r percona-release
复制
基于 Red Hat 的发行版
卸载 PMM 客户端软件包。
yum remove -y pmm2-client
复制删除 Percona 存储库
yum remove -y percona-release
复制
注销
如何从 PMM 服务器注销 PMM 客户端。
pmm-admin unregister --force复制
该节点监控的所有服务都将从监控中移除。
删除服务
您必须指定服务类型和服务名称才能从监控中删除服务。
pmm-admin remove <service-type> <service-name>复制
service-type
一
mysql
,mongodb
,postgresql
,proxysql
,haproxy
,external
。
也可以看看
感谢paskal提供原始 Docker 撰写文件
页面更新 2021-10-21