开源APM监控Pinpoint的快速部署和使用

Pinpoint是用于大规模分布式系统的APM工具。它是在Dapper(一个由Google构建的分布式系统跟踪基础架构)之后构建的，为开发人员提供有关复杂分布式系统行为的更多信息。

开源地址：https://github.com/naver/pinpoint

Pinpoint作为一款非常优秀的开源APM监控平台，和其他开源系统一样，最繁琐的应该是部署，但是如果你能通过Docker的方式进行部署，我们就可以感受到一键部署的便捷：

Docker镜像地址：https://hub.docker.com/u/pinpointdocker

Docker-compose地址：https://github.com/naver/pinpoint-docker

一、部署前准备

在Centos7系统上安装Docker和docker-compose

yum update -y
yum install docker epel-release python-pip -y
pip install --upgrade pip
pip install docker-compose

对于docker-compose也可以安装指定版本（比如最新版的，因为不同版本支持不同格式的docker-compose文件）

yum update -y nss curl libcurl
sudo curl -L https://github.com/docker/compose/releases/download/1.23.2/docker-compose-Linux-x86_64 -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

为了加速docker镜像pull速度，可以修改daemon.json

# cat /etc/docker/daemon.json
{"registry-mirrors": ["http://579fe187.m.daocloud.io","https://pee6w651.mirror.aliyuncs.com"]}

启动docker

systemctl enable docker
systemctl start docker

二、安装Pinpoint

按照官网的docker部署方式：https://github.com/naver/pinpoint-docker （部署前把宿主机防火墙都关了）

git clone https://github.com/naver/pinpoint-docker.git
cd Pinpoint-Docker
docker-compose pull && docker-compose up -d

直接这样部署可能会有问题，比如我们只在一台宿主机上部署，我们可以用git命令下载，或是用curl命令先下载zip再解压：

sudo curl -L https://github.com/naver/pinpoint-docker/archive/master.zip -o /opt/pinpoint-docker.zip
cd /opt
upzip pinpoint-docker.zip -d .
cd /opt/pinpoint-docker-master

编辑docker-compose.yml，将多个节点的zookeeper改成一个节点（注释掉不需要的）：

#zookeeperszoo1:image: zookeeper:3.4restart: always#hostname: zoo1hostname: 172.17.2.84environment:ZOO_MY_ID: 1#ZOO_SERVERS: server.1=0.0.0.0:2888:3888 server.2=zoo2:2888:3888 server.3=zoo3:2888:3888ZOO_SERVERS: server.1=0.0.0.0:2888:3888networks:- pinpoint#zoo2:#  image: zookeeper:3.4#  restart: always#  hostname: zoo2#  environment:#    ZOO_MY_ID: 2#    ZOO_SERVERS: server.1=zoo1:2888:3888 server.2=0.0.0.0:2888:3888 server.3=zoo3:2888:3888#  networks:#    - pinpoint#zoo3:#  image: zookeeper:3.4#  restart: always#  hostname: zoo3#  environment:#    ZOO_MY_ID: 3#    ZOO_SERVERS: server.1=zoo1:2888:3888 server.2=zoo2:2888:3888 server.3=0.0.0.0:2888:3888#  networks:#    - pinpoint

如还有问题，请修改相对路径为绝对路径

...volumes:- /home/pinpoint/hbase- /home/pinpoint/zookeeper
...

基本我在根目录下，运行docker-compose up -d 就能完成docker集群的部署（在后台进行），如果是想看清部署的整个过程，直接用命令：

docker-compose up

启动完后容器：

用Rancher查看能比较直观：

安装完后，就可以连接http://172.17.2.84:8079查看，除了一个quickapp应用，什么也没有：

三、部署监控代理

为了监控我们的应用（tomcat、Java、weblogic等），就需要部署监控代理，这个非常简单，首先是去官网下载同版本的agent包：https://github.com/naver/pinpoint/releases/download/1.8.0/pinpoint-agent-1.8.0.tar.gz

将agent包解压到应用（以tomcat为例）目录下：

tar zxvf pinpoint-agent-1.8.0.tar.gz -C pinpoint-agent

修改配置文件pinpoint.config，将collector的ip配置为监控收集服务pinpoint-collector的IP：

然后修改tomcat的启动文件catalina.sh，添加javaagent配置参数（这一点和其他商用APM监控工具一样）：

JAVA_OPTS="$JAVA_OPTS -javaagent:/usr/apache-tomcat-7.0.54/pinpoint-agent/pinpoint-bootstrap-1.8.0.jar"
JAVA_OPTS="$JAVA_OPTS -Dpinpoint.agentId=APM-104"
JAVA_OPTS="$JAVA_OPTS -Dpinpoint.applicationName=tomcat7-test"

除了javaagent参数，还有agentId参数（应用的唯一标识，不允许和其他应用重名），和applicationName（应用名）。

配完后，就可以重启tomcat了，那么在界面上就能看到新追加的应用了：

对于微服务的jar包也能进行监控：

java -javaagent:/mypath/pinpoint-agent/pinpoint-bootstrap-1.8.0.jar -Dpinpoint.agentId=APM-104 -Dpinpoint.applicationName=tomcat7-test -jar myapp.jar

四、使用手册

1. 查看调用关系

1.1 访问地址
http://yoururl
1.2 选择应用

默认两层展示

调整层级深度：

示例为前端调用4层追溯，后端调用4层追溯（4层为最深层级）

结果展示：

在图片内按鼠标滚轮调整图片大小。

连线上数字为调用次数

选择更多时间范围（默认最新5分钟）

2. 查看调用链

鼠标按住右键，选中图中区域，松开右键，则展示选中时间段调用层级

展示结果：

默认按耗时排序

选中某一调用，展示详细调用链及耗时

选中timelinetab可查看耗时情况：

3. 查看错误信息

3.1 选择错误应用

机器应用抛出错误，机器应用会标红

3.2 查看详细信息
选中应用，去除成功多选按钮选中对勾，按住鼠标右键，选中红点范围，松开鼠标右键，即可查看详细错误信息：

结果为：

选中某次错误请求，可在详细列表内找到详细错误信息

4. 查看应用情况

选中某一应用
单击inspector

选中某一机器id，时间段，可展示jvm详细信息

其中内容包含：Jvm内存使用情况，Jvm永久带使用占用空间，Cpu使用情况，每秒处理的消息数（S标识操作系统，U标识此应用），Jvm线程情况，单请求平均响应时间等。