本文将讲述pinpoint的安装，使用及与java logback 日志的集成。
介绍
是什么
- 是一款 APM监控工具(Application Performance Management/应用性能管理)
- 基于java编写
- 用于 大规模分布式系统 的监控，是 分析 大规模分布式系统 的平台
- 基于google Dapper开发，目标就是为n(n>=1)层架构开发新的跟踪平台，为n层架构的系统 提供 处理大量跟踪数据 的 解决方案
- 能够对 基于java的 大规模分布式系统和应用 做调用链的跟踪
- 提供了一个web页面 展示 分布式系统的拓扑图 以及 系统这各个组件之间关系
特点
- 分布式事务追踪，跟踪跨分布式应用的消息
- 自动检测应用拓扑，帮助你搞清楚应用的架构
- 水平扩展，以便支持大规模服务器集群
- 提供代码级别的可见性，以便轻松定位失败点和瓶颈
- 提供字节码增强技术，添加新功能无需修改代码
- 安装探针不需要修改哪怕一行代码及trace server端部署简单，支持hdfs存储
- 具有简单的阀值触发报警功能
- 移植性比较强的，会比较讨人喜欢(相比cat)
- 自定义插件功能(参考https://github.com/naver/pinpoint/wiki/Pinpoint-Plugin-Developer-Guide)
具体请参考：
Pinpoint–基础–01–介绍
网友专栏： https://blog.csdn.net/zhou920786312/category_12110038.html
环境搭建
这里推荐一篇网友的安装步骤，照着步骤基本没什么问题。
性能测试利器 — 全链路监控工具Pinpoint安装教程
其中这个hbase的初始化脚本特别说明下：
https://github.com/pinpoint-apm/pinpoint/tree/v2.3.3/hbase/scripts 在这个目录里面下载。
这里提供一个百度网盘的下载地址(包含了所有的安装包及文件)：
链接：https://pan.baidu.com/s/19wdQ0rdlA4jcC1GujNKRMg?pwd=c4ko
提取码：c4ko
iccboy@DESKTOP-JAG3NND:~/pinpoint$ ll
total 331652
drwxr-xr-x 5 iccboy iccboy 4096 Nov 26 23:38 ./
drwxr-xr-x 6 iccboy iccboy 4096 Nov 27 22:58 ../
-rwxr--r-- 1 iccboy iccboy 170 Nov 26 23:32 collector.sh*
drwxr-xr-x 8 iccboy iccboy 4096 Nov 26 23:14 hbase-1.2.6/
-rwxr-xr-x 1 iccboy iccboy 104659474 Nov 26 22:59 hbase-1.2.6-bin.tar.gz*
-rw-r--r-- 1 iccboy iccboy 15763 Nov 26 23:28 hbase-create.hbase
drwxr-xr-x 2 iccboy iccboy 4096 Nov 27 00:01 logs/
drwxr-xr-x 9 iccboy iccboy 4096 Nov 27 22:37 pinpoint-agent-2.3.3/
-rwxr-xr-x 1 iccboy iccboy 28031866 Nov 26 23:00 pinpoint-agent-2.3.3.tar.gz*
-rw-r--r-- 1 iccboy iccboy 91303343 Nov 26 23:23 pinpoint-collector-boot-2.3.3.jar
-rw-r--r-- 1 iccboy iccboy 115567241 Nov 26 23:23 pinpoint-web-boot-2.3.3.jar
-rwxr--r-- 1 iccboy iccboy 158 Nov 26 23:35 pinpoint-web.sh*
iccboy@DESKTOP-JAG3NND:~/pinpoint$ jps
11585 HMaster
18053 Jps
13609 pinpoint-web-boot-2.3.3.jar
14093 pinpoint-collector-boot-2.3.3.jar
iccboy@DESKTOP-JAG3NND:~/pinpoint$ netstat -ntlp
(Not all processes could be identified, non-owned process info
will not be shown, you would have to be root to see it all.)
Active Internet connections (only servers)
Proto Recv-Q Send-Q Local Address Foreign Address State PID/Program name
tcp 0 0 127.0.0.1:6010 0.0.0.0:* LISTEN 27462/./wslconnect
tcp6 0 0 127.0.1.1:42881 :::* LISTEN 11585/java
tcp6 0 0 127.0.1.1:37571 :::* LISTEN 11585/java
tcp6 0 0 :::46533 :::* LISTEN 11585/java
tcp6 0 0 :::2181 :::* LISTEN 11585/java
tcp6 0 0 :::9991 :::* LISTEN 14093/java
tcp6 0 0 :::9992 :::* LISTEN 14093/java
tcp6 0 0 :::9993 :::* LISTEN 14093/java
tcp6 0 0 :::9994 :::* LISTEN 14093/java
tcp6 0 0 :::16010 :::* LISTEN 11585/java
tcp6 0 0 127.0.1.1:9997 :::* LISTEN 13609/java
tcp6 0 0 :::8080 :::* LISTEN 13609/java
tcp6 0 0 :::8081 :::* LISTEN 14093/java
pinpoint与logback日志MDC集成
- 修改代理模块的
pinpoint-agent-2.3.3/profiles/release/pinpoint.conf配置
将profiler.logback.logging.transactioninfo 改为true，大概在1002行
###########################################################
# logback (guide url : https://github.com/naver/pinpoint/blob/master/doc/per-request_feature_guide.md)
###########################################################
profiler.logback.logging.transactioninfo=true
pinpoint2.x版本之后，其配置方式已调整为由profile控制。
不同环境的配置文件对应在不同的profile目录profiles/*，默认使用profile为release。
系统运行时使用哪个profile，需要使用启动参数指定:
-Dpinpoint.profiler.profiles.active=release #local,test,prod
- 在项目的logback.xml中增加
[%X{PtxId}]变量，则是pinpoint的traceId。
如：
<property name="PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{PtxId}] [%level] %logger{36}-%L %.-2048msg%n"/>
logback通过
%X{PtxId}输出TransactionId，%X{PspanId}输出SpanId
- 启动项目
记得带上参数
-javaagent:D:\sdk\pinpoint\pinpoint-agent-2.3.3\pinpoint-bootstrap-2.3.3.jar -Dpinpoint.agentId=iccboy-member -Dpinpoint.applicationName=iccboy-member
日志打印如下：
2023-11-27 23:56:35.482 [DubboServerHandler-10.10.125.42:20880-thread-10] [iccboy-member^1701100523841^2] [INFO] c.h.h.f.c.e.a.ExceptionLogInterceptor-176 [econfig-0]方法【queryCustomerList(客户列表查询)】调用开始，参数为：{"req":{"data":{"cusCertNo":"C9F4FYW4P","cusType":2,"pageIndex":1,"pageSize":10},"invokeId":"HHYLE377493204464ED3808AAB1C2FF03C29"}}
2023-11-27 23:56:35.597 [DubboServerHandler-10.10.125.42:20880-thread-10] [iccboy-member^1701100523841^2] [INFO] c.h.h.f.c.e.a.ExceptionLogInterceptor-214 [econfig-0]方法【queryCustomerList(客户列表查询)】调用正常，耗时：117ms，返回值为：{"invokeId":"HHYLE377493204464ED3808AAB1C2FF03C29","resultCode":"0000","resultMessage":"成功","data":{"list":[{"cusId":10179140,"cusName":"ADDTEST","cusType":2,"cusCertType":"2","cusCertNo":"C9F4FYW4P","cusSource":"hhyl-permission","cusOpenTime":"2023-11-24 11:38:50"}],"pagination":{"pageIndex":1,"pageSize":10,"totalRecord":1,"totalPage":1},"success":false}}
2023-11-27 23:57:00.540 [DubboServerHandler-10.10.125.42:20880-thread-11] [iccboy-member^1701100523841^3] [INFO] c.h.h.f.c.e.a.ExceptionLogInterceptor-176 [econfig-0]方法【queryCustomersRelation()】调用开始，参数为：{"req":{"data":{"cusIdFrom":"10171684","relationType":"01"},"invokeId":"HHYL120134CBDF904974B0D01855A6DBDEA2"}}
2023-11-27 23:57:00.597 [DubboServerHandler-10.10.125.42:20880-thread-11] [iccboy-member^1701100523841^3] [INFO] c.h.h.f.c.e.a.ExceptionLogInterceptor-214 [econfig-0]方法【queryCustomersRelation()】调用正常，耗时：57ms，返回值为：{"invokeId":"HHYL120134CBDF904974B0D01855A6DBDEA2","resultCode":"0000","resultMessage":"成功","data":[{"id":56068,"cusIdFrom":"10171684","cusIdTo":"10171686","relationType":"01"}]}
2023-11-27 23:57:00.606 [DubboServerHandler-10.10.125.42:20880-thread-12] [iccboy-member^1701100523841^4] [INFO] c.h.h.f.c.e.a.ExceptionLogInterceptor-176 [econfig-0]方法【queryRelationV2(用户客户关系查询接口2.0)】调用开始，参数为：{"req":{"data":{"cusIdList":["10171686"],"relation":"3"},"invokeId":"HHYLB3B6EC3D566B4FE2A0A0AA98F88F27F8"}}
2023-11-27 23:57:00.612 [DubboServerHandler-10.10.125.42:20880-thread-12] [iccboy-member^1701100523841^4] [INFO] c.h.h.m.b.s.impl.UserBizServiceImpl-976 用户客户关系查询2.0入参：QueryRelationV2Req(userId=null, cusIdList=[10171686], relation=3, userIdList=null)
2023-11-27 23:57:00.656 [DubboServerHandler-10.10.125.42:20880-thread-12] [iccboy-member^1701100523841^4] [INFO] c.h.h.f.c.e.a.ExceptionLogInterceptor-214 [econfig-0]方法【queryRelationV2(用户客户关系查询接口2.0)】调用正常，耗时：49ms，返回值为：{"invokeId":"HHYLB3B6EC3D566B4FE2A0A0AA98F88F27F8","resultCode":"0000","resultMessage":"成功","data":[{"userId":"40008483","cusId":"10171686","relation":"3","position":""}]}
上面的iccboy-member^1701100523841^2 就是pinpoint的TransactionId(TxId)
其它
Pinpoint中的SpanId和TxId（TransactionId）在分布式追踪中扮演不同的角色，具有不同的含义和应用场景。
-
SpanId
SpanId是每个Span的唯一标识符。Span代表了一个基本的工作单元，通常对应一个服务或操作。每个Span包含以下信息：- Span ID：唯一标识当前Span。
- Trace ID：标识属于同一个Trace的所有Span。
- 父Span ID：如果当前Span由另一个Span引发，则会记录父Span ID。
- 时间戳、标签和日志：记录了请求的具体信息和执行过程
-
TxId（TransactionId）
TxId（TransactionId）是一系列key的集合，包括TransactionId、SpanId和ParentSpanId。TransactionId代表消息ID，用于标识在一次追踪过程中唯一的消息ID。SpanId和ParentSpanId表示RPC的父子关系，用于构建追踪树结构
具体应用场景和区别
- SpanId主要用于标识单个工作单元，帮助追踪每个服务或操作的详细信息。它帮助开发者理解请求的具体路径和执行细节。
- TxId（TransactionId）则用于标识一次完整的交易或事务，包含了一组相互关联的Span集合。它帮助开发者理解整个事务的流程和跨服务调用的全过程。
通过理解SpanId和TxId的区别，可以更好地进行分布式系统的性能监控和故障排查，确保系统的稳定性和高效运行。
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
