安装PHP Agent

安装PHP Agent

配置PHP Agent

管理和卸载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后,您可以在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

  • Apache 2.2/2.4

  • Nginx 1.5.4/1.6.3/1.8.0/1.9.3

应用框架

支持所有应用框架

API

  • CURL

  • IO

  • cgi-fcgi

  • cgi

  • apache2handler

  • apache2filter

  • aolserver

  • apache

  • litespeed

  • pm-fcgi

  • Cl

PHP版本

运行模式NTS,ZTS,PHP-FPM

  • HP 5.3 (php5.3.29-zts / php5.3.3-nts / php5.3.29-fpm)

  • PHP 5.4 (php5.4.40-zts / php5.4.40-fpm)

  • PHP 5.5 (php5.5.22-zts / php5.5.22-fpm)

  • PHP 5.6 (php5.6.2-zts / php5.6.10-nts / php5.6.2-fpm)

  • PHP 7.0 (php7.0-zts / php7.0-nts / php7.0-fpm)

  • PHP 7.1 (php7.1-zts / php7.1-nts / php7.1-fpm)

  • PHP 7.2 (php7.2-zts / php7.2-nts / php7.2-fpm)

SQL数据库

  • MySQL

  • SQLite

  • PDO:MySQL

  • PDO:SQLite

NoSQL数据库

  • Memcache

  • Redis

  • MongoDB

OS

  • Ubuntu 12.04及以上版本(64位)

  • CentOS 5.2及以上版本(64位)

  • RedHat 5.3/5.6/5.7/5.8/6.0

  • SUSE Enterprise 10及以上版本(64位)

  • FreeBSD 7.4及以上版本(64位)

  • Debian 6.0及以上版本 (64位)