为PHP应用安装ARMS PHP探针后,ARMS即可开始监控PHP应用,您可以查看应用拓扑、调用链路、异常事务、慢事务和SQL分析等一系列监控数据。本文介绍如何为单机多站点PHP应用安装探针。

注意 ARMS应用监控的PHP应用监控功能目前正处于维护中,暂不支持通过控制台获取PHP Agent。如果您需要使用PHP应用监控功能,请联系ARMS PHP应用答疑群(群号:23328286)获取PHP应用接入应用监控的方法。

安装探针

  1. 安装探针,具体操作,请参见为普通PHP应用安装探针
  2. 修改Apache或Nginx的配置文件。
    • 如果是Apache单机多站点应用,则在每个VirtualHost中添加php_value arms.app_name "<yourAppNewName>",其中<yourAppNewName>需替换为您的PHP应用的名称。例如:
      <VirtualHost *:80>
          ServerName www.example.com
          DocumentRoot /home/www/html
          php_value arms.app_name "example"
          <Directory "/home/www/html">
                Options FollowSymLinks
                AllowOverride All
                Require all granted
          </Directory>
      </VirtualHost>
      <VirtualHost *:80>
          ServerName www.test.com
          DocumentRoot /home/www/test
          php_value arms.app_name "test"
          <Directory "/home/www/test">
                Options FollowSymLinks
                AllowOverride All
                Require all denied
                Require all granted
          </Directory>
      </VirtualHost>
    • 如果是Nginx单机多站点应用,则在每个Server的PHP-FPM配置文件中添加fastcgi_param PHP_VALUE "arms.app_name=<yourAppNewName>" ,其中<yourAppNewName>需替换为您的PHP应用的名称。例如:
      server {
              listen       80;
              server_name  localhost;
              location / {
                          try_files $uri $uri/ /index.php?$query_string;
                  }
              error_page   500 502 503 504  /50x.html;
              location = /50x.html {
                  root   /usr/share/nginx/html;
              }
              location ~ \.php$ {
                  fastcgi_pass   localhost:9000;
                  fastcgi_index  index.php;
                  fastcgi_param  PHP_VALUE "arms.app_name=example"
                  fastcgi_param  SCRIPT_FILENAME  /var/www/html/$fastcgi_script_name;
                  include        fastcgi_params;
              }
          }
       server {
              listen       80;
              server_name  www.example.com;
              location / {
                          try_files $uri $uri/ /index.php?$query_string;
                  }
              error_page   500 502 503 504  /50x.html;
              location = /50x.html {
                  root   /usr/share/nginx/html;
              }
              location ~ \.php$ {
                  fastcgi_pass   localhost:9000;
                  fastcgi_index  index.php;
                  fastcgi_param  PHP_VALUE "arms.app_name=test"
                  fastcgi_param  SCRIPT_FILENAME  /var/www/test/$fastcgi_script_name;
                  include        fastcgi_params;
              }
          }
    等待1分钟左右,如果ARMS控制台应用监控 > 应用列表页面上出现了您的应用(应用名称为自定义的<yourAppName>),则说明您已成功安装探针。

卸载探针

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