基调听云探针说明

Size: px

Start display at page:

Download "基调听云探针说明"

鳜溥朱
7 years ago
Views:

1 PHP 探针 1 简介运行环境探针架构常见问题 2 安装 2.1 安装包 RPM 安装包 (RHEL,CentOS,SUSE) DEB 安装包 (Debian,Ubuntu) BIN 安装包 ( 其他 linux 发行版 ) 2.2 安装脚本 2.3 守护进程启动方式 2.4 卸载基调网络听云 PHP 探针说明 2.5 快速安装 2.6 更新 3 配置启用 / 禁用性能信息采集授权序号应用名日志管理守护进程自动加载选项审计模式性能数据发送控制数据发送连接选项 4 维护日志维护 5 故障排查 5.1 排除安装故障 5.2 检查守护进程 5.3 检查 php 扩展模块 5.4 查看日志 5.5 手动安装 PHP 扩展版权

2 PHP 探针运行环境 1 确认您的系统满足兼容性要求 2 如果您还没有听云 server 帐户, 请注册听云 server 帐户 3 从听云 server 探针安装页面复制您的授权序号 4 安装 PHP 探针 5 配置 PHP 探针的授权序号 6 重启 PHP 宿主程序 (Apache 或者 PHP-FPM) 7 通过管理页面察看数据, 有问题请参考安装和排除故障章节兼容性和要求安装 PHP 探针之前, 请确保您的系统满足如下这些条件要求 Linux (x86 and x86_64): 操作系统 RedHat Enterprise Linux (RHEL) 5.0 或更高版本 CentOS 5.0 或更高版本 Suse Linux 10.0 或更高版本 Debian 5.0 ("lenny") 或更高版本 Ubuntu 9.10 ("Karmic Koala") 或更高版本任何其他内核版本高于 ,GLIBC 版本高于 2.5 并且提供本地 Posix 线程库支持的 linux 发行版 PHP Web 服务器 Apache 2.2 以上 (apache module 方式 ) Nginx + PHP-FPM (fastcgi 的方式 ) 或者任何其它支持 fastcgi 的 PHP 服务器

3 PHP 探针架构探针的文件组成 : 探针安装后, 对 Linux 系统的文件更改如下 : 守护进程 /usr/bin/networkbench PHP 扩展 /usr/lib/networkbench/ PHP 扩展配置文件 {PHP 附加配置文件路径 }/networkbench.ini 或 {PHP 主配置文件 } 探针运行日志 /var/log/networkbench/ 探针运行日志回滚配置 /etc/logrotate.d/networkbench-php5 守护进程启动脚本 /etc/init.d/networkbench-daemon 或 /etc/rc.d/networkbench-daemon 守护进程配置文件 /etc/networkbench/networkbench.cfg 探针安装日志 /tmp/nbinstall- 安装日期.tar PHP 扩展模块 PHP 扩展模块负责收集 PHP 运行时的性能, 并将性能数据发送给守护进程 PHP 扩展本身不与听云服务器进行数据交换,PHP 扩展通过将数据发送到守护进程进行处理来减少对系统资源的消耗守护进程守护进程是介于听云服务器和 PHP 扩展之间的一个汇总进程, 接收 php 扩展模块捕获的运行时性能数据, 汇总压缩后传送到听云系统后台不启用代理守护进程, 就不会有数据发送到听云系统默认安装时, 汇总进程会被 PHP 自动启动, 不需要用户手动启动 ; 特殊情况下 ( 例如多个 apache 实例 ), 可能需要您更改探针的配置, 并通过 init 脚本来启动汇总进程启动守护进程的 2 种方式 : 1 跟随 apache 或 php-fpm 进程自动启动 ( 默认方式 ) 2 以系统服务方式启动( 需更改配置 ), /etc/init.d/networkbench-daemon start 或者 service networkbench-daemon start

4 停止守护进程 : 1 killall networkbench 或者 kill `cat /var/run/networkbench/php_daemon.pid` 2 /etc/init.d/networkbench-daemon stop 或者 service networkbench-daemon stop

5 1. PHP 探针都能采集哪些数据? 目前, 探针可以采集 php 运行时的性能数据和错误信息性能数据包括 :HTTP 请求的总响应时间前端阻塞时间数据库耗时 NOSQL 耗时外部服务耗时等性能 ; 详细到数据库表及操作的性能统计 ; 超过阈值的 php 脚本及性能瓶颈函数 ; 慢 sql 语句及调用堆栈 ; 错误信息包括 : 数据库连接错误 sql 语法错误 php 运行时未捕获的异常等 ; 2. 我在多台服务器上部署了应用探针, 报表查看时, 如何将不同的应用区分开? 默认数据汇总在同一个应用, 应用名称为 PHP Application, 如果需要分开看, 把配置文件内的 nbs.app_name( 应用名称 ) 改为不同名称就可以了 3. 我在一台服务器上部署了多个应用或多个 Virtual Host, 报表查看时, 如何将不同的应用区分开? 默认数据汇总在同一个应用, 应用名称为 PHP Application, 如果需要分开看, 需要更改不同应用或 Virtual Host 对应的 nbs.app_name( 应用名称 ) 参数, 详细方法请参考配置下的应用名

6 RPM 安装包 (RHEL,CentOS,SUSE) RPM 安装包适用于已经安装了 rpm 系统的 linux 发行版, 包括 ( 但不限于 ) CentOS5 及以后版本 RHEL5 及以后版本 SUSE 10.0 及以后版本安装步骤 : 1 执行 rpm 安装 32 位版本 rpm 包安装 sudo rpm -Uvh tingyun-agent-php-latest.i386.rpm 64 位版本 rpm 包安装 sudo rpm -Uvh tingyun-agent-php-latest.x86_64.rpm 2 初次安装必要的设置 sudo networkbench-install.sh 在接下来的录入界面输入 license 3 重启 php 宿主服务器 (apache, php-fpm) 此后, 当您的 php 后台服务有 http 请求进入, 几分钟后性能数据将发送到听云后台 4 卸载 PHP 探针 sudo rpm -e tingyun-agent-php 5 更新 php 探针更新 php 探针需要执行 3 个步骤停止守护进程卸载 php 探针 sudo killall networkbench sudo rpm -e tingyun-agent-php 安装新版本 php 探针并重启 php 宿主服务器 (apache, php-fpm)

7 sudo rpm -Uvh tingyun-agent-php-latest.x86_64.rpm

8 DEB 安装包 (Debian,Ubuntu) RPM 安装包适用于已经安装了 dpkg 系统的 linux 发行版, 包括 ( 但不限于 ) Debian5 及以后版本 Ubuntu9.10 及以后版本安装步骤 : 1 执行 deb 安装 32 位版本 rpm 包安装 sudo dpkg -i tingyun-agent-php-latest.i386.deb 64 位版本 deb 包安装 sudo dpkg -i tingyun-agent-php-latest.x86_64.deb 2 初次安装必要的设置 sudo networkbench-install.sh 在接下来的录入界面输入 license 3 重启 php 宿主服务器 (apache, php-fpm) 此后, 当您的 php 后台服务有 http 请求进入, 几分钟后性能数据将发送到听云后台 4 卸载 PHP 探针 sudo dpkg -r tingyun-agent-php 5 更新 php 探针更新 php 探针需要执行 3 个步骤停止守护进程卸载 php 探针 sudo killall networkbench sudo dpkg -r tingyun-agent-php 安装新版本 php 探针并重启 php 宿主服务器 (apache, php-fpm)

9 sudo dpkg -i tingyun-agent-php-latest.x86_64.deb

10 BIN 安装包 ( 其他 linux 发行版 ) 与 RPM 安装包和 DEB 安装包相比,BIN 安装包的适用范围更广,BIN 安装包适用于基于 x86/x86_64 内核版本高于 ,GLIBC 版本高于 2.5 的 linux 服务器发行版在这些符合安装条件, 并且没有 dpkg 和 rpm 的系统中可以适用 bin 安装包安装安装步骤 : 1 执行 bin 安装 32 位版本 bin 包安装 wget -q && chmod 755 tingyun-agent-php-latest.i386.bin && sudo./tingyun-agent-php-latest.i386.bin 64 位版本 bin 包安装 wget -q && chmod 755 tingyun-agent-php-latest.x86_64.bin && sudo./tingyunagent-php-latest.x86_64.bin 2 初次安装必要的设置 sudo networkbench-install.sh 在接下来的录入界面输入 license 3 重启 php 宿主服务器 (apache, php-fpm) 此后, 当您的 php 后台服务有 http 请求进入, 几分钟后性能数据将发送到听云后台 4 卸载 PHP 探针 sudo./tingyun-agent-php-latest.x86_64.bin uninstall 5 更新 php 探针更新 php 探针需要执行 3 个步骤停止守护进程卸载 php 探针 sudo killall networkbench

11 sudo./tingyun-agent-php-latest.x86_64.bin uninstall 安装新版本 php 探针并重启 php 宿主服务器 (apache, php-fpm) sudo./tingyun-agent-php-latest.x86_64.bin

12 安装包对应基于 x86/x86_64 处理器的各个 Linux 发行版本, 基调网络提供 6 个安装包, 请选择适合您系统的安装包安装安装包适用 Linux 发行版 32 位版本 64 位版本 RPM 安装包 RedHat Enterprise Linux (RHEL) 5.0 或更高版本 CentOS 5.0 或更高版本 Suse Linux 10.0 或更高版本 tingyun-agent-phplatest.i386.rpm tingyun-agent-phplatest.x86_64.rpm DEB 安装包 Debian 5.0 ("lenny") 或更高版本 Ubuntu 9.10 ("Karmic Koala") 或更高版本 tingyun-agent-phplatest.i386.deb tingyun-agent-phplatest.x86_64.deb BIN 安装包任何其他内核版本高于 ,GLIBC 版本高于 2.5 并且提供本地 Posix 线程库支持的 linux 发行版 tingyun-agent-phplatest.i386.bin tingyun-agent-phplatest.x86_64.bin

13 安装脚本用途 PHP 探针程序需要安装 php 扩展模块到 php 环境中才能正常工作, 并且需要授权序号才能提供数据服务并且, 各个系统的 php 版本和环境有很大差别, 因此, 我们需要有程序来做检测和安装的工作安装脚本充当了这个角色安装脚本需要在首次安装听云 php 探针或者重新安装 php 之后运行安装脚本位置 /usr/bin/networkbench-install.sh 安装步骤及选项含义 1 启动安装脚本 sudo sh /usr/bin/networkbench-install.sh 2 选择安装或解除安装安装脚本启动后, 首先需要您选择是安装到 php 环境还是从 php 环境卸载探针 Please select from one of the following options: 1) Install 2) Uninstall 0) Exit Enter choice (1-2, 0 to exit): 键盘输入 "1" 将继续安装 3 输入授权序号授权序号是您获得的服务授权, 请勿泄漏 Enter Networkbench license key (or leave blank):

14 输入您的授权序号, 继续安装 4 php 版本选择如果您的系统中安装了多个版本的 php, 安装脚本会提示您做出选择, 安装到某个指定版本的 php 或全部安装 Below is a list of the directories in which we found a copy of PHP. Please select the directory or directories for which you wish to install Networkbench. You can select either a single directory or multiple directories by separating each choice with either a space or a comma. To select all of the directories shown, please enter the special keyword 'all' (without the quotes). 1) /usr/bin 2) /usr/local/php/5.3.23/bin 0) Exit Selection (1-2, 0 to exit or all): 键入您选择的序号, 或者 all 全部安装 5 安装结束如果一切顺利, 您将看到如下提示 : Networkbench is now installed on your system. Congratulations! 6 重启 apache 或者您的 fast-cgi 服务器卸载使用此脚本卸载 php 探针扩展 : sudo sh /usr/bin/networkbench-install.sh 选择 2 或者 : sudo sh /usr/bin/networkbench-install.sh uninstall

15 守护进程启动方式完成安装后, 重启 php 的宿主程序 (apache 或者 php-fpm) 后, 守护进程就已经被启动了除此之外, 还有一些特殊情况 ( 例如使用一个守护进程服务于多个 apache 实例或 apache 主进程启动时没有 root 权限造成无法自动启动守护进程 ) 需要通过以 shell 脚本的方式启动守护进程 1 随 Apache 或 PHP-FPM 启动而启动默认情况下 (networkbench.ini 文件配置为 nbs.daemon.launch = true), 宿主程序 (apache 或者 phpfpm) 会自动生成守护的配置文件 (/tmp/.networkbench.cfg), 并且尝试自动启动守护进程 (/usr/bin/networkbench) 如果在此模式下进程列表内缺少了 networkbench 进程, 请使用下面的命令启动守护进程 sudo networkbench -f /tmp/.networkbench.cfg 2 以系统服务方式启动在安装包安装后, 守护进程启动脚本 networkbench-daemon 就已经被放到 /etc/init.d/ 路径下 1) 编辑 networkbench.ini 文件配置为 nbs.daemon.launch = false, 禁止守护进程随宿主程序 (apache 或者 php-fpm) 自动启动 2) 编辑 /etc/networkbench/networkbench.cfg, 修改您需要更改的配置 3) 使用 chkconfig 或其他命令, 配置 networkbench-daemon 为随操作系统自动启动 sudo chkconfig -add networkbench-daemon sudo chkconfig --level networkbench-daemon 2345 on 4) CentOS RHEL SUSE Ubuntu 等系统可以通过如下命令启动和停止守护进程 : sudo service networkbench-daemon start sudo service networkbench-daemon stop Debian 和其他没有 service 命令的 Linux 发行版 : sudo sh /etc/init.d/networkbench-daemon start sudo sh /etc/init.d/networkbench-daemon stop

17 卸载卸载 PHP 探针需要 3 个步骤 : 1 停止守护进程 : sudo killall networkbench 2 从 PHP 环境中卸载探针扩展 : sudo sh /usr/bin/networkbench-install.sh uninstall 3 移除安装包 : rpm 安装版本 : sudo rpm -e tingyun-agent-php deb 安装版本 : sudo dpkg -r tingyun-agent-php bin 安装版本 : sudo./tingyun-agent-php-latest.x86_64.bin uninstall

18 快速安装安装步骤 : 1 软件包安装 RPM 适用于 CentOS,RHEL,SUSE 32 位系统 sudo rpm -Uvh tingyun-agent-php-latest.i386.rpm 64 位系统 DEB sudo rpm -Uvh tingyun-agent-php-latest.x86_64.rpm 适用 Debian, Ubuntu 32 位系统 sudo dpkg -i tingyun-agent-php-latest.i386.deb 64 位系统 BIN sudo dpkg -i tingyun-agent-php-latest.x86_64.deb 适用其他内核高于的 Linux 发行版 32 位系统 sudo./tingyun-agent-php-latest.i386.bin 64 位系统 sudo./tingyun-agent-php-latest.x86_64.bin

19 2 安装配置 sudo sh /usr/bin/networkbench-install.sh 3 重启 apache 或者 fast-cgi 服务器, 安装完毕

20 更新 1 停止 web 容器和守护进程 sudo service httpd stop 或 sudo service php-fpm stop sudo killall networkbench 2 软件包更新 RPM 适用于 CentOS,RHEL,SUSE 32 位系统 sudo rpm -Uvh tingyun-agent-php-latest.i386.rpm 64 位系统 DEB sudo rpm -Uvh tingyun-agent-php-latest.x86_64.rpm 适用 Debian, Ubuntu 32 位系统 sudo dpkg -i tingyun-agent-php-latest.i386.deb 64 位系统 BIN sudo dpkg -i tingyun-agent-php-latest.x86_64.deb 适用其他内核高于的 Linux 发行版 32 位系统 sudo./tingyun-agent-php-latest.i386.bin 64 位系统

21 sudo./tingyun-agent-php-latest.x86_64.bin 3 重启 web 容器 sudo service httpd start 或 sudo service php-fpm start

22 启用 / 禁用性能信息采集配置选项格式 : nbs.agent_enabled = true 数据类型 : boolean 取值 : true/false 默认值 : true 说明允许或者禁止 php 探针采集数据本选项设置为 false 时,php 探针将不再采集性能数据只有当本选项设置为 true 时, 才会有性能数据被采集当您在同一台服务器上部署多个应用, 并且想将禁用采集某一应用的数据时, 您需要修改 APACHE 或 php-fpm 或 NGINX 的配置文件 1.Apache 方式 : 修改 Apache 的配置文件 (httpd.conf 或.htaccess), 这需要有 AllowOverride Options 或 AllowOverride All 权限对需要禁用的 virtual hosts 增加 php_flag nbs.agent_enabled off, 例如 : <VirtualHost > ServerName DocumentRoot "/path/to/vhost2/"... <IfModule PHP_MODULE> php_flag nbs.agent_enabled off </IfModule> </VirtualHost> 注意 IfModule 语句中 PHP_MODULE 应该和引入 php 模块时的名称一致, 如果您加载 PHP 时使用 LoadModule php5_module modules/libphp5.so, 则对应语句应该修改为 "<IfModule

23 php5_module>" 2. php-fpm 方式 : 修改 php-fpm.conf [app2] listen=/tmp/pool-app2.sock php_flag[nbs.agent_enabled] = off 3. nginx 方式 : 修改 nginx.conf location /app1{ fastcgi_param PHP_VALUE "nbs.agent_enabled=false";... }

24 授权序号配置选项格式 : nbs.license_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 数据类型 : string 取值 : 字符串默认值 : 无说明本条配置项是您在安装时输入的授权序号

25 应用名配置选项格式 : nbs.app_name = "PHP Application" 数据类型 : string 取值 : 默认值 : "PHP Application" 说明当您未在服务器端设置应用名称时, 本选项内容将指定默认应用名称当您在多个服务器上安装 PHP 探针时, 听云系统将根据应用名称分别对性能数据做统计当您在同一台服务器上部署多个应用, 并且想将不同的应用区分开时, 您需要修改 APACHE 或 phpfpm 或 NGINX 的配置文件来区分不同的应用 1.Apache 方式 : 修改 Apache 的配置文件 (httpd.conf 或.htaccess), 这需要有 AllowOverride Options 或 AllowOverride All 权限对每个 virtual hosts 增加 php_value nbs.app_name "my app", 例如 : <VirtualHost > ServerName DocumentRoot "/path/to/vhost/"... <IfModule PHP_MODULE> php_value nbs.app_name "my app name" </IfModule> </VirtualHost> <VirtualHost >

26 ServerName DocumentRoot "/path/to/vhost2/"... <IfModule PHP_MODULE> php_value nbs.app_name "disabled app" php_flag nbs.agent_enabled off </IfModule> </VirtualHost> 注意 IfModule 语句中 PHP_MODULE 应该和引入 php 模块时的名称一致, 如果您加载 PHP 时使用 LoadModule php5_module modules/libphp5.so, 则对应语句应该修改为 "<IfModule php5_module>" 2. php-fpm 方式 : 修改 php-fpm.conf [app1] listen=/tmp/pool-app1.sock php_value[nbs.app_name] = "my app name" [app2] listen=/tmp/pool-app2.sock php_value[nbs.app_name] = "disabled app" php_flag[nbs.agent_enabled] = off 3. nginx 方式 : 修改 nginx.conf location /app1 { fastcgi_param PHP_VALUE "nbs.app_name=my app name";... } location /app2{ fastcgi_param PHP_VALUE "nbs.app_name=disabled app"; fastcgi_param PHP_VALUE "nbs.agent_enabled=false";

27 ... }

28 日志管理 PHP 探针有两个模块 : 守护进程和 PHP 扩展每个模块都有单独的日志管理 1 PHP 扩展日志 : 日志文件路径配置选项格式 : nbs.agent_log_file_name = "/var/log/networkbench/php-agent.log" 数据类型 : string 取值 : 默认值 : "/var/log/networkbench/php-agent.log" 说明 : 指定 php 扩展的日志文件路径日志级别配置选项格式 : nbs.agent_log_level = "info" 数据类型 : string 取值 : "OFF", "CRITICAL", "ERROR", "WARNING", "INFO", "VERBOSE", "DEBUG" 默认值 : "INFO" 说明 : 2 守护进程日志 : 本选项是控制日志数据写入日志文件的级别 "DEBUG" 是最低级, 允许所有日志信息写入日志文件 "OFF" 是最高级, 禁止所有日志信息写入日志文件

29 日志文件路径配置选项格式 : nbs.daemon_log_file_name = "/var/log/networkbench/daemon.log" 数据类型 : string 取值 : 默认值 : "/var/log/networkbench/daemon.log" 说明 : 指定守护进程的日志文件路径日志级别配置选项格式 : nbs.daemon_log_level = "info" 数据类型 : string 取值 : "OFF", "CRITICAL", "ERROR", "WARNING", "INFO", "VERBOSE", "DEBUG" 默认值 : "INFO" 说明 : 本选项是控制日志数据写入日志文件的级别 "DEBUG" 是最低级, 允许所有日志信息写入日志文件 "OFF" 是最高级, 禁止所有日志信息写入日志文件

30 守护进程自动加载选项是否自动启动守护进程配置选项格式 : nbs.daemon.launch = true 数据类型 : boolean 取值 : true/false 默认值 : true 说明 : 是否允许守护进程随宿主程序 (apache 或者 php-fpm) 自动启动守护进程负责收集 php 产生的性能数据并发送至报表服务器当 apache 或 php-fpm 启动权限不是 root 时, 可能会导致自动启动守护进程失败, 此时可以修改此项为 false, 使用 chkconfig 或其他命令, 配置 networkbench-daemon 为随操作系统启动, 并使用 /etc/init.d/networkbench-daemon start 或者 service networkbench-daemon start 管理此服务守护进程路径配置选项格式 : nbs.daemon.location = "/usr/bin/networkbench" 数据类型 : string 取值 : 默认值 : "/usr/bin/networkbench" 说明 : 守护进程的路径若 nbs.daemon.launch=true, 则 apache 或 php-fpm 启动时自动启动守护进程

32 审计模式配置选项格式 : nbs.audit_mode = false 数据类型 : boolean 取值 : true/false 默认值 : false 说明 : 本选项设定是否在日志文件中写入更详尽的信息, 包括所有的向听云后台上传和下载的数据

33 性能数据发送控制 SQL 语句发送控制配置选项格式 : nbs.action_tracer.log_sql = false 数据类型 : boolean 取值 : true/false 默认值 : false 说明 : 若本选项为 true, 向服务器提交的数据中将只包含 sql 语句, 若为 false, 将发送 sql 语句和慢 sql 的 trace 信息

34 数据发送连接选项是否启用 http 安全连接配置选项格式 : nbs.ssl = true 数据类型 : boolean 取值 : true/false 默认值 : true 说明 : 本选项指定向服务器发送数据是否弃用安全连接 (https) 若设定为 true, 则向服务器发送数据时期用 https 方式否则, 使用普通 http 方式代理服务器地址配置选项格式 : nbs.proxy_host = 数据类型 : stirng 取值 : 默认值 : 无说明 : 本选项指定代理服务器的地址若选项不为空, 并且未启用安全连接, 则本选项值为 http 代理服务器的 ip 地址代理服务器端口配置选项格式 : nbs.proxy_port =

35 数据类型 : digit 取值 : 默认值 : 无说明 : 同前, 本选项指定代理服务器的端口代理服务器 user 配置选项格式 : nbs.proxy_user = 数据类型 : digit 取值 : 默认值 : 无说明 : 同前, 若代理服务器需要用户名密码, 本选项指定代理服务器的登陆名代理服务器 password 配置选项格式 : nbs.proxy_password = 数据类型 : digit 取值 : 默认值 : 无说明 : 同前, 若代理服务器需要用户名密码, 本选项指定代理服务器的登陆密码

36 听云 PHP 探针配置 1) 编辑配置文件 vi 配置文件 2)kill 探针的守护进程 sudo killall networkbench 3) 重启 web server sudo service httpd restart 或 sudo service php-fpm restart 配置文件位置会根据软件环境不同而不同, 几个典型的位置包括 : /etc/php.d/networkbench.ini 或 /etc/php5/fpm/conf.d/networkbench.ini, 如果 php 是通过源码编译安装的, 那么配置文件的位置依赖于编译时选项指定的位置 1) 如果编译 php 时指定了 --with-config-file-scan-dir 选项, 那么 networkbench.ini 会放在编译时指定的位置运行 php -i grep.ini, 其中的 Scan this dir for additional.ini files 标明了配置文件的具体位置例如 Scan this dir for additional.ini files => /opt/php.d/, 相应配置文件为 /opt/php.d/networkbench.ini 2) 如果编译 php 时禁止了 --with-config-file-scan-dir 选项, 那么配置文件会合并在 php 主配置文件中运行 php -i grep.ini, 其中的 Scan this dir for additional.ini files =>(none) 表示编译 php 时禁止了 --withconfig-file-scan-dir 选项, 其中的 Loaded Configuration File 标明了 php 主配置文件的具体位置例如 Loaded Configuration File=> /opt/php55/lib/php.ini, 说明配置在 /opt/php55/lib/php.ini 文件内

37 产品特点

38 日志目录为 /var/log/networkbench/, 其中包括 php-agent.log 和 daemon.log php-agent.log 日志 : 1) 如果系统启用了 logrotate 服务, 安装脚本会在 /etc/logrotate.d/ 下安装名称为 networkbench-php5 的配置文件, 此配置文件对 /var/log/networkbench/php-agent.log 进行管理 2) 如果系统没有启用 logrotate 服务, 需要运维人员对 /var/log/networkbench/php-agent.log 进行处理 daemon.log 日志 : 此日志由 daemon 进程维护, 默认最多保留 10 个文件, 每个文件最大 100M

39 排除安装故障 1. 安装 RPM 包时, 出现 error: Failed dependencies 提示 tmp]$ rpm -Uvh tingyun-agent-php-latest.x86_64.rpm error: Failed dependencies: ld-linux-x86-64.so.2()(64bit) is needed by tingyun-agent-php x86_64 ld-linux-x86-64.so.2(glibc_2.3)(64bit) is needed by tingyun-agentphp x86_64 libc.so.6()(64bit) is needed by tingyun-agent-php x86_64 libc.so.6(glibc_2.2.5)(64bit) is needed by tingyun-agent-php x86_64 libc.so.6(glibc_2.3)(64bit) is needed by tingyun-agent-php x86_64 libc.so.6(glibc_2.3.2)(64bit) is needed by tingyun-agent-php x86_64 libc.so.6(glibc_2.4)(64bit) is needed by tingyun-agent-php x86_64 libdl.so.2()(64bit) is needed by tingyun-agent-php x86_64 libdl.so.2(glibc_2.2.5)(64bit) is needed by tingyun-agent-php x86_64 libgcc_s.so.1()(64bit) is needed by tingyun-agent-php x86_64 libgcc_s.so.1(gcc_3.0)(64bit) is needed by tingyun-agent-php x86_64 libgcc_s.so.1(gcc_3.3)(64bit) is needed by tingyun-agent-php x86_64 libgcc_s.so.1(gcc_4.2.0)(64bit) is needed by tingyun-agent-php x86_64 libm.so.6()(64bit) is needed by tingyun-agent-php x86_64 libpthread.so.0()(64bit) is needed by tingyun-agent-php x86_64 libpthread.so.0(glibc_2.2.5)(64bit) is needed by tingyun-agentphp x86_64 出现此提示的原因是您的操作系统为 32 位, 但您尝试安装 64 位的 RPM 包, 请更换为 32 位的 RPM 包 2. 运行 networkbench-install.sh 时, 出现 PHP install path not found, please enter the path. 提示出现此提示的原因是在系统环境变量里面找不到 php 的安装路径, 需要手工指定 php 的安装路径录入 php 所在的文件夹路径, 例如 : php 的位置是 /opt/php5/bin/php, 就录入 /opt/php5/bin 3. 运行 networkbench-install.sh 时, 出现 The Networkbench agent is not installed. 提示 PHP 环境中缺少探针安装相关的必要信息, 导致无法自动安装 PHP 扩展解决方法请参见 : 文档内故障排查的手动安装 PHP 扩展一节 4. 运行 networkbench-install.sh 时,PHP 版本选择步骤中, Below is a list of the directories in which we found a copy of PHP 列表中, 没有用户期望的 PHP 路径在系统环境变量里面找不到用户期望的 PHP 安装路径

40 解决方法 : 将此 php 的安装路径加入到 PATH 环境变量中, 然后重新运行安装脚本 5 安装成功但报表内无数据 1) 初次安装后需要一段时间才能看到数据, 通常需要 5 分钟或更长时间, 请多等一段时间 2) 有的用户浏览器 ( 比如猎豹 ) 缓存有问题, 即使有数据如果不强制刷新也可能看不到, 请尝试清空缓存或强制刷新或更换浏览器 3) 探针安装成功后, 必须重启 apache 或 php-fpm, 否则探针不生效 4) 确认 PHP 的扩展配置文件中授权序号正确通常 networkbench.ini 位于 /etc/php.d/networkbench.ini 或 /etc/php5/fpm/conf.d/networkbench.ini, 如果 php 是通过源码编译安装的, 那么配置文件的位置依赖于编译时选项指定的位置 nbs.license_key = " 此处修改为您的授权序号 " 5) 确认 web 服务器有没有用户访问探针数据是基于 http 请求的性能, 如果没有访问, 就不会有性能数据如果没有用户访问, 请使用浏览器访问一下相应的应用, 再过 5 分钟后查看报表

41 检查守护进程确认守护进程在运行 : ps aux grep networkbench 正常情况下的信息和以下截图类似 : 如果 networkbench 进程不存在, 请重启 web server sudo service httpd restart 或 sudo service php-fpm restart 然后再次运行 ps -e grep networkbench, 查看输出结果如果 networkbench 进程仍不存在, 请运行 ll /usr/bin/networkbench 查看输出结果, 确认守护进程文件是否存在如果 /usr/bin/networkbench 不存在, 说明守护被误删了, 请重新安装探针

42 检查 php 扩展模块创建 info.php, 内容如下, 并将 info.php 放在网站某个目录下 <?php phpinfo();?> 通过浏览器访问 info.php, 查找页面内是否存在关键字 networkbench, 并且查看 nbs.app_name 内容, 此值如果为空 (no value) 说明配置文件路径错误或内容错误, 查看 nbs.license_key 内容, 此值应该和听云帐号内的授权码一致正常情况下的信息和以下截图类似若没有 networkbench 模块信息, 请以 root 运行 networkbench-install.sh #networkbench-install.sh 然后, 请重启 apache 或您的 fast-cgi 程序以重新加载 php 扩展

43 执行上述操作后, 刷新浏览器的 info.php 页面, 如果仍未出现 networkbench 模块信息, 则很有可能您的 php 版本不符合安装条件, 或者是经过裁剪修改的 php 版本.

44 查看日志如果系统工作不正常或者没有数据, 通常可以从日志里获取更多的信息来定位问题. 日志默认路径 : /var/log/networkbench/ 守护进程日志 : /var/log/networkbench/daemon.log php 扩展日志 :/var/log/networkbench/php-agent.log 运行 ll /var/log/networkbench 正常情况下会存在 2 个日志 ( daemon.log 和 php-agent.log) 1) 如果 php-agent.log 不存在说明 PHP 扩展有问题, 请检查 php 扩展模块 2) 如果 daemon.log 不存在说明守护进程有问题, 请确认守护进程在运行如果 2 个日志都存在说明安装没有问题, 请运行 grep -E 'CRITICAL ERROR error' /var/log/networkbench/php-agent.log 如果 php-agent 输出有 ERROR 信息, 说明 PHP 扩展运行时有错误 grep -E 'CRITICAL ERROR error' /var/log/networkbench/daemon.log 如果 daemon 输出有 ERROR 信息, 说明可能和服务器通信有问题关于日志的输出控制, 请参考配置章节. 默认情况, 日志级别为 info, 审计模式是关闭的, 这种情况得到的信息量比较小. 通过修改日志级别为 debug, 开启审计模式, 让守护进程和 php 扩展输出更多日志信息, 通过日志得到的信息定位问题.

45 当无法在标准位置查找到 php 或缺少 php 某些信息时, 安装脚本无法自动安装 php 扩展, 此时需要我们手动安装 1) 确认操作系统位数确认操作系统是 32 位还是 64 位 uname -a 2) 确认 PHP 信息在有权限生成 PHP 文件的情况下, 最好使用 phpinfo() 函数来验证 : 通过生成 info.php 文件, 使用浏览器访问 info.php 查看 php 信息 echo "<?php phpinfo();?>" > /var/www/html/info.php 否则, 使用 php -i grep 来验证 php 信息信息名称 info.php 方式 php -i 方式 PHP API 是否启用了 zts 扩展 so 路径 php -i grep "PHP API" php -i grep "Thread Safety" php -i grep "extension_dir" ini 配置文件路径 php -i grep "Loaded Configuration File" php -i grep "Scan this dir for additional" 3) 安装 so 扩展进入到 php 扩展 so 路径 (extension_dir 指定的路径 ), 做一个软链接 networkbench.so 到 /usr/lib/networkbench/agent/ 下的对应版本的 so 扩展这里假设操作系统是 64 位,php 版本是 5.3, 对应 api 版本为 , php 启用了 zts(zend thread safe) 模式, 扩展 so 路径为 /usr/lib64/php/modules cd /usr/lib64/php/modules

46 ln -s /usr/lib/networkbench/agent/x64/networkbench zts.so networkbench.so PHP 版本和探针 so 对应关系 PHP 版本 PHP API 启用 zts 禁用 zts networkbench zts.so networkbench zts.so networkbench zts.so networkbench zts.so networkbench so networkbench so networkbench so networkbench so 4) 增加扩展对应的配置文件, 并修改授权码 a. 如果 PHP 信息中附加的配置文件路径不为空 ( 即 Scan this dir for additional 不为 "none"), 将配置文件模版 networkbench.ini.template 复制到 php 扩展配置的文件夹, 并改名为 networkbench.ini b. 如果附加的配置路径为空 ( 即 Scan this dir for additional 值为 "none"), 将配置文件模版 networkbench.ini.template 的内容添加到 PHP 主配置文件 ("Loaded Configuration File" 项指定的文件 ) 后面假设存在附加的 php 扩展配置路径 :/etc/php.d/ cd /etc/php.d/ cp /usr/lib/networkbench/scripts/networkbench.ini.template networkbench.ini vi networkbench.ini 将配置文件内 nbs.license_key = "REPLACE_WITH_REAL_KEY" 中 REPLACE_WITH_REAL_KEY 替换为您的授权码 5) 重启 apache 或 php-fpm

47 版权申明本文档版权归北京基调网络系统有限公司所有未经书面许可, 任何人不得复制传播北京基调网络系统有限公司总部地址 : 北京市朝阳区京顺路 5 号曙光大厦 C 座 207 室邮编 : 联系电话 :

内容

基调网络听云 PHP 探针说明 PHP 探针 1 简介运行环境探针架构常见问题 2 安装 2.1 安装包 RPM 安装包 (RHEL,CentOS,SUSE) DEB 安装包 (Debian,Ubuntu) BIN 安装包 ( 其他 linux 发行版 ) 2.2 安装脚本 2.3 守护进程启动方式 2.4 卸载基调网络听云 PHP 探针说明 2.5 快速安装 2.6 更新 3 配置排队时间启用