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改成一个节点(注释掉不需要的):
#zookeepers
zoo1:
image: zookeeper:3.4
restart: always
#hostname: zoo1
hostname: 172.17.2.84
environment:
ZOO_MY_ID: 1
#ZOO_SERVERS: server.1=0.0.0.0:2888:3888 server.2=zoo2:2888:3888 server.3=zoo3:2888:3888
ZOO_SERVERS: server.1=0.0.0.0:2888:3888
networks:
- 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线程情况,单请求平均响应时间等。