Aller au contenu principal

Google Storage

Contenu du connecteur de supervision​

Objets supervisés​

Le connecteur de supervision Google Storage collecte les données pour:

  • Bucket

Règles de découverte​

Le connecteur de supervision Centreon Google Storage inclut un provider de découverte d'Hôtes. Celui-ci permet de découvrir l'ensemble des supports de stockage associés à un projet GCP donné:

image

Le fichier key doit être déployé sur les Collecteurs utilisés pour la découverte en amont de son execution (voir chapitre Prérequis)

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 collectées​

Pour l'ensemble des métriques collectées, il est possible de choisir aggregation: average, minimum, maximum et total.

Metric nameDescriptionUnit
bucket_name~aggregation#storage.bucket.objects.countNumber of objects
bucket_name~aggregation#storage.network.received.volume.bytesCount of bytes received over the networkB
bucket_name~aggregation#storage.network.received.volume.bytespersecondCount of bytes received per second over the networkB/s
bucket_name~aggregation#storage.network.sent.volume.bytesCount of bytes sent over the networkB
bucket_name~aggregation#storage.network.sent.volume.bytespersecondCount of bytes sent per second over the networkB/s

Prérequis​

Privilèges Google Cloud​

Créer une clé de compte de service (télécharger sa clé privée sous la forme d'un fichier JSON) avec les privilèges suivants:

Google ScopeDescription
https://www.googleapis.com/auth/cloud-platformView and manage your data across Google Cloud Platform services

Comment créer une clé de compte de service: https://developers.google.com/identity/protocols/oauth2/service-account

Installation​

  1. Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Cloud-Gcp-Storage-Api
  1. Sur l'interface Web de Centreon, installer le connecteur de supervision Google Storage depuis la page Configuration > Gestionnaire de connecteurs de supervision

Configuration​

Ce connecteur de supervision est conçu de manière à avoir dans Centreon un hôte par bucket Google Storage. Lorsque vous ajoutez un hôte à Centreon, appliquez-lui le modèle Cloud-Gcp-Storage-custom. Une fois celui-ci configuré, certaines macros doivent être renseignées:

MandatoryNameDescription
XGCPKEYFILEPATHService account key json file
XGCPSCOPEENDPOINTGoogle Scope. Default: https://www.googleapis.com/auth/cloud-platform
XGCPDIMENSIONNAMEThe name of the dimension to filter on. Default: resource.labels.bucket_name
XGCPDIMENSIONOPERATORDefine the type of filter match to use. Default: equals
XGCPDIMENSIONVALUEName of the bucket you want to monitor.
PROXYURLConfigure proxy URL
GCPEXTRAOPTIONSAny 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

WARNING: La clé de service (format json) doit être hébergée sur le collecteur Centreon. L'utilisateur centreon-engine doit avoir les droits en lecture sur ce fichier.

FAQ​

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 un collecteur Centreon en vous connectant avec l'utilisateur centreon-engine:

/usr/lib/centreon/plugins/centreon_gcp_storage_api.pl \
    --plugin=cloud::google::gcp::storage::plugin \
    --mode=bucket \
    --key-file=/var/lib/centreon-engine/centreon-dev-6e5531fc9e82.json \
    --dimension-name='resource.labels.bucket_name' \
    --dimension-operator='equals' \
    --dimension-value='centreon-dev.appspot.com' \
    --aggregation='average' \
    --warning-bucket-objects='1000' \
    --critical-bucket-objects='2000' \
    --verbose

La commande devrait retourner un message de sortie de la forme ci-dessous:

OK: Instance 'centreon-dev.appspot.com' aggregation 'average' metrics objects: 0.00, received: 0.00 B, sent: 382.00 B | 'centreon-dev.appspot.com~average#storage.bucket.objects.count'=0.00;0:1000;0:2000;0; 'centreon-dev.appspot.com~average#storage.network.received.volume.bytes'=0.00B;;;0; 'centreon-dev.appspot.com~average#storage.network.sent.volume.bytes'=382.00B;;;0;
Checking 'centreon-dev.appspot.com'
    aggregation 'average' metrics objects: 0.00, received: 0.00 B, sent: 382.00 B

Cette commande contrĂ´le l'utilisation (--mode=bucket) d'une bucket Google Storage ayant pour nom centreon-dev.appspot.com (--dimension-name='resource.labels.bucket_name' --dimension-operator='equals' --dimension-value='centreon-dev.appspot.com').

Cette commande déclenchera une alarme WARNING si le nombre d'objets est supérieur à 1000 (--warning-bucket-objects='1000') et une alarme CRITICAL si supérieur à 2000 (--critical-bucket-objects='2000').

Pour chaque mode, la liste de toutes les métriques, seuils associés et options complémentaires peut être affichée en ajoutant le paramètre --help à la commande:

/usr/lib/centreon/plugins/centreon_gcp_storage_api.pl \
    --plugin=cloud::google::gcp::storage::plugin \
    --mode=bucket \
    --help

J'obtiens le message d'erreur suivant: UNKNOWN: No metrics. Check your options or use --zeroed option to set 0 on undefined values​

Lors du déploiement de mes contrôles, j'obtiens le message suivant 'UNKNOWN: No metrics. Check your options or use --zeroed option to set 0 on undefined values'.

Cela signifie qu'il n'y a pas de données sur la période.

Vous pouvez ajouter --zeroed Ă  la macro EXTRAOPTIONS du service en question afin de forcer le stockage d'un 0 et ainsi Ă©viter un statut UNKNOWN.