Pinpoint 技术架构及部署

目录

一、背景

二、简介

三、Pinpoint Collector 收集端

四、Pinpoint Web

五、Pinpoint Agent

六、监控效果图

七、其他


一、背景

随着项目微服务的进行,微服务数量逐渐增加,服务间的调用也越来越复杂,我们急切需要一个APM工具帮我们监控各个服务的性能及对服务间的调用进行跟踪,而通过调研多个开源APM工具后,最终我们选择了pintpoint。

1.1、github地址是:https://github.com/naver/pinpoint

1.2、选择它有4个方面原因:

  1. pinpoint是基于java开发的,利于项目后期对源代码的修改
  2. 集成pinpoint不需要修改一行代码
  3. pinpoint有非常直观的UI,符合项目的当前需求
  4. pinpoint的社区还是挺活跃,一般提问题第二天就有项目的committer回复

二、简介

Pinpoint是一个开源的 APM (Application Performance Management/应用性能管理)工具,用于基于java的大规模分布式系统。在使用上力图简单高效,通过在启动时安装agent,不需要修改哪怕一行代码,最小化性能损失(3%).

2.1、架构图

Pinpoint 技术架构及部署_第1张图片

2.2、三个主要组件

  •   Collector, 收集应用中agent发送的数据并存储到Hbase中
  •   Agent,  是和应用一起启动的和应用共享JVM,定时发送数据给Collector
  •   Web UI, 从hbase中读取数据并展示给用户,之后会有demo展示其功能

2.3、依赖环境

  •   JDK:1.8
  •   Pinpoint:1.7.3
  •   Tomcat:7.0.59

三、Pinpoint Collector 收集端

部署在独立的Tomcat容器中,如 tomcat-pinpoint-collector

3.1、安装 pinpoint-collector

上传pinpoint-collector-1.7.3.war到 tomcat/webapps目录
解压:
unzip pinpoint-collector-1.7.3.war -d pinpoint-collector

3.2、配置 pinpoint-collector

Pinpoint Collector 有 2 个配置文件: pinpoint-collector.properties 和 hbase.properties
这些配置文件在war文件下的 WEB-INF/classes 目录
3.2.1、pinpoint-collector.properties: 包含colletor的配置,在配置pinpoint agent时需要与之对应:

  •     collector.receiver.base.port(agent中是 profiler.collector.tcp.port - 默认: 9994)
  •     collector.receiver.stat.udp.port(agent中是 profiler.collector.stat.port - 默认: 9995)
  •     collector.receiver.span.udp.port(agent中是 profiler.collector.span.port - 默认: 9996)
注意:pinpoint collector 1.5.x版本 和 较新的 1.7.x版本的 pinpoint-collector.properties配置文
件有差异
具体参考:
https://github.com/naver/pinpoint/blob/1.7.3/collector/src/main/resources/pinpoint-collecto
r.properties
https://github.com/naver/pinpoint/blob/1.5.2/collector/src/main/resources/pinpoint-collecto
r.properties

 

  • cluster.zookeeper.address(默认: localhost,修改为hbase相关的zookeeper的IP地址)

3.3.2、hbase.properties : 包含连接到HBase的配置

  • hbase.client.host (默认: localhost,修改为hbase相关的zookeeper的IP地址)
  • hbase.client.port (默认: 2181)

查看pinpoint-collector.properties的其它配置,请看https://github.com/naver/pinpoint/blob/1.7.3/web/src/main/resources/pinpoint-web.properties
查看hbase.properties的其它配置,请看https://github.com/naver/pinpoint/blob/1.7.3/web/src/main/resources/hbase.properties

四、Pinpoint Web

部署在独立的Tomcat容器中,如 tomcat-pinpoint-web
4.1、安装 pinpoint-web

上传pinpoint-web-1.7.3.war到 tomcat/webapps目录
pinpoint-web应用需要部署为tomcat的ROOT应用
cd tomcat/webapps
rm -fr ROOT
unzip pinpoint-web-1.7.3.war -d ROOT

4.2、配置 pinpoint-web

和collector类似,Pinpoint web有和安装相关的配置文件:pinpoint-web.properties 和 hbase.properties
这些文件在 WEB-INF/classes 目录下

  • pinpoint-web.properties

        cluster.zookeeper.address(默认: localhost,修改为hbase相关的zookeeper的IP地址)

  • hbase.properties : 包含连接到HBase的配置

       hbase.client.host (默认: localhost,修改为hbase相关的zookeeper的IP地址)
       hbase.client.port (默认: 2181)
查看pinpoint-web.properties的其它配置,请看https://github.com/naver/pinpoint/blob/1.7.3/web/src/main/resources/pinpoint-web.properties
查看hbase.properties的其它配置,请看https://github.com/naver/pinpoint/blob/1.7.3/web/src/main/resources/hbase.properties

五、Pinpoint Agent

5.1、安装 pinpoint-agent

上传pinpoint-agent-1.7.3.tar.gz到安装目录,如 /home/jyapp
解压:
mkdir pinpoint-agent
tar zxvf pinpoint-agent-1.7.3.tar.gz -C pinpoint-agent
pinpoint-agent 目录层次如下:
|-- boot
| |-- pinpoint-bootstrap-core-$VERSION.jar
|-- lib
| |-- pinpoint-profiler-$VERSION.jar
| |-- pinpoint-profiler-optional-$VERSION.jar
| |-- pinpoint-rpc-$VERSION.jar
| |-- pinpoint-thrift-$VERSION.jar
| |-- ...
|-- pinpoint-bootstrap-$VERSION.jar
|-- pinpoint.config(Agent配置文件)

Pinpoint Agent 作为一个java agent需要附加到采样的应用(如 Tomcat)

为了让agent生效,在运行应用时需要设置 -javaagent JVM 参数为 $AGENT_PATH/pinpointbootstrap-$
VERSION.jar

-javaagent:$AGENT_PATH/pinpoint-bootstrap-$1 VERSION.jar

另外,Pinpoint Agent 需要两个命令行参数来在分布式系统中标记自身:

  • -Dpinpoint.agentId - 唯一标记agent运行所在的应用(如,loan-33)
  • -Dpinpoint.applicationName - 将许多的同样的应用实例分组为单一服务(如,loan)

注意:pinpoint.agentId 必须全局唯一来标识应用实例, 而所有共用相同 pinpoint.applicationName 的应用被当
成单个服务的多个实例

5.2、配置 pinpoint-agent

在pinpoint.config 中有很多Pinpoint Agent的配置选项 ,而最重要的必须检查的配置选项是collector ip
address 和 TCP/UDP 端口,Agent需要这些值来创建到collector的连接并正确工作
在 pinpoint.config 中相应的设置这些值:

  • profiler.collector.ip (pinpoint collector ip,默认: 127.0.0.1)
  • profiler.collector.tcp.port (collector中是 collector.receiver.base.port - 默认: 9994)
  • profiler.collector.stat.port (collector中是 collector.receiver.stat.udp.port - 默认: 9995)
  • profiler.collector.span.port (collector中是 collector.receiver.span.udp.port - 默认: 9996)

查看pinponit.config的其它配置,请看https://github.com/naver/pinpoint/blob/1.7.3/agent/src/main/resources-release/pinpoint.config

5.3、Tomcat集成示例

在tomcat 启动脚本(catalina.sh)中添加 -javaagent, -Dpinpoint.agentId, -Dpinpoint.applicationName

JAVA_OPTS="$JAVA_OPTS -javaagent:/home/jyapp/pinpoint-agent/pinpoint-bootstrap-1.7.3.jar"
JAVA_OPTS="$JAVA_OPTS -Dpinpoint.agentId=$AGENT_ID"
JAVA_OPTS="$JAVA_OPTS -Dpinpoint.applicationName=$APPLICATION_NAME"
注意:
$AGENT_ID - 需改为应用的唯一标记,如 loan-33,代表loan 33服务器
$APPLICATION_NAME - 需改为应用名,如 loan,代表贷款应用

启动tomcat来开始web应用的采样
SpringBoot微服务同理,在启动命令上添加 -javaagent, -Dpinpoint.agentId, -Dpinpoint.applicationName 即可

六、监控效果图

Pinpoint 技术架构及部署_第2张图片

七、其他

将web请求路由到agent

从 1.5.0 版本开始, Pinpoint 可以通过collector从web直接发送请求到agent(反之亦然)。 为此需要使用
Zookeeper 来协调agent和collector之间和collectors 和 web 之间的通讯通道.。在此之上,实时通讯(例如活动
线程数量监控)才变的可能
通常使用HBase后端提供的Zookeeper实例,这样就不需要额外的Zookeeper配置。相关的配置选项在这里:

7.1、pinpoint-web.properties

cluster.enable=true
cluster.web.tcp.port=9997
cluster.zookeeper.address=localhost
cluster.zookeeper.sessiontimeout=30000
cluster.zookeeper.retry.interval=60000
cluster.connect.address=

7.2、pinpoint-collector.properties

cluster.enable=true
cluster.zookeeper.address=localhost
cluster.zookeeper.sessiontimeout=30000
cluster.listen.ip=
cluster.listen.port=

 

你可能感兴趣的:(Pinpoint)