为PHP应用安装ARMS PHP探针后,即可对PHP应用进行应用拓扑、调用链路追踪、异常事务和慢事务监控及SQL分析等监控。与此同时,ARMS提供的新版PHP探针,在性能方面进行深度优化,可将探针对CPU及内存的占用率控制在5%左右。

说明 如果您需要试用新版PHP探针,请立即开通ARMS试用版。新版PHP探针的试用期结束时间请参见ARMS控制台公告。若您还有其他问题,可加入我们的钉钉答疑群:23328286。

为普通PHP应用安装探针

  1. 根据所处网络环境选择公网下载地址或VPC下载地址,使用Wget命令下载Agent压缩安装包。

    在公网环境下的下载地址如下所示。

    # 杭州地域
    wget "http://arms-apm-hangzhou.oss-cn-hangzhou.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip
    # 上海地域
    wget "http://arms-apm-shanghai.oss-cn-shanghai.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip
    # 青岛地域
    wget "http://arms-apm-qingdao.oss-cn-qingdao.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip
    # 北京地域
    wget "http://arms-apm-beijing.oss-cn-beijing.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip
    # 张家口地域
    wget "http://arms-apm-zhangjiakou.oss-cn-zhangjiakou.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip
    # 深圳地域
    wget "http://arms-apm-shenzhen.oss-cn-shenzhen.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip
    # 香港地域
    wget "http://arms-apm-hongkong.oss-cn-hongkong.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip

    在VPC环境下的下载地址如下所示。

    # 杭州地域
    wget "http://arms-apm-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip
    # 上海地域
    wget "http://arms-apm-shanghai.oss-cn-shanghai-internal.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip
    # 青岛地域
    wget "http://arms-apm-qingdao.oss-cn-qingdao-internal.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip
    # 北京地域
    wget "http://arms-apm-beijing.oss-cn-beijing-internal.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip
    # 张家口地域
    wget "http://arms-apm-zhangjiakou.oss-cn-zhangjiakou-internal.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip
    # 深圳地域
    wget "http://arms-apm-shenzhen.oss-cn-shenzhen-internal.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip
    # 香港地域
    wget "http://arms-apm-hongkong.oss-cn-hongkong-internal.aliyuncs.com/arms-php-agent.zip" -O arms-php-agent.zip
  2. 执行以下命令,将安装包解压缩并移动至/usr/local/arms/arms-php-agent目录。
    unzip arms-php-agent.zip
    mkdir -p /usr/local/arms
    mv arms-php-agent /usr/local/arms/arms-php-agent
  3. 登录ARMS控制台
  4. 在左侧导航栏中选择应用监控 > 应用列表,并在应用列表页面顶部选择目标地域,然后在右上角单击接入应用
  5. 接入应用页面复制顶部的LicenseKey。
  6. php.ini配置文件中添加以下内容。
    extension=/usr/local/arms/arms-php-agent/arms-x.x.so
    [ARMS]
    arms.enable=1
    arms.app_name=<yourAppName>
    arms.license_key=<yourLicenseKey>
    arms.sock_path=/arms.sock
    说明
    • arms-x.x.so中的x.x为您的PHP应用的版本,目前支持5.4~7.3版本的PHP应用。
    • 自定义设置<yourAppName>,您的PHP应用会以此名称显示在ARMS控制台中。
    • <yourLicenseKey>替换为步骤5获取的LicenseKey。
    • 如果您的PHP应用对应的版本配置了with-config-file-scan-dir,则可在/etc/php/7.2/php-fpm/conf.d目录下新建arms.ini文件,内容与以上在php.ini文件中添加的内容一致。
  7. 执行以下命令,启动Hercules服务上报您的PHP应用数据。
    cd /usr/local/arms/arms-php-agent/
    sudo ./hercules service install
    sudo ./hercules service start
  8. 重启服务。
    • 如果您使用的是Ngnix服务器,则重启PHP-FPM服务。
    • 如果您使用的是Apache服务器,则重启Apache2服务。
    等待1分钟左右,如果ARMS控制台应用监控 > 应用列表页面上出现了您的应用(应用名称为自定义的<yourAppName>),则说明您已成功安装探针。

卸载探针

  1. 删除步骤6中添加的php.ini文件内容或arms.ini文件。
  2. 重启服务。
    • 如果您使用的是Ngnix服务器,则重启PHP-FPM服务。
    • 如果您使用的是Apache服务器,则重启Apache2服务。
  3. 执行以下命令停止并卸载Hercules服务。
    sudo ./hercules service stop
    sudo ./hercules service uninstall
  4. 执行以下命令删除探针目录。
    sudo rm -rf /usr/local/arms/arms-php-agent
    您已完全卸载ARMS PHP探针。