Aller au contenu principal

JVM Actuator

Contenu du connecteur de supervision​

Objets supervisés​

Le Pack collecte les données pour:

  • Class
  • Memory
  • System (cpu, load-average, fd)
  • Threads

Métriques collectées​

Metric nameDescriptionUnit
class.loaded.current.countCurrent number of classes loaded
class.unloaded.countNumber of classes unloaded

Prérequis​

Veuiller installer le module Spring Boot Actuator: https://docs.spring.io/spring-boot/docs/current/reference/html/actuator.html Demander à votre administrateur de le déployer et de vous fournir l'adresse.

Installation​

  1. Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Applications-Jvm-Actuator
  1. Sur l'interface Web de Centreon, installer le Pack JVM Actuator depuis la page Configuration > Gestionnaire de connecteurs de supervision

Configuration​

  • Depuis l'interface Web de Centreon, ajoutez un nouvel Hôte depuis la page Configuration > Hôtes.
  • Appliquez le modèle App-Jvm-Actuator-custom et configurez toutes les macros nécessaires:
MandatoryNameDescription
XACTUATORCUSTOMMODECustom mode to get metrics (Default: standard)
XACTUATORAPIPORTPort used (Default: 8080)
XACTUATORAPIPROTOSpecify https if needed (Default: http)
XACTUATORAPIURLPATHApi endpoint (Default: /actuator)
ACTUATORAPIUSERNAMEApi username
ACTUATORAPIPASSWORDApi password
ACTUATORAPIEXTRAOPTIONSAny extra option you may want to add to the command (eg. a --verbose flag)

To monitor centreon-map JVM, please use following macro values:

NameValue
ACTUATORCUSTOMMODEcentreonmap
ACTUATORAPIURLPATH/centreon-studio/api/beta
ACTUATORAPIUSERNAMEApi username must be set
ACTUATORAPIPASSWORDApi password must be set

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 avec l'utilisateur centreon-engine (Les paramètres tels que api-username ou api-password doivront être ajustés):

/usr/lib/centreon/plugins/centreon_jvm_actuator.pl \
--plugin=apps::java::jvm::actuator::plugin \
--custommode=standard \
--mode=class-count \
--hostname='10.30.2.79' \
--port='8080' \
--proto='http' \
--url-path='/actuator'
--verbose

Exemple de sortie:

OK: Class current: 6486, unloaded: 38 | 'class.loaded.current.count'=6486;;;0; 'class.unloaded.count'=38;;;0;

La commande ci-dessus contrôle l'utilisation des classes de la JVM (--mode=class-count). Le Plugin se connecte à l'hôte 10.30.2.79 (--hostname='10.30.2.79') sur le port 8080 (--port='8080') utilisant le protocol http (--proto='http').

Toutes les options et leur utilisation peuvent être consultées avec le paramètre --help ajouté à la commande:

/usr/lib/centreon/plugins/centreon_jvm_actuator.pl \
--plugin=apps::java::jvm::actuator::plugin \
--custommode=standard \
--mode=class-count \
--help

Diagnostique​

Diagnostique des plugins