Skip to content

Latest commit

 

History

History
132 lines (84 loc) · 5.66 KB

qa.md

File metadata and controls

132 lines (84 loc) · 5.66 KB
Raw

1. 一切问题先检查客户端、swoole_tracker扩展、服务端版本是否一致，是否为最新发布版本； 2. 客户端Agent服务是否启动； 3. 安装扩展完成以后是否重启客户端 Server 服务或 php-fpm 服务；

[success] swoole_tracker扩展的发布版本可能会出现比客户端、服务端高，这个不影响。

  • 查看客户端版本 ps -ef | grep agent

  • 查看 swoole_tracker 扩展版本
;php.ini不要忘了添加
extension=swoole_tracker.so
apm.enable=1
apm.sampling_rate=100

[info] cli模式 php --ri swoole_tracker

[success] fpm模式 phpinfo()

  • 查看服务端版本

[TOC]

1. 找不到对应应用

  • 查看项目是否正确，自动创建的应用会放到默认项目中
  • 检查该应用是否存在合并应用或应用黑名单中
  • 检查客户端swoole_tracker 配置是否正确，参考安装说明->客户端
  • 检查客户端是否给该服务端上报

2. 调用统计/链路追踪无信息

  • 检查对应后台地址(IP或域名)是否正确，防火墙、安全组中端口是否开放

[danger] 请开放出入端口：9903,9904,9907,9981,9990,8995,9666

  • 检查客户端进程是否存在
  • 检查客户端swoole_tracker配置是否正确，参考安装说明->客户端
  • 存在脏数据缓存，等待5-10分钟（之前逻辑为客户端上报的时候会创建文件缓存，每五分钟删除一次，重新安装服务端后客户端文件缓存未删除，出现脏数据缓存，导致短时间内无法上报，现已将缓存写入内存中，重装服务端后重启服务端fpm和重启swoole-admin服务就能正常接收数据，无需等待）
  • 检查采样率apm.sampling_rate
  • 检查配置项apm.agent_host是否正确，为本地agent的ip，可不设置。

3. Service应用无调用统计、链路追踪信息

  • 检查服务名是否存在于服务端
  • 检查代码使用是否正确，参考安装说明->上报监控数据
  • 检查客户端服务名和服务端创建是否一致
  • 同问题2

4. 管理NodeAgent守护进程

目前NodeAgent采用系统的守护进程管理，如果要管理NodeAgent的状态：

  • 对于采用openrc和类似sysvinit的系统（如Debian 7 "Wheezy", Ubuntu 14.04 "Trusty"（默认不安装systemd）, CentOS(RHEL) 6, Fedora 14, Gentoo（可选）, Archlinux（可选）, Alpine Linux）使用命令
/etc/init.d/node-agent start
/etc/init.d/node-agent stop
/etc/init.d/node-agent restart

来启动/停止/重启NodeAgent（非root用户需要sudo）

  • 对于采用systemd的系统（Debian 8 "Jessie"及以后, Ubuntu 15.04 "Vivid"及以后, CentOS(RHEL) 7及以后, Fedora 15及以后, Gentoo（可选）, Archlinux（可选））使用命令
systemctl start node-agent
systemctl stop node-agent
systemctl restart node-agent

来启动/停止/重启NodeAgent（非root用户需要sudo）

5. 增加调试器中的相关代码后报错： Fatal error: Uncaught Exception: plz set apm.enable_memcheck=1 which in php.ini

解决方法：在 php.ini 中添加配置： apm.enable_memcheck=1

[info] 从2.3.3版本以后默认关闭调试功能，需要手动进行配置。或者使用远程调试

6. 重装服务端并清空数据库后，没有上报信息等情况

从2.3.3版本开始有部分信息缓存在php内存中，服务端重装后，数据对应不上导致部分数据获取失败，所以客户端需要重启fpm进程

7. 机器信息无上报信息

  1. 检查网络是否通畅
  2. 查看客户端日志 /opt/swoole/logs/NodeAgent-sysinfoerr.log 是否存在，存在查看内容，是否有上报失败字样
  3. 服务端地址是否正确

8. 进程列表无信息

  1. 查看客户端node-agent进程是否存在
  2. 查看客户端本地是否有pid文件，路径：/var/run/swoole_tracker/下的cli和fpm文件夹中
  3. pid文件对应的进程是否正常

9. 加载扩展后报错undefined symbol: php_pdo_get_exception

扩展需要放在pdo扩展后面加载。使用php --ini | grep "Scan for additional .ini files in:"查看第三方加载目录，在此目录中创建一个swoole_tracker的配置

10. 加载扩展后报错undefined symbol: compiler_globals in Unknown

扩展支持nts非线程安全版本PHP，可使用命令php -v查看

11. 客户端运行报错 sw_get_entrypoint()：ERROR：mkdir error, make sure that start the agent first (Premission denied).

请使用 root 用户启动 Agent服务，没有启动 Agent 服务并且不是使用 root 用户启动时会报这个错误

12. 业务开启进程数较多或动态调整进程数模式，导致客户端agent的worker进程占用cpu过高

解决方法是优化业务的最低进程数；或者合理修改客户端agent的worker进程数，修改配置文件中的system_worker_num

13. 以上的2、3、7、8问题查看后依旧无信息

如果你将服务单独使用Docker（单独的NodeAgent容器）进行部署的，需要检测对应的网络连接是否通畅，即检查是否在同一网段内。

可使用telnet等工具测试上文中的对应端口。

14. Agent列表的某个机器为红色

先查看Agent连接是否正常，如果正常请检查该机器的系统时间是否正常。

15. 报错：PHP Startup: apm.enable and apm.enable_malloc_hook can't be turned on together, reset apm.enable=0

开启了apm.enable_malloc_hook =1之后其他的功能均不可用，只能进行内存泄漏检测。