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
# 配置好了。就可以開始監控了~