简介
Pinpoint是java编写的分布式系统系统调用跟踪工具
下载源码
- Pinpoint的源码再github上，地址,本文下载的版本是v1.7.2
配置编译环境
- 编译环境需要jdk、maven
- 快速开始文档上对JDK要求写的很明确:
1.需要安装JDK6，下载地址
2.需要安装JDK7，下载地址
3.需需要安装JDK8，下载地址
4.设置三个版本的环境变量，分别为JAVA_6_HOME、JAVA_7_HOME、JAVA_8_HOME
5.默认环境变量JAVA_HOME必须是JDK7以上的
- maven版本
文档上只给出了maven的运行命令，./mvnw install -Dmaven.test.skip=true，并没有说明maven的版本要求；网上的帖子都是说要求3.2版本以上的maven，但是经过实际测试发现3.3.9的版本不能编译成功，于是替换成当前最新的maven版本3.5.3，并修改环境变量MAVEN_HOME指向3.5.3版本，但不要忘记修改setting.xml的jar包仓库
编译
环境准备好后就可以开始编译了，window环境下进入到PinPoint目录运行命令"mvnw.cmd install -Dmaven.test.skip=true"
E:\workspace\git\pinpoint-master>mvnw.cmd install -Dmaven.test.skip=true
编译成功总耗时31分钟34秒，还是需要点耐心的
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 31:34 min
[INFO] Finished at: 2018-04-02T16:12:01+08:00
[INFO] Final Memory: 121M/1708M
[INFO] ------------------------------------------------------------------------
安装数据库
编译成功后还不能运行，Pinpoint依赖得数据库是Hbase，下载地址，本文下载的版本是v1.4.2
- 解压之后修改配置文件
1.修改hbase-env.cmd文件，设置JAVA_HOME环境变量；如果是linux环境请修改hbase-env.sh文件
2.新建hbase和zookeeper数据文件地址：E:\data\x\hbase和E:\data\x\zookeeper
3.修改hbase-site.xml文件，设置成刚新建的文件地址
<configuration>
<property>
<name>hbase.rootdir</name>
<value>file:///E:/data/x//hbase</value>
</property>
<property>
<name>hbase.zookeeper.property.dataDir</name>
<value>E:/data/x/zookeeper</value>
</property>
<property>
<name>hbase.zookeeper.property.clientPort</name>
<value>2182</value>
</property>
</configuration>
4.启动hbase，进入bin目录，运行start-hbase.cmd文件；此时使用的是hbase自带的zookeeper。
5.使用jps命令查看hbase进程是否启动
D:\java\hbase\hbase-1.4.2\bin>jps
14048 Program
15256 HMaster
20056
8952 Jps
6.初始化Pinpoint需要的数据表，数据表脚本在pinpoint-master\hbase\scripts\hbase-create.hbase文件中
hbase shell E:\workspace\git\pinpoint-master\hbase\scripts\hbase-create.hbase
7.查看导入的数据表，hbase shell进入hbase交互环境后，执行list命令查看表
D:\java\hbase\hbase-1.4.2\bin>hbase shell
hbase(main):001:0> list
TABLE
AgentEvent
AgentInfo
AgentLifeCycle
AgentStatV2
ApiMetaData
ApplicationIndex
ApplicationMapStatisticsCallee_Ver2
ApplicationMapStatisticsCaller_Ver2
ApplicationMapStatisticsSelf_Ver2
ApplicationStatAggre
ApplicationTraceIndex
HostApplicationMap_Ver2
SqlMetaData_Ver2
StringMetaData
TraceV2
15 row(s) in 0.2060 seconds
部署Pinpoint-collector
将pinpoint-master\collector\target下的pinpoint-collector-1.8.0-SNAPSHOT.war放到tomcat-8010的webapps下，并重命名为ROOT.war，修改配置文件
ROOT\WEB-INF\classes下的hbase.properties
hbase.client.host=localhost
hbase.client.port=2181
部署Pinpoint-web
与Pinpoint-collector类似，将pinpoint-master\web\target下的pinpoint-web-1.8.0-SNAPSHOT.war放入tomcat-8020并重命名为ROOT.war和修改配置文件，zookeeper服务就在本机可不修改，使用默认值
设置Pinpoint-agent
1.拷贝pinpoint-master\agent\target下的pinpoint-agent-1.8.0-SNAPSHOT.tar.gz文件到新建的pp-agent文件夹并解压；
2.修改配置文件pinpoint.config，profiler.collector.ip=127.0.0.1指向pinpoint-collector的ip
测试应用
1.使用pinpoint-master\quickstart\testapp提供的应用测试
2.进入testapp目录，运行mvn install -Dmaven.test.skip=true 编译app
3.拷贝生成的pinpoint-quickstart-testapp-null.war到tomcat-8030下的webapps，并改名为ROOT.war
4.修改当前tomcat-8030的bin/catalina.bat文件，添加启动参数
AGENT_VERSION="1.8.0-SNAPSHOT"
AGENT_PATH="/data/x/app/apm/pinpoint"
AGENT_ID="***项目ID***"
APPLICATION_NAME="***项目名称***"
CATALINA_OPTS="$CATALINA_OPTS -javaagent:$AGENT_PATH/pinpoint-bootstrap-$AGENT_VERSION.jar"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.agentId=$AGENT_ID"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.applicationName=$APPLICATION_NAME"
5.agentId必须唯一，与JVM对应；applicationName与应用对应。
jar包启动方式
java -javaagent:/data/x/app/apm/pinpoint/pinpoint-bootstrap-1.8.0-SNAPSHOT.jar -Dpinpoint.agentId=项目ID -Dpinpoint.applicationName=项目名称 -jar test.jar
备注
本文本身是在windows上编译，后来迁移到linux服务器集群上运行，目前除了dubbox无法识别，其他一切正常
- 关于dubbo无法识别的问题，目前发现是dubbo插件的一个bug，还未解决，下一步着手看一下插件源码
关于dubbox的思考
2017/04/17 昨天翻了pinpoint的源码，查看了pinpoint-dubbo插件的报错信息
com.navercorp.pinpoint.exception.PinpointException: not empty call stack
然后又下载了官方的pinpoint-plugin-sample插件demo项目查看，其实官方的项目里已经有rpc调用的链路监控了；
可以先暂时去掉dubbo插件运行，果然链路显示完整，log没有报错信息了
- 完整的链路图
为了保护公司项目信息，去掉了应用名称
dubbox.png
集群部署
pinpoint支持集群部署，通过需要配置Zookeeper地址
默认是集群模式：cluster.enable=true
cluster.enable=true
cluster.zookeeper.address=localhost
cluster.zookeeper.sessiontimeout=30000
