How to configure the PHP-FPM plugin of 360 Monitoring on a Plesk server?

1. Log into Plesk

2. Go to Domains > example.com > PHP Settings

3. Add the following lines to the Additional directives field:

   CONFIG_TEXT: [php-fpm-pool-settings]
   pm.status_path = /status_phpfpm

4. Click OK

5. Go to Domains > example.com > Apache & nginx Settings

6. Add the following lines to the Additional directives for nginx:

   CONFIG_TEXT: location ~ ^/status_phpfpm$ {
   fastcgi_split_path_info ^((?U).+\.php)(/?.+)$;
   fastcgi_param PATH_INFO $fastcgi_path_info;
   fastcgi_pass "unix:///var/www/vhosts/system/example.com/php-fpm.sock";
   include /etc/nginx/fastcgi.conf;
   }

7. Click OK

8. Connect to the server via SSH

9. Add the following section to the file /etc/agent360.ini:

   CONFIG_TEXT: [phpfpm]
   enabled = yes
   status_page_url = https://example.com/status_phpfpm?json

10. Restart the service:

    # systemctl restart agent360

Note: It is needed to repeat the steps for every domain that is needed to be monitored. For multiple domains, the section in /etc/agent360.ini should look like this one:

CONFIG_TEXT: [phpfpm]
enabled = yes
status_page_url = https://example.com/status_phpfpm?json, https://domain.tld/status_phpfpm?json, ...

1. Connect to the server via SSH

2. Copy the default template to create a custom one:

   # cp -a /usr/local/psa/admin/conf/templates/default/domain/nginxDomainVirtualHost.php /usr/local/psa/admin/conf/templates/custom/domain/nginxDomainVirtualHost.php

3. Edit file /usr/local/psa/admin/conf/templates/custom/domain/nginxDomainVirtualHost.php by adding the following lines:

   CONFIG_TEXT: location ~ ^/status_phpfpm$ {
   allow <?php echo $OPT['ipAddress']->escapedAddress; ?>;
   deny all;
   fastcgi_split_path_info ^((?U).+.php)(/?.+)$;
   fastcgi_param PATH_INFO $fastcgi_path_info;
   fastcgi_pass "unix://<?php echo $VAR->server->webserver->vhostsDir ?>/system/<?php echo $VAR->domain->targetName; ?>/php-fpm.sock";
   include /etc/nginx/fastcgi.conf;
   }

   Note: The lines should be added as the last location section inside the block:

   CONFIG_TEXT: <?php if ($VAR->domain->active && $VAR->domain->physicalHosting->php && $VAR->domain->physicalHosting->proxySettings['nginxServePhp']): ?>
   ...
   <?php endif ?>

4. Update the PHP Settings by adding the necessary Additional directive:

   # echo -e "[php-fpm-pool-settings]\npm.status_path = /status_phpfpm" > tmpfile && for domain in $(MYSQL_PWD=$(cat /etc/psa/.psa.shadow) mysql -uadmin -Nse "SELECT name FROM psa.domains WHERE htype = 'vrt_hst'"); do plesk bin site --update-php-settings $domain -additional-settings tmpfile; done && rm -f tmpfile

5. Adjust the 360 Monitoring agent settings:

   # echo -en "[phpfpm]\nenabled = yes\nstatus_page_url =" > tmpconffile && for domain in $(MYSQL_PWD=$(cat /etc/psa/.psa.shadow) mysql -uadmin -Nse "SELECT name FROM psa.domains WHERE htype = 'vrt_hst'"); do echo -n " https://$domain/status_phpfpm?json," >> tmpconffile; done && sed -i '$ s/.$//' tmpconffile && cat tmpconffile >> /etc/agent360.ini && rm -f tmpconffile

6. Apply the web configuration:

   # plesk repair web -y

7. Restart the agent:

   # systemctl restart agent360

1. Connect to the server via SSH

2. Download the script:

   # wget https://plesk.zendesk.com/hc/article_attachments/4418181127570/360_phpfpm_plugin_conf.py

3. Make it executable:

   # chmod +x 360_phpfpm_plugin_conf.py

4. Execute the script:

   # ./360_phpfpm_plugin_conf.py

   ---

   If the following error appears:

   CONFIG_TEXT: /usr/bin/env: 'python': No such file or directory

   Execute the script in this way:

   # python3 360_phpfpm_plugin_conf.py

5. Apply the web configuration:

   # plesk repair web -y