本文主要是介绍 Pinpoint 环境的部署,小伙伴儿们也可以参考 Pinpoint 《官网》的《快速入门》手册,最新版本v2.3.3
组件可到官方《GitHub仓库》进行下载,使用到的文件列表:
- hbase-1.7.1-bin.tar.gz
- hbase-create.hbase
- jdk-8u251-linux-x64.tar.gz(JDK8)
- pinpoint-agent-2.3.3.tar.gz
- pinpoint-collector-boot-2.3.3.jar
- pinpoint-web-boot-2.3.3.jar
链接:https://pan.baidu.com/s/1U5AWyZ6bk2pPUmkUyLVAOA 提取码:7rke
1.介绍
来自官网的 Introduction:
简单翻译一下:
Pinpoint 是一个APM(应用程序性能管理)工具,用于用Java / PHP编写的大规模分布式系统。受Dapper 的启发,Pinpoint 提供了一个解决方案,帮助分析系统的整体结构,以及通过跟踪分布式应用程序之间的事务来分析系统中的组件是如何相互关联的。
- 实时监控您的应用程序
- 获得每个事务的代码级可见性
- 安装APM代理时不需要修改一行代码
- 对性能的影响最小(大约增加了3%的资源使用)
2.安装
2.1 JDK
主要是 Pinpoint 的 jar
文件运行需要 Java 环境【坑1
】:
[root@aliyun ~]# java -version openjdk version "11" 2018-09-25 OpenJDK Runtime Environment 18.9 (build 11+28) OpenJDK 64-Bit Server VM 18.9 (build 11+28, mixed mode)
2.2 HBase
- 小伙伴们直接只安装云盘里的HBase1.7.1版本就好,因为
HBaseVersion{supportedVersion=[0.9, 1.]}
不支持2.X的版本。
Pinpoint 的数据需要存储到 HBase 数据库,这里不再赘述安装过程,小伙伴儿们可参考 《HBase 单机版 standalone 模式详细安装+配置+测试》 进行部署。下载官网提供的《HBase 数据库相关配置初始化文件》 我安装的是 hbase-2.4.5
版本【坑2
】。
# 执行 Pinpoint 提供的 Hbase 初始化语句 [root@aliyun pinpoint]# hbase shell hbase-create.hbase
问题 1️⃣ 运行 hbase shell hbase-create.hbase
卡住不动,原因未知,故使用 hbase shell
进入命令行界面执行了 hbase-create.hbase
内的 SQL 语句。验证:
也可以登录 HBase 的 Web 端查看:
2.3 Pinpoint Collector
# 前台启动(可以直接查看日志信息适合调试时) java -jar -Dpinpoint.zookeeper.address=aliyun pinpoint-collector-boot-2.3.3.jar # 后台启动 nohup java -jar -Dpinpoint.zookeeper.address=aliyun pinpoint-collector-boot-2.3.3.jar > pinpointCollector.log 2>&1 &
问题 2️⃣ 运行报错:
exception is com.navercorp.pinpoint.common.hbase.HBaseAccessException: HBase version compatibility violation HBaseClient: HBaseVersion{supportedVersion=[0.9, 1.]} V1, HBaseServer:2.4.5
HBase 版本冲突仅支持0.9, 1.
的版本。只好重新安装低版本的 HBase-1.7.1
(JDK也重新安装为1.8
) 😢 再次初始化好数据库后,执行:
java -jar -Dpinpoint.zookeeper.address=aliyun pinpoint-collector-boot-2.3.3.jar
特别说明:数据库的初始化脚本执行 hbase shell hbase-create.hbase
也没有问题了。
2.4 Pinpoint Web
# 启动 java -jar -Dpinpoint.zookeeper.address=aliyun pinpoint-web-boot-2.3.3.jar # 后台 nohup java -jar -Dpinpoint.zookeeper.address=aliyun pinpoint-web-boot-2.3.3.jar > pinpointWeb.log 2>&1 &
浏览器输入ip:8080
即可访问 Web 端,官网让访问的端口号为8082
【坑3
】:
3.总结
Pinpoint Collector+Web 安装配置过程并不复杂,出现问题的地方是各组件间的版本不兼容,官方网站也没给出版本兼容列表,安装的时候只能是自行尝试了,还有就是官网给出的说明是2.2.1
版本的与最新版本有所不同,小伙伴儿们要注意啊 😃
4.更新列表
- 20230228 添加 Pintpoint 后台启动脚本。
- 20230228 添加 HBase 安装的说明。