Aller au contenu principal

AWS Discover

Vue d'ensemble​

Le connecteur de supervision Centreon AWS Discover permet de découvrir les resources AWS suivantes :

  • API Gateway
  • Backup Vault
  • EBS
  • EC2
  • EFS
  • FSx
  • Kinesis
  • Lamba
  • RDS
  • S3
  • SNS
  • SQS
  • VPN

Ce pack s'appuie sur l'API d'AWS pour récupérer les ressources AWS et sur tous les connecteurs de supervision Centreon pour AWS afin de définir des modèles et des indicateurs de surveillance appropriés pour chaque type de ressource.

Contenu du connecteur de supervision​

Le connecteur de supervision AWS Discover est un pack de découverte. Il ne fournit pas de modèles ni d'indicateurs de supervision.

Règles de découverte​

Le connecteur de supervision Centreon AWS Discover fournit un provider de découverte d'hôtes nommé AWS Discover

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

Prérequis

Privilèges AWS​

Voici la liste des droits nécessaires pour pouvoir découvrir les ressources avec Centreon :

AWS Privilege
apigateway:GetRestApis
backup:ListBackupVaults
ec2:DescribeVolumes
ec2:DescribeInstances
ec2:DescribeSpotFleetRequests
ec2:DescribeVpnConnections
efs:DescribeFileSystems
elb:DescribeLoadBalancers
elbv2DdescribeLoadBalancers
fsx:DescribeFileSystems
kinesis:ListStreams
lambda:ListFunctions
rds:DescribeDBInstances
s3api:ListBuckets
sns:ListTopics
sqs:ListQueues
cloudwatch:listMetrics
cloudwatch:getMetricStatistics

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. Installez le plugin sur tous les collecteurs Centreon devant découvrir des ressources AWS :
yum install centreon-plugin-Cloud-Aws-Cloudwatch-Api
  1. Sur l'interface web de Centreon, installez le connecteur de supervision AWS Discover depuis la page Configuration > Packs de plugins. Des connecteurs de supervision supplémentaires seront installés en dépendance afin de permettre la supervision de l'ensemble des ressources découvertes.

Paramétrer une découverte​

Le descriptif du fonctionnement général de la fonctionnalité Host Discovery est disponible ici

Paramètres d'accès​

Après avoir sélectionné le provider AWS Discover, renseignez les paramètres d'authentification ainsi que les options d'accès à l'API comme ci-après si besoin :

image

  • SĂ©lectionnez le collecteur Centreon depuis lequel sera lancĂ© la dĂ©couverte
  • Renseignez les paramètres relatifs Ă  l'utilisation d'un proxy d'entreprise si besoin
  • SĂ©lectionnez le profil d'authentification AWS Ă  utiliser si besoin

Dans le cadre d'une première utilisation avec le profil d'authentification, vous pouvez en créer un nouveau en cliquant sur '+'. Renseignez ensuite les informations demandées comme ci-après :

image

Tous les champs du formulaire credentials doivent être renseignés

Cliquez sur confirm puis sur suivant pour afficher la page des paramètres de la découverte.

Paramètres de découverte​

Renseignez si besoin les informations ci-après :

image

  • AWS Region : RĂ©gion oĂą sont prĂ©sentes les ressources AWS Ă  dĂ©couvrir (obligatoire)
  • AWS Assume Role : Role ARN Ă  utiliser si le profile d'authentification AWS n'est pas Ă  utilisĂ©

Lancement de la découverte et affichage des résultats​

L'étape 4 permet d'ajuster les modificateurs; ceux-ci sont déjà prédéfinis par le connecteur de supervision, il n'est normalement pas nécessaire de les modifier dans le cadre d'un job de découverte standard. Si besoin, référez-vous à la documentation des modificateurs.

Les étapes 5 & 6 permettent d'ajuster la politique de modélisation des résultats si besoin. Rendez-vous ici pour plus d'informations.

Une fois la découverte terminé, vous pouvez afficher les résultats en cliquant sur job results. Les modèles relatifs aux types de resources AWS sont automatiquement appliqués:

image

Certains éléments découverts peuvent ne pas avoir de modèle appliqué dans la liste des résultats si les conditions appliquées aux modificateurs ne peuvent s'appliquer

Sélectionnez les éléments que vous voulez ajouter dans Centreon et Sauvegardez.

Diagnostic des erreurs communes​

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