### 歡迎訪問我的GitHub
> 這裡分類和彙總了欣宸的全部原創(含配套原始碼)：[https://github.com/zq2599/blog_demos](https://github.com/zq2599/blog_demos)

### 關於pinpoint
- pinpoint是一款呼叫鏈跟蹤工具，目前最新版是1.8.5，官方GitHub地址：https://github.com/naver/pinpoint
### 構造用於實戰的分散式環境
- 今天的實戰會先準備一個簡單的分散式環境，裡面有兩個SpringBoot應用，以及mysql、redis，再加上部署pinpoint的伺服器，一共用到了五臺機器，如下表所示：

| 主機名 | IP地址 | 作用 |
|--|--|--|
| pinpoint | 192.168.121.148 | pinpoint服務部署所在機器 |
| service-a | 192.168.121.146 | 提供兩個介面：<br>1.  add : 向mysql新增一條記錄，並且呼叫service-b的set介面<br>2. get : 呼叫service-b的get介面查詢資料，如果沒有就從mysql中查詢 |
| service-b | 192.168.121.147 | 提供兩個介面：<br>1.  get: 從redis中查詢指定的記錄<br>2. set : 將資料寫入redis，有效期為30秒 |
| mysql | 192.168.121.143 | mysql服務所在機器 |
| redis | 192.168.121.144 | redis服務所在機器 |

- 整體架構如下圖所示：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20191003192040991.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 以上應用更多詳情請參考[《立即可用的實戰原始碼(springboot+redis+mybatis+restTemplate)》](https://xinchen.blog.csdn.net/article/details/101999606)

- 上述服務的原始碼可以在GitHub下載，可以直接從GitHub下載完整的demo工程原始碼，地址和連結資訊如下表所示：

| 名稱      |   連結 |   備註|
| :-------- | :----| :----|
| 專案主頁| https://github.com/zq2599/blog_demos | 該專案在GitHub上的主頁 |
| git倉庫地址(https)| https://github.com/zq2599/blog_demos.git | 該專案原始碼的倉庫地址，https協議 |
| git倉庫地址(ssh)| git@github.com:zq2599/blog_demos.git | 該專案原始碼的倉庫地址，ssh協議 |

- 這個git專案中有多個資料夾，本章的應用在 **pinpoint185demo** 資料夾下，如下圖紅框所示：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20191003173843718.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
### 配置host
- 為了後續配置方便，將以下內容寫入上述五臺電腦的 **/etc/hosts** 檔案中，這樣所有的配置檔案都可以用hostname來表示了：
```shell
192.168.121.143 mysql
192.168.121.144 redis
192.168.121.146 service-a
192.168.121.147 service-b
192.168.121.148 pinpoint
```
### 版本資訊參考
1. 作業系統：CentOS Linux release 7.7.1908
2. docker：Community 19.03.2
3. docker-compose：1.24.1
4. springboot：2.0.5.RELEASE
5. mysql：5.7.27
6. redis：5.0.6

### 部署pinpoint
- 登入pinpoint主機；
- 登入pinpoint主機；
- 裝好docker和docker-comose，可以參考[《一行命令安裝docker和docker-compose(CentOS7)》](https://xinchen.blog.csdn.net/article/details/101830200)
- 裝好git客戶端： **yum install git -y
- 執行以下命令會先下載材料再按照docker-compose.yml的編排啟動所有容器：
```shell
git clone https://github.com/naver/pinpoint-docker.git; \
git checkout 1.8.5; \
cd pinpoint-docker; \
docker-compose pull && docker-compose up -d
```
- 控制檯提示如下：
```shell
[root@pinpoint ~]# clear
[root@pinpoint ~]# git clone https://github.com/naver/pinpoint-docker.git; \
> cd pinpoint-docker; \
> git checkout 1.8.5; \
> docker-compose pull && docker-compose up -d
正克隆到 'pinpoint-docker'...
remote: Enumerating objects: 34, done.
remote: Counting objects: 100% (34/34), done.
remote: Compressing objects: 100% (33/33), done.
remote: Total 384 (delta 6), reused 13 (delta 1), pack-reused 350
接收物件中: 100% (384/384), 244.12 MiB | 1.72 MiB/s, done.
處理 delta 中: 100% (185/185), done.
Note: checking out '1.8.5'.

You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by performing another checkout.

If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -b with the checkout command again. Example:

git checkout -b new_branch_name

HEAD 目前位於 39b9e1e... [naver/pinpoint#5998] update for release 1.8.5
Pulling jobmanager          ... done
Pulling zoo2                ... done
Pulling taskmanager         ... done
Pulling zoo1                ... done
Pulling zoo3                ... done
Pulling pinpoint-mysql      ... done
Pulling pinpoint-hbase      ... done
Pulling pinpoint-web        ... done
Pulling pinpoint-collector  ... done
Pulling pinpoint-agent      ... done
Pulling pinpoint-quickstart ... done
Creating network "pinpoint-docker_pinpoint" with driver "bridge"
Creating volume "pinpoint-docker_data-volume" with default driver
Creating volume "pinpoint-docker_mysql_data" with default driver
Creating pinpoint-flink-jobmanager ... done
Creating pinpoint-docker_zoo3_1     ... done
Creating pinpoint-docker_zoo1_1    ... done
Creating pinpoint-docker_zoo2_1     ... done
Creating pinpoint-hbase             ... done
Creating pinpoint-mysql             ... done
Creating pinpoint-flink-taskmanager ... done
Creating pinpoint-web               ... done
Creating pinpoint-collector         ... done
Creating pinpoint-agent             ... done
Creating pinpoint-quickstart        ... done

```
- 此處由於要下載大量檔案，並且還要下載docker映象，因此建議您耐心等待
- 啟動完成後，執行命令 **docker ps -f name=pinpoint-web** 檢視web服務的埠，如下圖紅框所示，是宿主機的8079埠：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20191004084329400.png)
- 訪問地址 **http://192.168.121.148:8079**  ，即可進入pinpoint的監控頁面，如下圖，已經自帶了一個demo應用，該應用是在docker-compose.yml中配置的：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20191004084652289.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- pinpoint服務端已經準備好了，接下來我們將SpringBoot應用接入pinpoint，達到監控和呼叫鏈跟蹤的效果
### SpringBoot應用接入pinpoint(service-a)
- 接下來要在SpringBoot應用所在機器上做操作，將應用接入pinpoint；
- 下載pinpoint agent包，地址是：https://github.com/naver/pinpoint/releases ，要下載的檔案如下圖紅框所示：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20191003201332964.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 登入service-a應用所在機器，在 **/root** 目錄下新建資料夾 **pinpoint-agent-1.8.5** ；
- 將剛才下載的 **pinpoint-agent-1.8.5.tar.gz** 檔案放入/root/pinpoint-agent-1.8.5目錄，然後再解壓pinpoint-agent-1.8.5.tar.gz（ **注意，是先放入pinpoint-agent-1.8.5資料夾再解壓** ）；
- 開啟檔案 **/root/pinpoint-agent-1.8.5/pinpoint.config** ，找到profiler.collector.ip、profiler.tomcat.conditional.transform、profiler.applicationservertype這三個配置，修改成以下的值：
```properties
profiler.collector.ip=pinpoint
profiler.tomcat.conditional.transform=false
profiler.applicationservertype=SPRING_BOOT
```
- 重新啟動service-a服務，假設原有的啟動命令是 **java -jar service-a-1.0-SNAPSHOT.jar** ，現在改為：
```shell
java -jar \
-javaagent:/root/pinpoint-agent-1.8.5/pinpoint-bootstrap-1.8.5.jar \
-Dpinpoint.agentId=192.168.121.146 \
-Dpinpoint.applicationName=service-a \
service-a-1.0-SNAPSHOT.jar
```

- 如上所述，一共增加了三個引數：

### SpringBoot應用接入pinpoint(service-b)
- service-b的配置方式和service-a的一樣，注意啟動引數要改成service-b有關的，以下是service-b的啟動命令：
```shell
java -jar \
-javaagent:/root/pinpoint-agent-1.8.5/pinpoint-bootstrap-1.8.5.jar \
-Dpinpoint.agentId=192.168.121.147 \
-Dpinpoint.applicationName=service-b \
service-b-1.0-SNAPSHOT.jar
```
### 製造一些請求，用於觀測資料
- 接下來製造一些請求，讓service-a和service-b執行業務程式碼，我這裡用的是Postman，它提供了自動發起重複請求的功能，如下圖：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20191004104151106.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 接下來開啟Runner Window，如下圖：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20191004104009980.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 按照下圖進行設定，即可向service-a持續發起請求：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20191004104437645.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
### pinpoint的監控功能
- 開啟pinpoint頁面，可以看到service-a、service-b的監控資料已經有了：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20191004105014809.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 用滑鼠對右上角的請求量進行框選，可以檢視請求的詳情：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20191004103538167.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 如下圖，可以詳細的看到每個請求內部的執行情況：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20191004104813407.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 另外還能觀察機器的整體情況：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20191004105207960.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)
- 至此，一個典型的Java分散式系統接入pinpoint1.8.3的實戰就完成了，如果您正在考慮透過pinpoint來監控系統檢視呼叫鏈情況，來希望本文能夠給您一些參考；

### 友情提示
- 在整個實戰過程中，以下小坑請注意跳過：
1. 關閉各個機器的防火牆；
2. 關閉pinpoint機器的swap；

### 歡迎關注ITpub：程式設計師欣宸
> [學習路上，你不孤單，欣宸原創一路相伴...](http://blog.itpub.net/70017844/)

分散式系統快速接入pinpoint1.8.3指南

相關文章