PinPoint链路工具单节点部署及客户端配置方法

在一次做项目中，需要涉及全链路压测，为了更好定位链路中某一节点可能会出现的问题，在繁忙之余，快速部署及应用了该链路工具，分享给大家~

话不多说，开始部署~

一、环境配置
1.1 获取需要的依赖包
进入home目录，创建一个"pp_res"的资源目录，用来存放需要安装的包

mkdir /home/pp_res
cd /home/pp_res/

使用xshell等类似的工具，将需要的文件上传到Linux虚拟机中，主要要传的文件都在百度网盘中
jdk7 --- Java运行环境
hbase-1.0 --- 数据库，用来存储监控信息
tomcat8.0 --- Web服务器
pinpoint-collector.war --- pp的控制器
pinpoint-web.war --- pp展示页面
pp-collector.init --- 用来快速启动pp-col，不要也可以
pp-web.init --- 用来快速启动pp-web，不要也可以

1.2 配置jdk1.7
# 这套APM系统主要是用jdk1.7来进行部署的，首先要配置jdk的环境变量

cd /home/pp_res/
tar -zxvf jdk-7u79-linux-x64.tar.gz
mkdir /usr/java
mv jdk1.7.0_79/ /usr/java/jdk17

# 配置java环境变量
vi /etc/profile

# 将下列复制到profile的最后一行中
export JAVA_HOME=/usr/java/jdk17
export PATH=$PATH:$JAVA_HOME/bin

# 让环境变量生效
source /etc/profile

# 测试java的环境变量是否配置好了
[root@localhost pp_res]# java -version
java version "1.7.0_79"
Java(TM) SE Runtime Environment (build 1.7.0_79-b15)
Java HotSpot(TM) 64-Bit Server VM (build 24.79-b02, mixed mode)

二、安装Hbase
pinpoint收集来的测试数据，主要是存在Hbase数据库的。所以它可以收集大量的数据，可以进行更加详细的分析。
2.1 将Hbase解压，并且放入指定目录
cd /home/pp_res/
tar -zxvf hbase-1.0.3-bin.tar.gz
mkdir -p /data/service
mv hbase-1.0.3/ /data/service/hbase

2.2修改hbase-env.sh环境变量
cd /data/service/hbase/conf/
vi hbase-env.sh
# 在27行左右的位置，修改如下
export JAVA_HOME=/usr/java/jdk17

2.3 修改Hbase的配置信息
vi hbase-site.xml

# 在结尾修改成如下，这里我们指定Hbase本地来存储数据，生产环境将数据建议存入HDFS中。这样配置是本地单实例模式启动，上面配置分别表示：数据存放地点、zookeeper数据存放地点、zookeeper端口号（默认2181）。当然这个文件可以不配置，那么会采取默认值。
<configuration>
　　<property>
　　　　<name>hbase.rootdir</name>
　　　　<value>file:///data/hbasedb</value>
　　</property>
<!--
　　<property>
　　　　<name>hbase.master.port</name>
　　　　<value>16010</value>
　　</property>
-->
</configuration>

2.4 启动hbase
cd /data/service/hbase/bin
./start-hbase.sh
# 查看Hbase是否启动成功，如果启动成功的会看到"HMaster"的进程
[root@localhost bin]# jps
12075 Jps
11784 HMaster

2.5 初始化Hbase的pinpoint库
# 执行pinpoint提供的Hbase初始化语句，这时会初始化一会。
./hbase shell /home/pp_res/hbase-create.hbase

# 执行完了以后，进入Hbase，status 'detailed'可以查看刚才初始化的表，是否存在

也可以登录web，来查看HBase的数据是否初始化成功

HbaseWeb : http://主机IP:16010/master-status

三、安装pinpoint-collector
3.1 部署war包
# 解压Tomcat，将Tomcat重命名移动到指定位置
cd /home/pp_res/
tar -zxvf apache-tomcat-8.0.36.tar.gz
mv apache-tomcat-8.0.36/ /data/service/pp-col
# 修改pp-col的Tomcat的配置，主要修改端口，避免与pp-web的Tomcat的端口冲突。我在原本默认的端口前都加了1，下面是替换的shell命令。
#【注意】最后一条是将tomcat的私有ip开放，需要将localhost替换成本机的ip，我本机的网卡是默认的，如果你本机的网卡不是eth0，需要进行相关的修改。或者直接用"vi"进去，修改localhost
cd /data/service/pp-col/conf/
sed -i 's/port="8005"/port="18005"/g' server.xml
sed -i 's/port="8080"/port="18080"/g' server.xml
sed -i 's/port="8443"/port="18443"/g' server.xml
sed -i 's/port="8009"/port="18009"/g' server.xml
sed -i 's/redirectPort="8443"/redirectPort="18443"/g' server.xml
sed -i "s/localhost/192.168.0.2/g" server.xml（某主机IP替换）或
(sed -i "s/localhost/`ifconfig eth0 | grep 'inet addr' | awk '{print $2}' | awk -F: '{print $2}'`/g" server.xml)

# 部署pinpoint-collector.war包
#【注意：如果没有unzip命令，可以 "yum install unzip" 】
cd /home/pp_res/
rm -rf /data/service/pp-col/webapps/*
unzip pinpoint-collector-1.5.2.war -d /data/service/pp-col/webapps/ROOT

# 启动Tomcat
cd /data/service/pp-col/bin/
./startup.sh

# 查看日志，是否成功启动
tail -f ../logs/catalina.out

3.2 配置快速启动(后期可选配)

【
# 配置快速启动需要修改pp-collector.init的路径( pp-collector在网盘里面有 )，可以"vi"进去，大概在18，24，27行处，修改相关的路径。我这边为了方便，直接就用替换的shell做了，如果路径与我的不一致，需要将路径修改成自己的路径。
cd /home/pp_res
sed -i "s/JAVA_HOME=/usr/java/default//JAVA_HOME=/usr/java/jdk17/g" pp-collector.init
sed -i "s/CATALINA_HOME=/data/service/pinpoint-collector//CATALINA_HOME=/data/service/pp-col//g" pp-collector.init
sed -i "s/CATALINA_BASE=/data/service/pinpoint-collector//CATALINA_BASE=/data/service/pp-col//g" pp-collector.init

# 将文件赋予"执行"的权限，把它放到"init.d"中去。以后就可以restart快速重启了。
chmod 711 pp-collector.init
mv pp-collector.init /etc/init.d/pp-col

# 测试一下restart
[root@localhost pp_res]# /etc/init.d/pp-col restart
Stoping Tomcat
Using CATALINA_BASE: /data/service/pp-col/
Using CATALINA_HOME: /data/service/pp-col/
Using CATALINA_TMPDIR: /data/service/pp-col//temp
Using JRE_HOME: /usr/java/jdk17/
Using CLASSPATH: /data/service/pp-col//bin/bootstrap.jar:/data/service/pp-col//bin/tomcat-juli.jar

waiting for processes to exitStarting tomcat
Using CATALINA_BASE: /data/service/pp-col/
Using CATALINA_HOME: /data/service/pp-col/
Using CATALINA_TMPDIR: /data/service/pp-col//temp
Using JRE_HOME: /usr/java/jdk17/
Using CLASSPATH: /data/service/pp-col//bin/bootstrap.jar:/data/service/pp-col//bin/tomcat-juli.jar
Tomcat started.
Tomcat is running with pid: 22824

】

四、安装pinpoint-web
4.1 部署war包
# 解压Tomcat，将Tomcat重命名移动到指定位置
cd /home/pp_res/
tar -zxvf apache-tomcat-8.0.36.tar.gz
mv apache-tomcat-8.0.36/ /data/service/pp-web

# 修改pp-web的Tomcat的配置，主要修改端口，避免与pp-col的Tomcat的端口冲突。我在原本默认的端口前都加了2，下面是替换的shell命令
#【注意】最后一条是将tomcat的私有ip开放，需要将localhost替换成本机的ip，我本机的网卡是默认的，如果你本机的网卡不是eth0，需要进行相关的修改。或者直接用"vi"进去，修改localhost
cd /data/service/pp-web/conf/
sed -i 's/port="8005"/port="28005"/g' server.xml
sed -i 's/port="8080"/port="28080"/g' server.xml
sed -i 's/port="8443"/port="28443"/g' server.xml
sed -i 's/port="8009"/port="28009"/g' server.xml
sed -i 's/redirectPort="8443"/redirectPort="28443"/g' server.xml
sed -i "s/localhost/192.168.0.2/g" server.xml（某主机IP替换）或
（sed -i "s/localhost/`ifconfig eth0 | grep 'inet addr' | awk '{print $2}' | awk -F: '{print $2}'`/g" server.xml）

# 部署pinpoint-web.war包
#【注意：如果没有unzip命令，可以 "yum install unzip" 】
cd /home/pp_res/
rm -rf /data/service/pp-web/webapps/*
unzip pinpoint-web-1.5.2.war -d /data/service/pp-web/webapps/ROOT

# 启动Tomcat
cd /data/service/pp-web/bin/
./startup.sh

# 查看日志，Tocmat是否启动成功
tail -f ../logs/catalina.out

# 日志中出现下面这句话，说明已经启动成功了
org.apache.catalina.startup.Catalina.start Server startup in 79531 ms

# 这时候我们可以访问一下这个地址，在浏览器中输入"http://192.168.0.2:28080"，就会出现主页面了
# 如果访问不了的话，关闭防火墙
[root@localhost conf]# /etc/init.d/iptables stop
iptables: Setting chains to policy ACCEPT: filter [ OK ]
iptables: Flushing firewall rules: [ OK ]
iptables: Unloading modules: [ OK ]

五、【自测可用】部署pp-agent客户端采集监控数据
5.1 在测试系统中，部署pp-agent采集监控数据

部署采集器就很简单了，只需要加3句话就好了。我这边做一个测试的Tomcat，来模拟部署。

首先，先建立一个文件夹，放测试需要的包
5.2 配置模拟的Tomcat测试环境
# 为了方便观察，配置一个假的系统，解压Tomcat到指定目录
cd /home/pp_test
mkdir /data
tar -zxvf apache-tomcat-8.0.36.tar.gz

# 配置localhost让外部可以访问
cd /data/pp-test/conf/
sed -i "s/localhost/`ifconfig eth0 | grep 'inet addr' | awk '{print $2}' | awk -F: '{print $2}'`/g" server.xml

# 解压测试用的war包
cd /home/pp_test/
rm -rf /data/pp-test/webapps/*
unzip test.war -d /data/pp-test/webapps/ROOT

5.3 配置pp-agent采集器
# 解压pp-agent
cd /home/pp_test
tar -zxvf pinpoint-agent-1.5.2.tar.gz
mv pinpoint-agent-1.5.2 /data/pp-agent

# 编辑配置文件
cd /data/pp-agent/
vi pinpoint.config

# 主要修改IP，只需要指定到安装pp-col的IP就行了，安装pp-col启动后，自动就开启了9994，9995，9996的端口了。这里就不需要操心了，如果有端口需求，要去pp-col的配置文件("pp-col/webapps/ROOT/WEB-INF/classes/pinpoint-collector.properties")中，修改这些端口
profiler.collector.ip=192.168.0.2(PP部署的主机IP)

# 修改测试项目下的tomcat启动文件"catalina.sh"，修改这个只要是为了监控测试环境的Tomcat，增加探针
cd /data/pp-test/bin
vi catalina.sh

# 在20行增加如下字段
# 第一行是pp-agent的jar包位置
# 第二行是agent的ID，这个ID是唯一的，我是用pp + 今天的日期命名的，只要与其他的项目的ID不重复就好了
# 第三行是采集项目的名字，这个名字可以随便取，只要各个项目不重复就好了
CATALINA_OPTS="$CATALINA_OPTS -javaagent:/data/pp-agent/pinpoint-bootstrap-1.5.2.jar"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.agentId=pp20161122"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.applicationName=MyTestPP
5.4 监控Tomcat
# 配置好了。就可以开始监控了，我们启动测试用的Tomcat的服务器
cd /data/pp-test/bin/
./startup.sh

# 查看启动日志，确实Tomcat启动
tail -f ../logs/catalina.out

六、PinPoint客户端部署（自总结-可参考）

6.1基于JDK，一般都是这种
1）上传agent到应用用户根目录
cd ~
2）并agent解压
tar -zxvf pinpoint-agent.tar.gz
3）应用服务启动脚本配置（该配置项在堆内存-Xmx后，或者-jar前进行配置）
-javaagent:/home/was/pinpoint-agent/pinpoint-bootstrap-1.5.2.jar -Dpinpoint.agentId=MC_186.39 -Dpinpoint.applicationName=QLL1

# 第一段是pp-agent的jar包位置（/home/was/pinpoint-agent为上传包所在真实路径）
# 第二段是agent的ID，这个ID是唯一的
# 第三段是采集项目的名字

例如一些应用服务：
#nohup java -javaagent:/home/was/pinpoint-agent/pinpoint-bootstrap-1.5.2.jar -Dpinpoint.agentId=MC_186.39 -Dpinpoint.applicationName=QLL1 -jar spring-boot-sample.jar --spring.profiles.active=test > catalina.out 2>&1 &
#启动参数
JAVA_OPTS="-server -Xms400m -Xmx400m -Xmn300m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=128m -Xverify:none -XX:+DisableExplicitGC -javaagent:/home/was/pinpoint-agent/pinpoint-bootstrap-1.7.0-RC1.jar -Dpinpoint.agentId=MC_186.39 -Dpinpoint.applicationName=QLL1"

6.2WAS配置

在服务-JAVA虚拟机-通用JVM参数，配置

6.3tomcat部署方式：
1）上传agent到应用用户根目录
cd ~
2）并agent解压
tar -zxvf pinpoint-agent.tar.gz
3）修改测试项目下的tomcat启动文件"catalina.sh"，修改这个只要是为了监控测试环境的Tomcat，增加探针
cd /data/pp-test/bin
vi catalina.sh
# 在20行增加如下字段
# 第一行是pp-agent的jar包位置
# 第二行是agent的ID，这个ID是唯一的
# 第三行是采集项目的名字
CATALINA_OPTS="$CATALINA_OPTS -javaagent:/data/pinpoint-agent/pinpoint-bootstrap-1.5.2.jar"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.agentId=MC_186.39"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.applicationName=QLL1
# 配置好了。就可以开始监控了~