PHP-FPM

·

PHP-FPM collector is used for PHP-FPM metrics collection, such as the number of active processes, total number of idle processes, the number of requests in the queue of pending connections, the maximum number of active processes, etc.

Configuration¶

Preconditions¶

1. Enable PHP-FPM status page

   • Edit the PHP-FPM configuration file(typically located at /etc/php/8.x/fpm/pool.d/www.conf or /etc/php-fpm.d/www.conf ). Enable pm.status_path :

   shell ; Enable status page pm.status_path = /status

   • Restart PHP-FPM

shell sudo systemctl restart php-fpm sudo systemctl restart php8.x-fpm

1. Configure Web Server

   • Nginx example：

   location /status {
       include fastcgi_params;
       fastcgi_pass unix:/var/run/php/php8.x-fpm.sock; // unix socket mode
       # fastcgi_pass 127.0.0.1:9000; // TCP mode
       fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
   }
   

   • Restart Nginx:

   sudo systemctl restart nginx
   

   • Access the status page( /status ) to ensure it returns PHP-FPM status data correctly

Collector Configuration¶

[[inputs.phpfpm]]
  ##(optional) collect interval, default is 10 seconds
  interval = '10s'

  ## URL to fetch PHP-FPM pool metrics. Defaults to HTTP (e.g., http://localhost/status).
  ## For TCP (e.g., tcp://127.0.0.1:9000/status) or Unix socket (e.g., unix:///run/php/php-fpm.sock;/status),
  ## set use_fastcgi to true.
  status_url = "http://localhost/status"

  ## (optional) use fastcgi, default is false (use http)
  use_fastcgi = false

  ## Set true to enable election
  election = true

  [inputs.phpfpm.tags]
    # some_tag = "some_value"
    # more_tag = "some_other_value"

Metric¶

For all of the following data collections, the global election tags will added automatically, we can add extra tags in [inputs.phpfpm.tags] if needed:

 [inputs.phpfpm.tags]
  # some_tag = "some_value"
  # more_tag = "some_other_value"
  # ...

phpfpm¶