Pinpoint 不必过多的介绍,想看介绍的网上去搜,他的能力相当不错,下面就记录一下我搭建基于Spring Cloud 2.0、Pinpoint 1.8.1的搭建过程
一、HBase 安装
首先去Pinpoint的官网去看下你要搭建的版本与之对应的HBase、JDK。Pinpoint 官网(https://github.com/naver/pinpoint),如图:
然后去HBase的官网(http://hbase.apache.org/downloads.html)下在HBase 1.2.9版本,如图:
下面是在centos上的命令操作步骤:
//将pinpoint安装在/opt/home目录下(以下操作如果没有特殊指明,均在该目录下发生)
cd /opt/home
//创建文件夹
mkdir pinpoint
//进入目录
cd pinpoint
//上传文件命令,上传刚刚下载的hbase1.2.9的包(如果没有相关的自行安装lrzsz)
rz
//解压hbase
tar -zxvf hbase-1.2.9-bin.tar.gz
//创建hbase数据库文件夹(目录名称和位置均可以自定义)
mkdir hbasedb
//进入hbase目录
cd hbase-1.2.9
//进入hbase配置文件目录
cd conf
//编辑配置文件(这里vim和vi均可以)
vim hbase-site.xml
hbase-site.xml配置文件中有很多可配置项,如果没有特别需求,我们这里只需要指定数据库存放路径就可以了:
<configuration>
<property>
<name>hbase.rootdir</name>
<value>file:///opt/home/pinpoint/hbasedb</value>
</property>
</configuration>
注意:这里的 /opt/home/pinpoint/hbasedb 即是我们刚刚命令创建的数据库存放目录
相关的hbase配置就已经完了,特别简单吧!现在我们就可以启动hbase,但是在启动前,我们先要检查环境变量以及配置下hbase的环境变量:
//查看java的版本信息
java -version
打印结果:
注意:如果没有打印结果需要去安装JDK,如何安装JDK这里就不做介绍了
//查看JDK安装路径
java -verbose
打印结果:
//查看环境变量JAVA_HOME
echo $JAVA_HOME
打印结果:
注意:打印结果的最后两行,就是JDK安装路径。记住这个路径,接下来我们验证下JDK环境变量里的路径是否和安装路径一致,如果不一致,则需要配置环境变量
//编辑环境变量
vi /etc/profile
JAVA_HOME=/usr/java/jdk1.8.0_162
JRE_HOME=/usr/java/jdk1.8.0_162/jre
HBASE_HOME=/opt/home/pinpoint/hbase-1.2.9
PATH=$PATH:$JRE_HOME/bin:$HBASE_HOME/bin
CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$JRE_HOME/lib
export JAVA_HOME JRE_HOME PATH CLASSPATH HBASE_HOME
把这段配置信息方法profile最前面(注:如果JAVA_HOME与JRE_HOME都有就不必再添加,主要是配置 HBASE_HOME)
HBASE_HOME=/opt/home/pinpoint/hbase-1.2.9
PATH=$PATH:$JRE_HOME/bin:$HBASE_HOME/bin
//使环境变量配置信息立即生效
source /etc/profile
以上步骤和验证都没问题了,那我们来启动hbase:
//进入HBase执行目录
cd bin
//启动
sh start-hbase.sh
//停用
sh stop-hbase.sh
至此 HBase 安装完成,是不是很简单很easy
二、Pinpoint 部署
去Pinpoint官网(https://github.com/naver/pinpoint/releases)查看releases版本,咱们以1.8.1版本为例:
将agent、collector、web都下载下来上传到 centos 的/opt/home/pinpoint目录下(注意:将第二张图的,也就是源码,在hbase目录下的script目录下载下来,一并上传的该目录,后续做数据库表初始化用)
部署 collector、web
- 准备两个tomcat,部署到centos上(tomcat的部署这里不再叙述)。
- 清空tomcat中webapps目录下的项目,将 pinpoint-collector-1.8.1.war 、 pinpoint-web-1.8.1.war 分别放在两个tomcat里,注意一定要给war包改名为ROOT.war。
- 然后分别启动tomcat即可,至此collector和web部署完成。
注意:如果没有特殊需求,不要更改collector、web里的任何配置
部署 agent
//进入目录
cd /opt/home/pinpoint
//创建agent目录
mkdir agent
//解压agent到agent目录
tar -zxvf pinpoint-agent-1.8.1.tar.gz -C agent/
//进入agent
cd agent
agent目录下有这些文件,如图:
我们需要配置的是pinpoint.config找到RxJava、Hystrix、RestTemplate把他们都设置为true,如图:
注意:只有RxJava、Hystrix、RestTemplate都为true的时候,pinpoint对于微服务之间的链路监控才能收集到
接下来去具体的spring boot服务上去加上 agent探针配置,如图:
注意:上图只是我的事例配置,具体的按各自的启动文件情况进行配置。其核心思想就是在jar启动的时候加上三个参数:agent jar的路径、agent的ID和名称。这里的agent的ID和名称注意不要和其他的重复。
然后启动配置好的相应的微服务jar,访问http://127.0.0.1:8088(这里的地址是之前咱们部署的web的访问地址),如图:
至此,Pinpoint已经部署完成啦!赶紧去体验体验吧!