中介軟體---分散式跟蹤---Pinpoint

FeelTouch發表於2019-02-16
分散式

本文初衷

因為工作需要，這周研究了一下APM（Application Performance Management）相關技術，看了些許資料，對比了各種技術的特點，最終選擇Pinpoint作為效能監控工具，本文的主要目的是記錄本人部署Pinpoint的過程。

Pinpoint是什麼

簡單的說，Pinpoint是一款對Java編寫的大規模分散式系統的APM工具，有些人也喜歡稱呼這類工具為呼叫鏈系統、分散式跟蹤系統。我們知道，前端向後臺發起一個查詢請求，後臺服務可能要呼叫多個服務，每個服務可能又會呼叫其它服務，最終將結果返回，彙總到頁面上。如果某個環節發生異常，工程師很難準確定位這個問題到底是由哪個服務呼叫造成的，Pinpoint等相關工具的作用就是追蹤每個請求的完整呼叫鏈路，收集呼叫鏈路上每個服務的效能資料，方便工程師能夠快速定位問題。

同類工具

為什麼要用Pinpoint

最重要的原因，對程式碼的零侵入，運用JavaAgent位元組碼增強技術，只需要加啟動引數即可。

Pinpoint架構圖

pinpoint-architecture

（圖片出處：官網）架構說明：

  • Pinpoint-Collector：收集各種效能資料
  • Pinpoint-Agent：和自己執行的應用關聯起來的探針
  • Pinpoint-Web：將收集到的資料顯示成WEB網頁形式
  • HBase Storage：收集到的資料存到HBase中

開始部署

前提條件

  • maven 3.2.x+
  • git
  • java 6+

0. 開始

1. 部署Hbase

Pinpoint以Hbase作為資料的儲存。

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_121.jdk/Contents/Home
  • 編輯hbase-site.xml：
<configuration>
    <property>
        <name>hbase.rootdir</name>
        <value>file:///Users/acheron/Tmp/hbase</value>
    </property>
    <property>
        <name>hbase.zookeeper.property.dataDir</name>
        <value>/Users/acheron/Tmp/zookeeper</value>
    </property>
    <property>
        <name>hbase.zookeeper.property.clientPort</name>
        <value>2182</value>
  </property>
</configuration>

這樣配置是本地單例項模式啟動，上面配置分別表示：資料存放地點、zookeeper資料存放地點、zookeeper埠號（預設2181）。當然這個檔案可以不配置，那麼會採取預設值。

啟動hbase的時候，hbase用得是自帶的zk，在hbase的配置裡可見 export HBASE_MANAGES_ZK=true；

  • 進入hbase/bin目錄啟動hbase：./start-hbase.sh
  • 用jps命令檢視Hbase是否啟動成功，如果啟動成功的會看到”HMaster”的程式
  • 初始化pinpoint需要的表：./hbase shell hbase-create.hbase (這裡的hbase-create.hbase在原始碼pinpoint/hbase/scripts/hbase-create.hbase)
  • 訪問頁面測試是否成功：http://localhost:16010/master-status ，如果成功在頁面的tables標籤下能看到匯入的表。
  • 也可以用命令來檢視是否匯入表成功，進入hbase，輸入”status ‘detailed'”可以檢視初始化的表
./hbase shell
status 'detailed'

2. 部署Pinpoint-collector

  • 將pinpoint-collector-1.6.0-SNAPSHOT.war放到tomcat-collector-8086/webapps/下，並重新命名為ROOT.war
  • 啟動tomcat，配置ROOT/WEB-INF/classes/hbase.properties:
hbase.client.host=localhost
hbase.client.port=2181

指向zookeeper的地址和埠，如果是本機，埠預設，則這裡不需更改。

  • 配置上面後，重啟tomcat（埠8086）

3. 部署Pinpoint-web

Pinpoint-web的配置和Pinpoint-collector相似：

  • 將pinpoint-web-1.6.0-SNAPSHOT.war放到tomcat-web-8085/webapps/下，並重新命名為ROOT.war
  • 啟動tomcat，配置ROOT/WEB-INF/classes/hbase.properties:
hbase.client.host=localhost
hbase.client.port=2181

指向zookeeper的地址和埠，如果是本機，埠預設，則這裡不需更改。

  • 配置上面後，重啟tomcat（埠8085）

4. 部署Pinpoint-agent

  • 新建目錄：mkdir pp-agent
  • 將pinpoint-agent-1.6.0-SNAPSHOT.tar.gz 拷貝到pp-agent目錄並解壓
  • 配置pinpoint.config：profiler.collector.ip=127.0.0.1這是指pinpoint-collector的地址，如果是同一伺服器，則不用修改。其它預設。
  • 安裝pinpoint-collector啟動後，自動就開啟了9994，9995，9996的埠了，這裡預設即可。如果有埠需求，要去pinpoint-collector的配置檔案(“pinpoint-collector/webapps/ROOT/WEB-INF/classes/pinpoint-collector.properties”)中，修改這些埠。

5. 部署TestApp

  • 官方提供了一個測試用的應用，pinpoint-quickstart-testapp-null.war，將其重新命名為ROOT.war，部署到tomcat-testapp-8084
  • 修改此tomat的/bin/catalina.sh，在106行左右加入啟動引數：
CATALINA_OPTS="$CATALINA_OPTS -javaagent:/Users/acheron/pinpoint/pp-agent/pinpoint-bootstrap-1.6.0.jar"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.agentId=myapp"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.applicationName=MyTestPP"

第一行：pinpoint-bootstrap-1.6.0.jar的位置

第二行：這裡的agentId必須唯一,標誌一個jvm。

第三行：applicationName表示同一種應用：同一個應用的不同例項應該使用不同的agentId,相同的applicationName。

6. springboot包部署

如果是jar包部署，直接在啟動命令加啟動引數：

nohup java -javaagent:/Users/acheron/pinpoint/pp-agent/pinpoint-bootstrap-1.6.0.jar -Dpinpoint.agentId=acheron-consumer -Dpinpoint.applicationName=acheron-consumer -jar myapp.jar &

7.效果演示

hbase和各應用都啟動成功之後，訪問Pinpoint-web，效果:

pinpoint-page

結束語

各大APM工具，幾乎都是根據google這篇經典的Dapper論文而來，一定要讀一讀。這裡是它的源文地址：https://research.google.com/pubs/pub36356.html，感謝這位同學的翻譯：http://bigbully.github.io/Dapper-translation/

參考文章

相關文章