Aller au contenu principal

Veritas Backup Exec NSCP Rest API

Contenu du Pack​

Modèles​

Le Pack Veritas Backup Exec apporte un modèle d'hôte :

  • App-Backupexec-Nscp-Restapi-custom

Il apporte les modèles de service suivants :

AliasModèle de serviceDéfautDécouverte
AlertsApp-Backupexec-Alerts-Nscp-RestapiX
DisksApp-Backupexec-Disks-Nscp-RestapiXX
JobsApp-Backupexec-Jobs-Nscp-RestapiX

Règles de découverte​

Nom de la règleDescription
App-Backupexec-Nscp-Restapi-Disk-NameDécouvre les disques et supervise le statut et l'utilisation

Métriques & statuts collectés​

Metric nameDescriptionUnit
alerts.severity.none.countNumber of alerts with none severity
alerts.severity.question.countNumber of alerts with question severity
alerts.severity.error.countNumber of alerts with error severity
alerts.severity.warning.countNumber of alerts with warning severity
alerts.severity.information.countNumber of alerts with informational severity
alert statusCurrent alert status

Prérequis​

NSClient Configuration​

Pour superviser un Backup Exec de Veritas via NRPE, installez la version packagée Centreon de l'agent NSClient++. Suivez notre documentation officielle

Veuillez télécharger et installer la dernière version en date de Centreon-NSClient-xxx.exe: https://github.com/centreon/centreon-nsclient-build/releases

Par défaut, l'utilisateur centreon avec le mot de passe centreon est utilisé pour se connecter à NSClient.

Flux réseau​

La communication doit être possible sur le port TCP 8443 depuis le collecteur Centreon vers l'équipement supervisé.

Installation​

  1. Installez le plugin Centreon sur tous les collecteurs Centreon devant superviser des resources Veritas Backup Exec NSCP API :
yum install centreon-plugin-Applications-Protocol-Nrpe
  1. Sur l'interface web de Centreon, installez le Pack Veritas Backup Exec NSCP API 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 et IP Address / DNS correspondant à votre serveur Veritas Backup Exec.
  • Appliquez le modèle d'hôte App-Backupexec-Nscp-Restapi-custom.
  • Une fois le modèle appliqué, les macros ci-dessous indiquées comme requises (Obligatoire) doivent être renseignées.

Une fois celui-ci configuré, certaines macros doivent être renseignées:

ObligatoireNomDescription
NSCPRESTAPIPORTPort used (Default: 8443)
NSCPRESTAPIPROTOProtocol used (Default: https)
NSCPRESTAPIUSERNAMENSClient API username
NSCPRESTAPIPASSWORDNSClient API password
NSCPRESTAPILEGACYPASSWORDNSClient API legacy authentication password
NSCPRESTAPIEXTRAOPTIONSAny extra option you may want to add to the command (eg. a --insecure)
BEMCLIFILEPowershell module file (Default: C:/Program Files/Veritas/Backup Exec/Modules/BEMCLI/bemcli)

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

Une fois le plugin installé, vous pouvez tester la bonne configuration NSClient directement en ligne de commande depuis votre collecteur Centreon en vous connectant avec l'utilisateur centreon-engine :

/usr/lib/centreon/plugins/centreon_protocol_nrpe.pl \
    --plugin=apps::protocols::nrpe::plugin \
    --mode=query \
    --custommode=nsclient \
    --hostname='10.0.0.1' \
    --username=centreon \
    --password=centreon \
    --insecure \
    --http-backend=curl \
    --command=check_version

La commande devrait retourner un message de sortie similaire à :

0.5.2.41 2018-04-26

Vous pouvez maintenant tester le plugin Backup Exec :

/usr/lib/centreon/plugins/centreon_protocol_nrpe.pl \
    --plugin=apps::protocols::nrpe::plugin \
    --mode=query \
    --custommode=nsclient \
    --hostname='10.0.0.1' \
    --username=centreon \
    --password=centreon \
    --insecure \
    --http-backend=curl \
    --command=check_centreon_plugins \
    --arg='apps::backup::backupexec::local::plugin' \
    --arg='disks' \
    --arg='--filter-name="" --verbose' \
    --verbose

La commande devrait retourner un message de sortie similaire à :

OK: All disks are ok | 'disk 1#disk.space.usage.bytes'=1000000B;;;0;100000000 'disk 1#disk.space.free.bytes'=99000000B;;;0;100000000 'disk 1#disk.space.usage.percentage'=1.00%;;;0;100 'disk 2#disk.space.usage.bytes'=1000000B;;;0;250000000 'disk 2#disk.space.free.bytes'=249000000B;;;0;250000000 'disk 2#disk.space.usage.percentage'=0.40%;;;0;100
checking disk 'disk 1' [type: tapeDriveDevice]
    status: enabled
    space usage total: 95.37 MB used: 976.56 KB (1.00%) free: 94.41 MB (99.00%)
checking disk 'disk 2' [type: deduplicationDiskStorageDevice]
    status: enabled
    space usage total: 238.42 MB used: 976.56 KB (0.40%) free: 237.46 MB (99.60%)

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_protocol_nrpe.pl \
    --plugin=apps::protocols::nrpe::plugin \
    --mode=query \
    --custommode=nsclient \
    --hostname='10.0.0.1' \
    --username=centreon \
    --password=centreon \
    --insecure \
    --http-backend=curl \
    --command=check_centreon_plugins \
    --arg='apps::backup::backupexec::local::plugin' \
    --arg='disks' \
    --arg='--help'

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

/usr/lib/centreon/plugins/centreon_protocol_nrpe.pl \
    --plugin=apps::protocols::nrpe::plugin \
    --mode=query \
    --custommode=nsclient \
    --hostname='10.0.0.1' \
    --username=centreon \
    --password=centreon \
    --insecure \
    --http-backend=curl \
    --command=check_centreon_plugins \
    --arg='apps::backup::backupexec::local::plugin' \
    --arg='xxx' \
    --arg='--list-mode'

Diagnostic des erreurs communes​

Rendez-vous sur la documentation dédiée pour le diagnostic des erreurs communes des plugins Centreon.