Aller au contenu principal

PHP FPM

Contenu du Pack

Modèles

Le Plugin Pack Centreon PHP FPM apporte 1 modèle d'hôte :

  • App-Php-Fpm-Web

Il apporte le Modèle de Service suivant :

Service AliasService TemplateDefault
Php-Fpm-UsageApp-Php-Fpm-Usage-WebX

Métriques & statuts collectés

Metric nameDescriptionUnit
fpm.processes.active.countNumber of active processescount
fpm.processes.idle.countNumber of idle processescount
fpm.queue.listen.countNumber of connections in the listen queuecount
fpm.requests.persecondNumber of requests per seconds/s

Prérequis

La page Web PHP FPM doit être joignable depuis le collecteur Centreon sur le port spécifié dans la Macro d'Hôte PHPFPMWEBPORT. Plus d'information sur les Macros d'Hôte dans la partie Configuration.

Installation

  1. Installer le Plugin Centreon sur tous les collecteurs Centreon devant superviser des resources PHP FPM:
yum install centreon-plugin-Applications-Php-Fpm-Web
  1. Sur l'interface Web de Centreon, installer le Plugin Pack PHP FPM depuis la page Configuration > Packs de plugins

Configuration

Hôte

  • Ajoutez un Hôte à Centreon depuis la page Configuration > Hôtes.
  • Complétez les champs "Nom","Alias" & "IP Address / DNS" correspondant à votre ressources PHP FPM
  • Appliquez le Modèle d'Hôte Applications-Php-Fpm-Web-custom
  • Une fois le modèle appliqué, les Macros ci-dessous indiquées comme requises(Mandatory) doivent être renseignées
MandatoryNameDescription
PHPFPMWEBPORT(Default: '80')
PHPFPMWEBPROTO(Default: 'http')
PHPFPMWEBURLPATH(Default: '/fpm-status')
EXTRAOPTIONS(Default: 'Any extra option you may want to add to every command_line (eg. a --verbose flag)')

Comment puis-je tester le Plugin et que signifient les options des commandes ?

Une fois le Plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis votre collecteur Centreon en vous connectant avec l'utilisateur centreon-engine:

/usr/lib/centreon/plugins//centreon_php_fpm_web.pl \
--plugin=apps::php::fpm::web::plugin \
--mode=usage \
--hostname=10.0.0.1 \
--proto='http' \
--port='80' \
--urlpath='/fpm-status' \
--warning-active-processes='30' \
--critical-active-processes='35' \
--warning-idle-processes='' \
--critical-idle-processes='' \
--warning-listen-queue='' \
--critical-listen-queue='' \
--warning-requests='' \
--critical-requests='' \
--use-new-perfdata

La commande devrait retourner un message de sortie similaire à :

OK : active processes: 8 (40%) idle processes: 12 (60%) listen queue: 2 requests: 90/s | 'fpm.processes.active.count'=8;30;35;0; 'fpm.processes.idle.count'=12;;;0; 'fpm.queue.listen.count'=2;;;0; 'fpm.requests.persecond'=90/s;;;0; 

Dans cet exemple, une alarme de type WARNING sera déclenchée si le nombre de processus est supérieure à 30 (--warning-active-processes='30'); l'alarme sera de type CRITICAL au-delà de 35.

La liste de toutes les options complémentaires et leur signification peut être affichée en ajoutant le paramètre --help à la commande:

/usr/lib/centreon/plugins//centreon_php_fpm_web.pl \
--plugin=apps::php::fpm::web::plugin \
--mode=usage \
--help

Tous les modes disponibles peuvent être affichés en ajoutant le paramètre --list-mode à la commande:

/usr/lib/centreon/plugins//centreon_php_fpm_web.pl \
--plugin=apps::php::fpm::web::plugin \
--list-mode

Diagnostic des erreurs communes

Rendez-vous sur la documentation dédiée pour le diagnostique des erreurs commununes des Plugins Centreon.