安装PHP Agent
管理和卸载PHP Agent
要监控PHP应用,在透视宝云端的“配置→应用”页面中选择“PHP”语言,按照页面中的引导安装PHP Agent,详细说明如下。
获取授权编号
授权编号是透视宝用户身份识别的License Key,每个用户对应一个唯一的授权编号,在后续配置中需要使用。
下载AgentServer安装包
AgentServer是主机与透视宝平台通讯以及监控PHPAgent心跳的插件。
注意:AgentServer只支持Linux系统。
点击<下载AgentServer for Linux(版本)>按钮或者复制Wget链接,下载最新版本的AgentServer安装包。
安装AgentServer
1、将下载的压缩包拷贝到系统某个目录(如/data),并进入该目录。
cd /data/AgentServer_Linux_2.0.0
2、修改 conf/app.ini 配置文件中的License、SendUrl、ApiUrl。
License=J45Engw88Nc/fR1k7e53nphkNSQbbc8JEfXHo5cek8NKBcPok1f56Q!!!! SendUrl=http://seal-data.toushibao.com ApiUrl=http://seal-data.toushibao.com
3、配置权限。
chmod u+x ./AgentServer.sh
4、启动 AgentServer。
./AgentServer.sh start
下载PHP Agent安装包
PHP Agent只支持Linux系统,点击<下载PHP Agent(版本)>按钮或复制Wget链接,下载最新版本的PHP Agent安装包。
注意:支持PHP 5.3~5.6、PHP 7.0~7.2,请确保已安装php-curl扩展。
安装PHP Agent
1、创建cloudwise文件夹(如/var/cloudwise)并确保拥有读写权限,例如:
mkdir -p /var/cloudwise
2、解压缩安装包到cloudwise目录,例如:
unzip PHPAgent_Linux_2.1.3.zip -d /var/cloudwise
3、配置bin目录和php.ini路径
进入PHP Agent目录(如PHPAgent_Linux_2.1.3),指定PHP环境的bin目录(如/usr/local/php-5.6.6/bin)和php.ini路径,例如:
bash install.sh -d '/usr/local/php-5.6.6/bin' -i '/usr/local/php-5.6.6/lib/php.ini'
4、设置由本机 AgentServer 发送数据(可选),例如:
bash install.sh -s 'http://127.0.0.1:26789'
5、执行如下命令启动PHP Agent:
bash install.sh start
6、重启 Apache 或 php-fpm
安装配置完成后,稍等几分钟您可以在“应用”模块查看PHP应用数据。请注意,从来没被访问过的应用不会显示在应用列表中。
安装PHP Agent后,您可以在PHP Agent conf目录的app.conf文件中查看可配置项,主要配置项及相关说明见下表:
配置项 | 说明 |
UserTimeLimitBarFrequency | 用于设置慢请求的记录频率,单位为秒(s)。例如设置为60,则在60s内,对于同一个请求,只记录一次慢请求。 |
UserFunctionTimeLimitBar | 用于设置需要采集的方法的执行时间阈值,单位为微秒(μs)。例如设置为1000,则执行时间大于1000微秒(即大于1ms)的方法才会被采集。 |
UserTimeLimitBar | 用于设置慢请求的阈值,单位为毫秒(ms)。例如设置为500,则响应时间大于500ms的请求为慢请求。 |
PHP install bin path | 用于配置PHP 安装路径。安装PHP Agent时,默认会使用whereis php命令查找系统内的PHP进行安装,此时不需要修改该配置项。 如果PHP环境是通过编译安装的,需要通过该配置项设置PHP的安装路径(bin目录),即将install.sh脚本中的变量“APPD_PHP_PATH“的值修改为PHP环境的bin目录,例如“/usr/local/php-5.6.6/bin”。 |
管理与卸载PHP Agent
安装应用PHP Agent后,您可以管理PHP Agent,包括启动、停止、重启等。
首先,进入PHP Agent安装目录下(如cloudwise/PHP Agent),然后执行相应命令管理PHP Agent。
启动、停止、重启PHP Agent后,需要重启Apache 或 php-fpm。
启动PHP Agent
在Linux系统中,执行以下命令可以启动PHP Agent:
bash install.sh start
停止PHP Agent
在Linux系统中,执行以下命令可以停止PHP Agent:
bash install.sh stop
重启PHP Agent
在Linux系统中,执行以下命令可以重启PHP Agent:
bash install.sh restart
查看PHP Agent状态
在Linux系统中,执行以下命令可以查看PHP Agent状态:
bash install.sh status
兼容性说明
目前,PHP Agent支持的PHP版本、应用框架、应用服务器、数据库、API等说明如下:
类型 | 支持类型/版本 |
Web/App Server |
|
应用框架 | 支持所有应用框架 |
API |
|
PHP版本 | 运行模式NTS,ZTS,PHP-FPM
|
SQL数据库 |
|
NoSQL数据库 |
|
OS |
|