苍穹环境中的PMM安装配置指南

1 PMM简介

PMM  全称 Percona Monitoring and Management，是一款开源的监控平台，主要用于监控主机、MySQL 、PG、mongoDB性能。同时，也可以通过扩展其内置的Grafana模块，监控中间件、k8s、容器等组件。本文主要介绍PMM在苍穹环境下的主机、数据库监控功能安装配置。

PMM架构如下：

PMM client：部署在每个监控主机（如数据库主机）上，搜集主机、数据库、SQL慢查询等数据。

PMM Server：汇集数据并展示。提供表，dashboards和graph的web界面。

2 PMM安装

2.1 PMM Server(服务端)安装

(1).登录gPaaS master主机（推荐）或 苍穹应用master主机 

(2).将pmm server服务镜像(点击下载)上传到主机上

(3). 导入镜像：docker load -i pmm-server-v2.41.1.tar

(4).创建持久化数据容器：docker create --volume /srv --name pmm-data kcr.kingdee.com/gpaas/pmm-server:2.41.1 /bin/true

(5).运行pmm server容器：

docker run --detach --restart always --publish 8093:443 --volumes-from pmm-data  --name pmm-server kcr.kingdee.com/gpaas/pmm-server:2.41.1

注：8093 为主机开放的访问端口，可根据需要自行修改

(6). 浏览器登录pmm server控制台

• 登录地址：https://192.168.1.2:8093/graph/login

      注：192.168.1.2 为主机的IP，8093为上述运行容器设置的主机映射端口

• 默认登录账户：admin,默认登录密码：admin

注：由于PMM server端负责了大量数据库的性能数据清洗和分析，建议在原k8s主机资源配备基础上，增加至少2核 CPU，8G内存和500G磁盘的资源

2.2 PMM Client agent（客户端代理）安装

(1).使用root权限账户登录苍穹数据库主机（目前PMM只能监控PG或MySQL） 

(2).将pmm client二进制安装包(点击下载)上传到主机上

(3). 解压安装包：tar xfz pmm2-client-2.41.1.tar.gz && cd pmm2-client-2.41.1

(4).在主机上设置pmm安装目录环境变量：export PMM_DIR=/usr/local/percona/pmm2

(5).执行client安装：./install_tarball

(6).设置主机环境变量：PATH=$PATH:$PMM_DIR/bin

(7). 配置Client agent: 

pmm-agent setup --config-file=/usr/local/percona/pmm2/config/pmm-agent.yaml --server-address=192.168.1.2:8093 --server-insecure-tls --server-username=admin --server-password=admin 172.25.2.3 generic PG_172.25.2.3

注：server-address为前面步骤设置的pmm server地址， server-username 和 server-password 为 前面步骤设置的pmm server登录账户密码，172.25.2.3为数据库主机的IP地址，PG_172.25.2.3 为该数据库主机的标签(用于多数据库监控时的界面检索，建议配置规则为：数据库缩写+数据库主机IP地址后两位)；其他参数按照上述进行配置即可

(8). 运行Client agent:  nohup pmm-agent --config-file=${PMM_DIR}/config/pmm-agent.yaml &

(9). 检查client agent运行状态：pmm-admin status

注：若部署了多台苍穹数据库，则每台数据库主机都需要执行上述1-9步骤来安装pmm client agent；客户端的安装需要在原数据库主机基础上， 增加至少1核 CPU，2G内存资源

2.3 PMM Client service(客户端服务) 配置

2.3.1 PG数据库的服务配置

(1). 登录任一一台PG数据库主机 

(2). 将PG服务增加值PMM Server端进行监控：

pmm-admin add  postgresql --host=172.25.2.3 --password=Cosmic@2321 --port=5432 --username=cosmic PG_Service_172.25.2.3 --query-source="pgstatements"

注：host 为PG数据库主机IP, username、password、port 为P