暂无图片
暂无图片
暂无图片
暂无图片
暂无图片

[ACDU 翻译] MySQL 设置 PMM 客户端

原创 由迪 2021-10-22
895

有多种方法可以在节点上安装 PMM 客户端并将其注册到 PMM 服务器。从中选择:

  • Docker:将 PMM 客户端作为 Docker 容器直接运行或使用 Docker compose 运行。

  • 包管理器

    • 在 Debian 或 Red Hat Linux 上,安装percona-release并使用 Linux 包管理器 ( apt/ dnf) 来安装 PMM 客户端。

    • 在 Debian 或 Red Hat 上,下载.deb/ .rpmPMM 客户端软件包并手动安装它们。

二进制是没有 root 权限安装 PMM 客户端的唯一方法

  • 二进制包:对于其他 Linux 发行版,下载并解压通用 PMM 客户端 Linux 二进制文件。

安装 PMM 客户端后,您必须:

如果需要,您可以取消注册删除服务删除 PMM 客户端


以下是选择的概述。

uml图

在你开始之前

  • 使用可从客户端节点访问的已知 IP 地址设置 PMM 服务器

  • 您在客户端主机上拥有超级用户 (root) 访问权限。

  • 您拥有对要监视的任何数据库服务器的超级用户访问权限。

  • 这些 Linux 软件包已安装:curlgnupgsudowget

  • 如果使用它,请安装Docker

  • 如果使用它,请安装Docker compose

  • 系统要求:

    • 操作系统 – PMM 客户端可在任何现代 64 位 Linux 发行版上运行。它在支持的 Debian、Ubuntu、CentOS 和 Red Hat Enterprise Linux 版本上进行了测试。(请参阅Percona 软件支持生命周期)。

    • 磁盘 – 安装 PMM 客户端软件包至少需要 100 MB 的存储空间。通过与 PMM 服务器的良好连接,不需要额外的存储。但是,客户端需要存储它无法立即分发的任何收集的数据,因此如果连接不稳定或吞吐量低,则可能需要额外的存储。(缓存仅适用于 Query Analytics 数据;VictoriaMetrics 数据从不缓存在客户端。)

安装

Docker

PMM客户泊坞窗图像是运行PMM客户端作为一个预配置的便捷方式泊坞窗容器。

  1. 拉取 PMM 客户端泊坞窗图像。

    docker pull \
    percona/pmm-client:2
    复制
  2. 使用图像作为模板来创建持久数据存储,在更新图像时保留本地数据。

    docker create \
    --volume /srv \
    --name pmm-client-data \
    percona/pmm-client:2 /bin/true
    复制
  3. 运行容器以在设置模式下启动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
    复制

提示

您可以在此处找到兼容环境变量的完整列表。

  1. 检查状态。

    docker exec pmm-client \
    pmm-admin status
    复制

    在 PMM 用户界面中,您还将看到受监控节点数量的增加。

您现在可以pmm-admin通过在命令前加上前缀来添加服务docker exec pmm-client

提示

  • 调整主机防火墙和路由规则以允许 Docker 通信。(阅读更多

  • 求助: docker run --rm percona/pmm-client:2 --help

Docker 组合

  1. 将此文本复制并粘贴到名为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)。

  2. 确保一个可写的代理配置文件。

    touch pmm-agent.yaml && chmod 0666 pmm-agent.yaml
    复制
  3. 运行 PMM 代理设置。这将运行和停止。

    docker-compose up
    复制
  4. 编辑docker-compose.yml,注释掉该entrypoint行(插入 a #)并保存。

    ...
    #       entrypoint: pmm-agent setup
    复制
  5. 再次运行,这次使用 Docker分离选项。

    docker-compose up -d
    复制
  6. 核实。

    在命令行上。

    docker exec pmm-client pmm-admin status
    复制

    在图形用户界面中。

    • 选择PMM DashboardsSystem (Node)Node Overview

    • 节点名称菜单中,选择新节点。

    • 更改时间范围以查看数据。

危险

pmm-agent.yaml 包含敏感凭据,不应共享。

包管理器

提示

如果您以前使用percona-release过,请禁用并重新启用存储库:

percona-release disable all
percona-release enable original release
复制

基于 Debian

  1. 配置存储库。

    wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb
    dpkg -i percona-release_latest.generic_all.deb
    复制
  2. 安装 PMM 客户端软件包。

    根权限

    apt update
    apt install -y pmm2-client
    复制
  3. 查看。

    pmm-admin --version
    复制
  4. 注册节点

基于红帽

  1. 配置存储库。

    yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
    复制
  2. 安装 PMM 客户端软件包。

    yum install -y pmm2-client
    复制
  3. 查看。

    pmm-admin --version
    复制
  4. 注册节点

包管理器 - 手动下载

  1. 访问Percona Monitoring and Management 2 下载页面。

  2. Version: 下,选择您想要的(通常是最新的)。

  3. Software: 下,选择与您的软件平台匹配的项目。

  4. 点击下载打包文件:

    • 对于 Debian、Ubuntu: .deb

    • 对于 Red Hat、CentOS、Oracle Linux: .rpm

(或者,复制链接并用于wget下载。)

以下是每个受支持平台的下载页面链接。

基于 Debian

dpkg -i *.deb
复制

基于红帽

dnf localinstall *.rpm
复制

二进制包

  1. 下载 PMM 客户端包:

    wget https://downloads.percona.com/downloads/pmm2/2.23.0/binary/tarball/pmm2-client-2.23.0.tar.gz
    复制
  2. 下载 PMM 客户端包校验和文件:

    wget https://downloads.percona.com/downloads/pmm2/2.23.0/binary/tarball/pmm2-client-2.23.0.tar.gz.sha256sum
    复制
  3. 验证下载。

    sha256sum -c pmm2-client-2.23.0.tar.gz.sha256sum
    复制
  4. 解压包并进入目录。

    tar xfz pmm2-client-2.23.0.tar.gz && cd pmm2-client-2.23.0
    复制
  5. 选择以下两个命令之一(取决于您的权限):

    没有root权限


    export PMM_DIR=YOURPATH
    复制

    其中 YOURPATH 替换为您需要访问的真实路径。


    有root权限

    export PMM_DIR=/usr/local/percona/pmm2
    复制
  6. 运行安装程序。

    Root 权限(如果您跳过了非 root 用户的第 5 步)

    ./install_tarball
    复制
  7. 改变路径。

    PATH=$PATH:$PMM_DIR/bin
    复制
  8. 设置代理(根据权限为您选择命令)

    根权限

    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}
    复制
  9. 运行代理。

    pmm-agent --config-file=${PMM_DIR}/config/pmm-agent.yaml
    复制
  10. 打开一个新终端并检查。

    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 映像和客户端服务配置数据。

  1. 停止 pmm-client 容器。

    docker stop pmm-client
    复制
  2. 移除容器。

    docker rm pmm-client
    复制
  3. 删除图像。

    docker rmi $(docker images | grep "percona/pmm-client" | awk {'print $3'})
    复制
  4. 删除卷。

    docker volume rm pmm-client-data
    复制

包管理器

基于 Debian 的发行版

  1. 卸载 PMM 客户端软件包。

    apt remove -y pmm2-client
    复制
  2. 删除 Percona 存储库

    dpkg -r percona-release
    复制

基于 Red Hat 的发行版

  1. 卸载 PMM 客户端软件包。

    yum remove -y pmm2-client
    复制
  2. 删除 Percona 存储库

    yum remove -y percona-release
    复制

注销

如何从 PMM 服务器注销 PMM 客户端。

pmm-admin unregister --force
复制

该节点监控的所有服务都将从监控中移除。

删除服务

您必须指定服务类型和服务名称才能从监控中删除服务。

pmm-admin remove <service-type> <service-name>
复制
  • service-type

    mysqlmongodbpostgresqlproxysqlhaproxyexternal

也可以看看

  • 页面更新 2021-10-21

「喜欢这篇文章,您的关注和赞赏是给作者最好的鼓励」
关注作者
【版权声明】本文为墨天轮用户原创内容,转载时必须标注文章的来源(墨天轮),文章链接,文章作者等基本信息,否则作者和墨天轮有权追究责任。如果您发现墨天轮中有涉嫌抄袭或者侵权的内容,欢迎发送邮件至:contact@modb.pro进行举报,并提供相关证据,一经查实,墨天轮将立刻删除相关内容。

评论