PMM Client Docker镜像文档

镜像概述和主要用途

本镜像为PMM Client的Docker化部署版本，PMM（Percona Monitoring and Management）是Percona提供的开源数据库监控和管理工具，包含Server和Client两个核心组件。PMM Client作为客户端组件，主要负责从数据库及相关服务（如MySQL、MongoDB、PostgreSQL等）收集监控指标数据，并将数据发送至PMM Server，配合PMM Server实现对数据库环境的监控数据存储、分析与可视化展示。

核心功能和特性

• 多数据库监控支持：支持对MySQL、MongoDB、PostgreSQL、ProxySQL等多种数据库及中间件的监控数据采集。
• 全面指标采集：可采集性能指标（如CPU、内存使用率）、查询性能（如慢查询）、连接数、事务量等关键监控指标。
• 与PMM Server无缝集成：通过网络与PMM Server通信，实现监控数据的实时传输与集中管理。
• 轻量级部署：基于Docker容器化部署，简化安装配置流程，降低环境依赖。
• 灵活配置：支持通过环境变量、命令行参数等方式配置与PMM Server的连接信息及监控项。

使用场景和适用范围

适用场景

• 需对MySQL、MongoDB等数据库集群进行集中监控的生产环境。
• 需要快速部署监控客户端，避免直接在数据库主机安装依赖的场景。
• 多节点数据库环境中，统一管理监控客户端配置的场景。

适用范围

• 支持监控的数据库类型：MySQL、MariaDB、MongoDB、PostgreSQL、ProxySQL等。
• 支持的操作系统：基于Docker的Linux环境（需满足Docker运行条件）。
• 需配合PMM Server使用，PMM Server版本需与Client版本兼容（建议使用相同主版本）。

使用方法和配置说明

前提条件

• 已部署PMM Server（参考PMM Server部署文档）。
• 确保PMM Client容器可网络访问PMM Server（开放相关端口，默认PMM Server端口为443）。
• 数据库主机需允许PMM Client访问数据库服务（如开放数据库端口、授权监控用户权限）。

基本部署示例（docker run）

docker run -d \
  --name pmm-client \
  --network host \  # 建议使用host网络以直接访问主机上的数据库服务（或根据网络环境调整）
  -e PMM_SERVER_URL=[***]<pmm-server-ip>:443 \  # PMM Server地址，格式为https://<用户名>:<密码>@<server-ip>:<端口>
  -e NODE_NAME=db-node-1 \  # 客户端节点名称，用于在PMM Server中标识当前客户端
  -v /var/lib/pmm-client:/var/lib/pmm-client \  # 持久化客户端配置数据
  percona/pmm-client:latest

关键配置参数（环境变量）

配置监控实例示例

PMM Client启动后，需通过pmm-admin命令添加监控实例（在容器内执行）：

1. 进入容器：

   docker exec -it pmm-client bash
   

2. 添加MySQL监控实例（需先在MySQL中创建监控用户并授权）：

   pmm-admin add mysql --username=<mysql-monitor-user> --password=<mysql-monitor-password> --host=<mysql-host> --port=3306 mysql-instance-1
   

3. 验证监控实例状态：

   pmm-admin list
   

参考文档

更多详细配置及使用说明，请参考官方文档：<[***]>