您可以通过以下两种方式安装配置PHP插件(查看兼容性):
在云端页面中安装配置PHP插件,相关说明请参考“在云端页面安装管理插件”。
在主机端通过命令安装配置PHP插件,下面主要介绍这种方式的安装配置方法。
安装PHP插件
要监控PHP应用,您需要安装PHP插件。首先请切换至Smart Agent安装目录的bin目录,然后执行./plugin.sh -install PHP -P [Port]命令安装插件,例如:
./plugin.sh -install PHP -P 1001
-P参数用于指定端口,对于本来没有端口的插件,指定端口可以标识插件的唯一性。同一插件可以通过指定不同的端口安装多个,当然您也可以不指定端口,安装时直接执行./plugin.sh -install PHP命令即可。
需要说明的是:
安装PHP插件时,默认会使用whereis php命令查找系统内的PHP进行安装。如果PHP环境是通过编译安装的,需要将install.sh脚本中的变量“APPD_PHP_PATH“的值修改为PHP环境的bin目录,例如“/usr/local/php-5.6.6/bin”。
修改后,在插件安装目录下执行install.sh start命令安装PHP插件。
配置PHP插件
安装PHP插件后,您可以通过以下两种方式配置插件:
逐个配置
执行./plugin.sh -config PHP -P [Port]命令,通过配置引导逐步配置插件,例如:
./plugin.sh -config PHP -P 1001
安装插件时未指定端口时,直接执行./plugin.sh -config PHP命令即可。
按照配置引导的提示,确认配置项后输入对应的序号,查看当前配置项的值并输入新的值。配置完成后,输入对应序号保存配置并退出配置引导。
批量配置
您还可以在执行./plugin.sh -config PHP -P [Port]命令时,通过指定参数名称和参数值直接配置插件的多个配置项,例如:
./plugin.sh -config PHP -P 1001 -utlbf 180 -uftlb 2000 -utlb 100 -b /usr/local/php-5.6.6/bin
安装插件时未指定端口时,直接执行./plugin.sh -config PHP命令并配置参数即可。
其中:
“-utlbf”用于配置:UserTimeLimitBarFrequency
“-uftlb”用于配置:UserFunctionTimeLimitBar
“-utlb”用于配置:UserTimeLimitBar
“-b”用于配置:APPD_PHP_PATH,即 PHP install bin path
配置项说明
安装PHP插件后,您可以在PHP插件conf目录的app.conf文件中查看可配置项,主要配置项及相关说明见下表:
配置项 | 说明 |
UserTimeLimitBarFrequency | 用于设置慢请求的记录频率,单位为秒(s)。例如设置为60,则在60s内,对于同一个请求,只记录一次慢请求。 |
UserFunctionTimeLimitBar | 用于设置需要采集的方法的执行时间阈值,单位为微秒(μs)。例如设置为1000,则执行时间大于1000微秒(即大于1ms)的方法才会被采集。 |
UserTimeLimitBar | 用于设置慢请求的阈值,单位为毫秒(ms)。例如设置为500,则响应时间大于500ms的请求为慢请求。 |
PHP install bin path | 用于配置PHP安装路径。安装PHP插件时,默认会使用whereis php命令查找系统内的PHP进行安装,此时不需要修改该配置项。 如果PHP环境是通过编译安装的,需要通过该配置项设置PHP的安装路径(bin目录),即将install.sh脚本中的变量“APPD_PHP_PATH“的值修改为PHP环境的bin目录,例如“/usr/local/php-5.6.6/bin”。 |
此外,您还可以手动配置PHP插件的数据发送端口。PHP插件默认使用UDP端口发送数据,如果需要使用TCP端口发送数据,请在PHP插件安装目录的conf 目录下,修改smart_agent.ini.tpl文件中的相关参数:
将“smart_agent.use_udp”的值修改为“0“,将”smart_agent.use_proxy“的值修改为”1“即可。
修改后需要重启插件和相关Web Server(apache、httpd、php-fpm),重启后将数据发送方式修改为TCP。 |
启动PHP插件
安装配置插件后,执行./plugin.sh -start PHP -P [Port]命令启动插件,例如:
./plugin.sh -start PHP -P 1001
安装插件时未指定端口时,直接执行./plugin.sh -start PHP命令即可。
启动插件后,为保证配置生效并避免出错,您需要重启以下服务: apache、httpd、php-fpm 注:启动、停止、重启、更新插件后都需要重启这些服务。 |
启动成功后,稍等几分钟您可以在“应用”模块的应用列表中查看数据。但请注意,从来没被访问过的应用不会显示在应用列表中。