Linux下安装配置Pinpoint监控教程

Pinpoint并非通用Linux系统监控工具，而是专为Java应用设计的分布式链路追踪APM系统，其安装配置的核心难点不在于步骤本身，而在于Agent、Collector与HBase三者之间严丝合缝的双向通信——90%的数据缺失或界面异常都源于HBase初始化失败、Agent Collector地址/端口配置错误、版本不匹配或防火墙阻断，真正决定成败的是逐层验证网络可达性、严格对齐组件版本、确保ZooKeeper就绪及配置参数零误差，而非简单执行脚本。

为什么 hbase shell hbase-create.hbase 执行后没反应或报错

这不是脚本卡住，而是 HBase 服务未就绪或 ZooKeeper 未正常响应。常见现象包括：ERROR: org.apache.hadoop.hbase.ZooKeeperConnectionException 或长时间无输出。

• 先确认 HMaster 进程存活：jps | grep HMaster，没有则 ./start-hbase.sh 后等 10–20 秒再试
• hbase-create.hbase 必须是与当前 pinpoint 版本严格匹配的脚本（如 v2.3.3 就得用 v2.3.3 分支下的脚本），不能混用 1.x 和 3.x 的脚本
• 检查 hbase-site.xml 中 hbase.zookeeper.quorum 是否显式设为 localhost（单机部署必须写死，不能留空或注释掉）
• 执行前手动进 shell 测试连通性：./hbase shell → 输入 status，返回 1 active master, 0 backup masters... 才算真正就绪

pinpoint-agent 加了 JVM 参数但 Web UI 看不到应用节点

Agent 启动成功 ≠ 数据已送达 Collector。最常被忽略的是 Collector 地址配置和防火墙。

• JVM 参数中 -Dpinpoint.collector.ip=192.168.204.233 的 IP 必须是 Collector 主机的**实际监听 IP**（不是 127.0.0.1 或 localhost），且该主机的 9991 端口需开放（v2.3+ 默认用此端口接收 span 数据）
• Agent 日志（logs/pinpoint.log）里出现 Failed to connect to collector 或 Connection refused，优先查 Collector 进程是否运行、端口是否被占用（netstat -tuln | grep 9991）
• Collector 启动日志末尾必须有 Started PinpointWebApplication in ... seconds（boot 版本）或 INFO: Server startup in ... ms（war 版本），否则只是假启动
• Spring Boot 应用加 Agent 时，-javaagent 必须放在 -jar 之前，顺序错误会导致静默失效

pinpoint-web-boot 启动后页面空白或 500 错误

Web 服务本身跑起来了，但无法连接后端存储或 Collector，典型表现是首页加载缓慢后报 Failed to load resource: net::ERR_CONNECTION_REFUSED。

• 检查 pinpoint-web-boot-*.jar 启动时是否传入了正确的配置：必须指定 --spring.profiles.active=production，否则默认走 local 配置，连不上 HBase
• HBase 表必须已存在且可读写：用 ./hbase shell → list 确认看到 AgentInfo、TraceV2 等表；再执行 count 'AgentInfo' 看是否非零（Agent 上报后才会有数据）
• Web 服务依赖的 HBase 客户端版本必须与 HBase 服务端兼容（例如 HBase 1.4.9 要配 hbase-client-1.4.9.jar），boot jar 内嵌的 client 版本不匹配会导致 NoClassDefFoundError
• 浏览器 F12 查 Network，点开 /applications 请求，看响应体是否含 "message":"HBase is not available" —— 这说明 Web 层连 HBase 失败，不是前端问题

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。