平台的架构图如下：

我们同时可以登录Hbase Web管理控制台来验证相关数据 http://192.168.56.12:16010/master-status 这个地址是指你自己安装的地址

安装 Pinpoint-collector

安装pp-collector的jdk条件：

系统已安装JDK 6、JDK 7+ 、Maven 3.2.x+ ;并设置环境变量：JAVA_6_HOME和JAVA_7_HOME.下图为JDK版本与Pinpoint版本关系：

Pinpoint Agent Collector  Web
1.0.x   6+   6+         6+
1.1.x   6+   7+         7+
1.5.x   6+   7+         7+

pp-collector的安装与配置

#创建/data/service/目录
$ mkdir -p /data/service/
#解压你的tomcat致 /data/service 这个路径你可以解压到自己创建的目录
$ tar xf /root/pp/apache-tomcat-8.0.35.tar.gz -C /data/service/
$ cd /data/service/
#将apache-tomcat-8.0.35移动到pinpoint-collector文件中
$ mv apache-tomcat-8.0.35/ pinpoint-collector
#更改pinpoint-collector tomcat的server.xml
$ vim /data/service/pinpoint-collector/conf/server.xml       # 因为我们的pp-collector和pp-web部署在同台设备，所以请确认tomcat启动端口不会冲突
#如果在同一个服务器启用多个tomcat 请更改下面server的port端口 当然你也可以用别的方式
<Server port="8005" shutdown="SHUTDOWN">     
#设置pinpoint-collector tomcat的端口
<Connector port="8085" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
<!-- <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /> -->     #  注释该行
#pinpoint-collector-1.5.2.war部署到webapps 并命名为ROOT
$ rm -rf /data/service/pinpoint-collector/webapps/*
$ unzip pinpoint-collector-1.5.2.war -d /data/service/pinpoint-collector/webapps/ROOT/
$ cd  /data/service/pinpoint-collector/webapps/ROOT/WEB-INF/classes
$ ls -al
-rw-rw-r-- 1 root root 15835 Apr  7 14:43 applicationContext-collector.xml
-rw-rw-r-- 1 root root  7485 Apr  7 14:43 applicationContext-hbase.xml
-rw-rw-r-- 1 root root   757 Apr  7 14:43 hbase.properties     
-rw-rw-r-- 1 root root  1845 Apr  7 14:43 log4j.xml
-rw-rw-r-- 1 root root  1360 Apr  7 14:43 pinpoint-collector.properties     # 主要针对pp-agent的配置，同时支持tcp和udp协议数据传输
-rw-rw-r-- 1 root root  3292 Apr  7 14:43 servlet-context.xml
...

这里大概说一下: applicationContext-collector.xml, applicationContext-hbase.xml 这俩个配置文件时collector与agent和Hbase之间通信时需要设定的一些参数，在后续调优的时候需要用到，hbase.properties 主要是设定后端存储的连接配置，log4j.xml那就是log相关了。

$ vim hbase.properties
hbase.client.host=192.168.56.12        # 这里我们只修改这一项配置就好，能够让collector将汇报上来的数据存储到Hbase 如果你是在同一台机器上安装的hbase就没必要改了 因为默认就是localhost
hbase.client.port=2181

这里tomcat我们就用8085端口了，实际的生产环境可能需要根据实际情况修改tomcat侦听端口。OK，到此，pp-collector我们就基本上配置完成了。接下来我们开始配置pp-web，它与collector很类似。

安装 Pinpoint-web

2.2.3 pp-web的配置

$ cd /data/service/
$ tar xf /root/pp/apache-tomcat-8.0.35.tar.gz -C /data/service/
$ mv apache-tomcat-8.0.35 pinpoint-web
#更改pinpoint-collector tomcat的server.xml
$ vim /data/service/pinpoint-web/conf/server.xml       # 因为我们的pp-collector和pp-web部署在同台设备，所以请确认tomcat启动端口不会冲突
#如果在同一个服务器启用多个tomcat 请更改下面server的port端口 当然你也可以用别的方式
<Server port="8006" shutdown="SHUTDOWN">     
#设置pinpoint-collector tomcat的端口
<Connector port="8086" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
<!-- <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /> -->     #  注释该行
#pinpoint-collector-1.5.2.war部署到webapps 并命名为ROOT
$ rm -rf /data/service/pinpoint-web/webapps/*
$ unzip pinpoint-web-1.5.2.war -d /data/service/pinpoint-web/webapps/ROOT/
$ cd  /data/service/pinpoint-web/webapps/ROOT/WEB-INF/classes   
$ ls -al
total 88
-rw-rw-r-- 1 root root 2164 Apr  7 14:43 applicationContext-cache.xml
-rw-rw-r-- 1 root root 3649 Apr  7 14:43 applicationContext-dao-config.xml
-rw-rw-r-- 1 root root 1490 Apr  7 14:43 applicationContext-datasource.xml
-rw-rw-r-- 1 root root 6680 Apr  7 14:43 applicationContext-hbase.xml
-rw-rw-r-- 1 root root 1610 Apr  7 14:43 applicationContext-websocket.xml
-rw-rw-r-- 1 root root 6576 Apr  7 14:43 applicationContext-web.xml
-rw-rw-r-- 1 root root  106 Apr  7 14:43 batch.properties
-rw-rw-r-- 1 root root  682 Apr  7 14:43 ehcache.xml
-rw-rw-r-- 1 root root 1005 Jul 14 21:45 hbase.properties
-rw-rw-r-- 1 root root  153 Apr  7 14:43 jdbc.properties
-rw-rw-r-- 1 root root 3338 Apr  7 14:43 log4j.xml
-rw-rw-r-- 1 root root 1420 Apr  7 14:43 mybatis-config.xml
-rw-rw-r-- 1 root root  630 Apr  7 14:43 pinpoint-web.properties
-rw-rw-r-- 1 root root  141 Apr  7 14:43 project.properties
-rw-rw-r-- 1 root root 3872 Apr  7 14:43 servlet-context.xml
drwxrwxr-x 2 root root 4096 Jul 14 21:46 sql 

$ vim hbase.properties
hbase.client.host=192.168.56.12    # 设置Hbase数据源
hbase.client.port=2181
...
 

配置解说

//pinpoint-web.properties --web参数配置如下：
cluster.enable=true
cluster.web.tcp.port=9997
cluster.zookeeper.address=localhost
cluster.zookeeper.sessiontimeout=30000
cluster.zookeeper.retry.interval=60000
cluster.connect.address=


//hbase.properties        -- 配置连接hbase参数如下:
hbase.client.host (default: localhost)
hbase.client.port (default: 2181)

//hbase数据库和mysql数据库选择一项配置，如果配置了hbase数据库，此项不用配置，仅当选用mysql数据库时配置
//jdbc.properties         -- 配置连接mysql数据库如下:
jdbc.driverClassName=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:13306/pinpoint?characterEncoding=UTF-8
jdbc.username=admin
jdbc.password=admin

//hbase数据库和mysql数据库选择一项配置，如果配置了hbase数据库，此项不用配置，仅当选用mysql数据库时配置
//创建pinpoint数据库并创建表 mysql命令行下执行命令如下：
create DATABASE if not exists pinpoint DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
use pinpoint
\. sql/CreateTableStatement-mysql.sql
\. sql/SpringBatchJobReositorySchema-mysql.sql
commit;

注：zookeeper和pp-collector、pp-web不在同一台服务器上时的配置

从pinpoint1.5.0开始，pp-web到pp-agent的request请求直接通过pp-collector来统筹管理，包括一些real-time级别的信息监测，而zookeeper在其中间协调三者之间的通信沟通。如果zookeeper部署在独立的一台设备，这里我就需要修改一下pp-colletor & pp-web的配置文件pinpoint-collector.properties，pinpoint-web.properties，不然会导致俩个模块启动失败。详细描述参见官方文档

$ rpm -ivh /root/pp/zookeeper-3.4.6-10.el6.x86_64.rpm
$ /etc/init.d/zookeeper start     # 保证zookeeper的2181端口起来就可以了

修改pinpoint-collector.properties
vi /data/service/pinpoint-collector/webapps/ROOT/WEB-INF/classes/pinpoint-collector.properties


# enable cluster in socket manager.
cluster.enable=true
cluster.zookeeper.address=localhost            #如果zk单独配置， 需要修改此项
cluster.zookeeper.sessiontimeout=30000
cluster.listen.ip=
cluster.listen.port=

 修改pinpoint-web.properties
vi /data/service/pinpoint-web/webapps/ROOT/WEB-INF/classes/pinpoint-web.properties  

# -------------------------------------------------------------------------------------------------
# The cluster related options are used to establish connections between the agent, collector, and web in order to send/receive data between them in real time.
# You may enable additional features using this option (Ex : RealTime Active Thread Chart).
# -------------------------------------------------------------------------------------------------
# Usage : Set the following options for collector/web components that reside in the same cluster in order to enable this feature.
# 1. cluster.enable (pinpoint-web.properties, pinpoint-collector.properties) - "true" to enable
# 2. cluster.zookeeper.address (pinpoint-web.properties, pinpoint-collector.properties) - address of the ZooKeeper instance that will be used to manage the cluster
# 3. cluster.web.tcp.port (pinpoint-web.properties) - any available port number (used to establish connection between web and collector)
# -------------------------------------------------------------------------------------------------
# Please be aware of the following:
#1. If the network between web, collector, and the agents are not stable, it is advisable not to use this feature.
#2. We recommend using the cluster.web.tcp.port option. However, in cases where the collector is unable to establish connection to the web, you may reverse this and make the web establish connection to the collector.
#   In this case, you must set cluster.connect.address (pinpoint-web.properties); and cluster.listen.ip, cluster.listen.port (pinpoint-collector.properties) accordingly.
cluster.enable=true
cluster.web.tcp.port=9997
cluster.zookeeper.address=localhost
cluster.zookeeper.sessiontimeout=30000
cluster.zookeeper.retry.interval=60000
cluster.connect.address=

注意：以上配置文件需要修改 是因为zookeeper单独部署

到这里，我们就可以启动pp-colletor和pp-web了

启动的方式有很多 我是用比较笨的方式进去pinpoint-colletor 和pinpoint-web 的bin目录下执行start.sh启动的

安装 Pinpoint-agent

我们这个时候可以部署一个pp-agent试玩一下了，其实也就是很多APM厂商传说中的探针。这里我的探针是部署在自己的应用下面的，就只贴一下跑在tomcat下的探针配置信息了。顺带说明一下部署上的注意点。

以下是pp目前支持埋点的java模块：

JDK 6+
Tomcat 6/7/8, Jetty 8/9
Spring, Spring Boot
Apache HTTP Client 3.x/4.x, JDK HttpConnector, GoogleHttpClient, OkHttpClient, NingAsyncHttpClient
Thrift Client, Thrift Service, DUBBO PROVIDER, DUBBO CONSUMER
MySQL, Oracle, MSSQL, CUBRID, DBCP, POSTGRESQL, MARIA
Arcus, Memcached, Redis, CASSANDRA
iBATIS, MyBatis
gson, Jackson, Json Lib
log4j, Logback

部署pp-agent (探针)

我们约定tomcat容器安装位置 /data/projects/service/app_demo，这里我们就将pp-agent解压至 /data/projects/service/下。

$ tar xf /root/pp/pinpoint-agent-1.5.2.tar.gz -C /data/projects/service/
$ cd /data/projects/service/pinpoint-agent-1.5.2/
$ vim pinpoint.config
profiler.collector.ip=192.168.56.11  #这里说明一下： 我们只要指定pp-colletor的地址就可以了，至于端口如果之前pp-colletor没有变更这里也不需要修改。如果你的生产环境特殊，pinpoint支持还是很丰富的，同时支持tcp和udp协议传输。 默认是localhost 

此刻，我们开始往我们的应用里部署探针。

$ vim /data/projects/service/app_demo/bin/catalina.sh
AGENT_VERSION="1.5.1"
AGENT_ID="pp201606011442"
APPLICATION_NAME="app-192-168-56-13"
AGENT_PATH="/data/projects/service/pinpoint-agent-1.5.1"
CATALINA_OPTS="$CATALINA_OPTS -javaagent:$AGENT_PATH/pinpoint-bootstrap-${AGENT_VERSION}.jar"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.agentId=$AGENT_ID"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.applicationName=$APPLICATION_NAME"

这里说明一下：

此外参考官方agent文档说明

重启被采集端的应用，使探针生效。

Pinpoint安装完成

打开浏览器，访问如下pp-web的页面验证我们的探针部署是否成功。其中，第二个链接是pp的APM主页面可以看到探针汇报上来的信息了。

http://192.168.56.11:8086/stat.html      # pp-agent 信息统计页面，即探针部署情况的统计信息 
http://192.168.56.11:8086/#/main       # pp APM信息主页面

Pinpoint源码下载

制作自己的Pinpoint定制版war包 编译环境要求

maven:3.2+
jdk-6/7/8

解压master.zip,然后执行命令: maven命令

mvn install -Dmaven.test.skip=true

原因是可能是要给服务所在的服务器进行host配置。比如：

agent服务器的hostname叫agent01，那就要在/etc/hosts里声明：agent01 127.0.0.1

其它服务同理，都要做这个配置才行。

----------------------2017年12月6日10:42:09-----------------------

问题：今天pinpoint接收不到数据，pp-web疯狂报错zookeeper（用的hbase自带的），发现hbase挂掉了，

使用命令：

./start-hbase.sh

报错信息：

OpenJDK 64-Bit Server VM warning: ignoring option PermSize=128m; support was removed in 8.0
OpenJDK 64-Bit Server VM warning: ignoring option MaxPermSize=128m; support was removed in 8.0

解决办法：

cd hbase/conf

vim hbase-env.sh

注释掉以下：

# Configure PermSize. Only needed in JDK7. You can safely remove it for JDK8+
export HBASE_MASTER_OPTS="$HBASE_MASTER_OPTS -XX:PermSize=128m -XX:MaxPermSize=128m"

export HBASE_REGIONSERVER_OPTS="$HBASE_REGIONSERVER_OPTS -XX:PermSize=128m -XX:MaxPermSize=128m"