Aller au contenu principal

Amazon Backup Vault

Contenu du Pack​

Modèles​

Le connecteur de supervision Centreon Amazon Backup Vault apporte un modèle d'hôte :

  • Cloud-Aws-Backup-Vault-custom

Il apporte le Modèle de Service suivant :

AliasModèle de serviceDescriptionDéfaut
Backup-Vault-Jobs-StatusCloud-Aws-Backup-Vault-Jobs-Status-ApiContrôle le statut des jobs AWS Backup VaultX

Règles de découverte​

Ce pack propose une règle de découverte d'hôtes permettant de découvrir automatiquement des ressources AWS Backup vault :

image

Vous trouverez plus d'informations sur la découverte d'Hôtes et son fonctionnement sur la documentation du module : Découverte des hôtes

Métriques & statuts collectés​

Metric NameDescription
backup.jobs.completed.countNumber of Backup vault jobs completed for the specified timeframe. Default : last 24h.
backup.jobs.failed.countNumber of Backup vault jobs failed for the specified timeframe. Default : last 24h.
backup.jobs.expired.countNumber of Backup vault jobs expired for the specified timeframe. Default : last 24h.
copy.jobs.completed.countNumber of Copy vault jobs completed for the specified timeframe. Default : last 24h.
copy.jobs.failed.countNumber of Copy vault jobs failed for the specified timeframe. Default : last 24h.
recovery.jobs.expired.countNumber of Recovery vault jobs completed for the specified timeframe. Default : last 24h.

Prérequis​

Privilèges AWS​

Voici la liste des droits nécessaires au travers des access/secret key utilisées pour pouvoir utiliser le monitoring AWS/EC2:

AWS PrivilegeDescription
backup:ListBackupVaultsGet Backup Vault Names.
cloudwatch:getMetricStatisticsGet metrics from the AWS/EC2 namespace on Cloudwatch.

Dépendances du Plugin​

Afin de récupérer les informations nécessaires via les APIs AWS, il est possible d'utiliser soit le binaire awscli fourni par Amazon, soit le SDK Perl paws. Le SDK est recommandé car plus performant.

Attention il n'est pas possible d'utiliser paws si la connexion s'effectue au travers d'un proxy.

yum install perl-Paws

Installation​

  1. Installer le Plugin Centreon sur tous les collecteurs Centreon devant superviser des ressources AWS Backup Vault :
yum install centreon-plugin-Cloud-Aws-Backup-Api
  1. Sur l'interface Web de Centreon, installer le connecteur de supervision Amazon Backup Vault 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 serveur AWS Backup Vault.
  • Appliquez le Modèle d'Hôte Cloud-Aws-Backup-Vault-custom.
  • Une fois le modèle appliqué, les Macros ci-dessous indiquées comme requises (Obligatoire) doivent être renseignées.
MandatoryMacroDescription
XAWSSECRETKEYAWS Secret key of your IAM role. Password checkbox must be checked.
XAWSACESSKEYAWS Access key of your IAM role. Password checkbox must be checked.
XAWSREGIONRegion where the instance is running.
XAWSCUSTOMMODECustom mode to get metrics, 'awscli' is the default, you can also use 'paws' perl library.
XVAULTBACKUPNAMEBackup Vault name containing jobs.
PROXYURLConfigure proxy URL.
EXTRAOPTIONSAny extra option you may want to add to every command_line (eg. a --verbose flag).
DUMMYSTATUSHost state. Default is OK, do not modify it until you know what you are doing.
DUMMYOUTPUTHost check output. Default is 'This is a dummy check'. Customize it with your own if needed.

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 (su - centreon-engine) :

/usr/lib/centreon/plugins//centreon_aws_backup_api.pl \
    --plugin=cloud::aws::backup::plugin \
    --mode=jobstatus \
    --custommode='awscli' \
    --aws-secret-key='' \
    --aws-access-key='' \
    --region='' \
    --backup-vault-name='MY-VAULT' \
    --filter-metric='.*' \
    --proxyurl='' \
    --timeframe='86400' \
    --period='3600'  \
    --zeroed\

La commande devrait retourner un message de sortie similaire à :

OK: 'MY-VAULT' Statistic 'Sum' Metrics Number of backup jobs expired: 0.00 , Number of copy jobs completed: 0.00 , Number of backup jobs failed: 0.00 , Number of backup jobs completed: 4.00 , Number of recovery jobs expired: 0.00 , Number of copy jobs failed: 0.00  | 'MY-VAULT~sum#backup.jobs.expired.count'=0.00;;;0; 'MY-VAULT~sum#copy.jobs.completed.count'=0.00;;;0; 'MY-VAULT~sum#backup.jobs.failed.count'=0.00;;;0; 'MY-VAULT~sum#backup.jobs.completed.count'=4.00;;;0; 'MY-VAULT~sum#recovery.jobs.expired.count'=0.00;;;0; 'MY-VAULT~sum#copy.jobs.failed.count'=0.00;;;0;

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_aws_backup_api.pl \
    --plugin=cloud::aws::backup::plugin \
    --mode=jobstatus \
    --help

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

/usr/lib/centreon/plugins//centreon_aws_backup_api.pl \
    --plugin=cloud::aws::backup::plugin \
    --list-mode

Diagnostic des erreurs communes​

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