Aller au contenu principal

Mulesoft Anypoint

Vue d'ensemble​

Mulesoft offre une plateforme d'intégration la plus utilisée pour connecter les applications SaaS et d'entreprise dans le cloud et/ou on-prem.

Le Plugin Centreon associé permet d'interroger l'API Rest de Mulesoft Anypoint afin de récupérer le statut de diverses ressources Mulesoft.

Contenu du connecteur de supervision​

Objets supervisés​

  • Applications
  • Serveurs
  • Clusters
  • Messages des queues MQ

Règles de découvertes​

Rule nameDescription
App-Mulesoft-Restapi-Application-NameDiscover Anypoint applications and monitor their status
App-Mulesoft-Restapi-Server-NameDiscover Anypoint servers and monitor their status
App-Mulesoft-Restapi-Queue-Messages-NameDiscover Anypoint MQ queues and monitor the related messages count

Métriques collectées​

Vous pouvez vous renseigner en détails sur les métriques présentées ci-après sur la documentation officielle de l'API Rest Mulesoft: https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services/

Metric nameDescription
statusCurrent status of each application
mulesoft.applications.total.countTotal number of applications
mulesoft.applications.status.started.countNumber of started applications
mulesoft.applications.status.stopped.countNumber of stopped applications
mulesoft.applications.status.failed.countNumber of failed applications

Prérequis​

Privilèges API​

Un compte de service est requis pour interroger l'API Mulesoft. Celui-ci doit avoir suffisamment de privilèges en lecture dans l'environnement et l'organisation Anypoint ciblées. Ce compte doit également être en mesure d'accéder aux Applications, Serveurs, Clusters et services MQ de l'environnement et de l'organisation en question.

Installation​

  1. Installer le Plugin sur tous les collecteurs Centreon supervisant des ressources Mulesoft Anypoint :
yum install centreon-plugin-Applications-Mulesoft-Restapi.noarch
  1. Sur l'interface Web de Centreon, installer le connecteur de supervision Mulesoft Anypoint depuis la page Configuration > Gestionnaire de connecteurs de supervision

Configuration​

Host​

Ce connecteur de supervision est concçu de manière à avoir dans Centreon un hôte par environnement/organisation Lorsque vous ajoutez un hôte à Centreon, appliquez-lui le modèle App-Mulesoft-Restapi-custom. Une fois celui-ci configuré, certaines macros doivent être renseignées:

MandatoryNameDescription
XENVIDMulesoft Environment ID fetched from the Mulesoft Web console
XORGIDMulesoft Organization ID fetched from the Mulesoft Web console
(X)REGIONIDMulesoft MQ region ID to use (only mandatory for messages mode)
XAPIUSERNAMEAPI username
XAPIPASSWORDAPI password (password type should be ticked)

FAQ​

Comment tester un contrôle en ligne de commandes et que signifient les options principales ?​

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

/usr/lib/centreon/plugins/centreon_mulesoft_restapi.pl \
    --plugin=apps::mulesoft::restapi::plugin \
    --mode=applications \
    --environment-id='1234abc-56de-78fg-90hi-1234abcdefg' \
    --organization-id='1234abcd-56ef-78fg-90hi-1234abcdefg' \
    --api-username='myapiuser' \
    --api-password='myapipassword' \
    --filter-name='myapplication1' \
    --warning-status='%{status} =~ /STOPPED/' \
    --critical-status='%{status} =~ /FAILED/' \
    --verbose
    

OK: Total applications Total : 1, Started : 1, Stopped : 0, Failed : 0 - Application 'myapplication1' Id: 123456, Status: STARTED |
'mulesoft.applications.total.count'=1;;;0; 'mulesoft.applications.status.started.count'=1;;;0; 'mulesoft.applications.status.stopped.count'=0;;;0; 'mulesoft.applications.status.failed.count'=0;;;0;
Application 'myapplication1' Id: 123456, Status: STARTED

La commande ci-dessus contrôle le statut d'une application Mulesoft (--mode=applications) nommée myapplication1 (--filter-name='myapplication1'). The command above gets the status of a Mulesoft application (--mode=applications) named myapplication1 (--filter-name='myapplication1'). Cette application appartient à l'environnement 1234abc-56de-78fg-90hi-1234abcdefg de l'organisation 234abcd-56ef-78fg-90hi-1234abcdefg ---environment-id='1234abc-56de-78fg-90hi-1234abcdefg' --organization-id='1234abcd-56ef-78fg-90hi-1234abcdefg').

Cette commande déclenchera une alarme WARNING si le statut de l'application contient le mot STOPPED (--warning-status='%{status} =~ /STOPPED/') et une alarme CRITICAL s'il contient le mot FAILED (--critical-status='%{status} =~ /FAILED/').

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

/usr/lib/centreon/plugins/centreon_mulesoft_restapi.pl --plugin=apps::mulesoft::restapi::plugin --mode=applications --help

Comment puis-je supprimer les perfdatas count dans le cas où je ne souhaite vérifier qu'une seule application ?​

Le Plugin permet de filtrer sur un ou plusieurs éléments mais permet également de récupérer l'ensemble des éléments si aucun filtre n'est spécifié. De ce fait, des perfdatas "globales" sur les statistiques des objets sont ajoutées par défaut. Il est possible de supprimer ces données de performance en appliquant le filtre suivant: --filter-perfdata='^$'.