Aller au contenu principal

AWS Billing

Contenu du Pack​

Modèles​

Le connecteur de supervision Centreon AWS Billing apporte un modèle d'hôte :

  • Cloud-Aws-Billing-custom

Il apporte le modèle de service suivant :

AliasModèle de serviceDescriptionDéfaut
Billing-Estimated-ChargesCloud-Aws-Billing-Estimated-Charges-ApiContrôle les coûts générés pour un service.X

Règles de découverte​

Le connecteur de supervision Centreon AWS Billing inclut un fournisseur de découverte d'hôtes nommé Amazon Billing. Celui-ci permet de découvrir l'ensemble des services générant des coûts :

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
billing.estimatedcharges.usdCheck Billing estimated charges for a service.

Prérequis​

Privilèges AWS​

Voici la liste des droits nécessaires au travers des access/secret key utilisées permettant d'utiliser ce pack :

AWS PermissionDescription
cloudwatch:ListMetricsGet all services generating charges.
cloudwatch:getMetricStatisticsGet metrics from the AWS/Billing 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. Installez le plugin sur tous les collecteurs Centreon devant superviser les coûts générés par un ou des services AWS :
yum install centreon-plugin-Cloud-Aws-Billing-Api
  1. Sur l'interface web de Centreon, installez le connecteur de supervision AWS Billing depuis la page Configuration > Packs de plugins.

Configuration​

Hôte​

  • Ajoutez un hôte à Centreon depuis la page Configuration > Hôtes.
  • Remplissez le champ Adresse IP/DNS avec l'adresse 127.0.0.1.
  • Appliquez le modèle d'hôte Cloud-Aws-Billing-custom.
  • Une fois le modèle appliqué, renseignez les macros correspondantes. Attention, certaines macros sont obligatoires. Elles doivent être renseignées selon le custom mode utilisé.
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.
XAWSREGIONMust be 'us-east-1'.
XAWSCUSTOMMODECustom mode to get metrics, 'awscli' is the default, you can also use 'paws' perl library.
XSERVICENAMEBilled AWS service name.
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_billing_api.pl \
--plugin=cloud::aws::billing::plugin \
--mode=estimated-charges \
--custommode='awscli' \
--region=us-east-1 \
--aws-secret-key='xxx' \
--aws-access-key='xxx' \
--service='AWSBackup' \
--warning-billing='' \
--critical-billing='' \

La commande devrait retourner un message de sortie similaire à :

OK: Service 'AWSBackup' Estimated Charges: 0.85 USD | 'AWSBackup#billing.estimatedcharges.usd'=0.85USD;;;;

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_billing_api.pl \
--plugin=cloud::aws::billing::plugin \
--mode=estimated-charges \
--help

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

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

Diagnostic des erreurs communes​

Rendez-vous sur la documentation dédiée des plugins basés sur HTTP/API.