Aller au contenu principal

Azure Container Registry

Vue d'ensemble​

Azure Container Registry est un service de registre Docker managé privé, qui est basé sur le registre open source Docker 2.0. Il permet de créer et de tenir à jour des registres de conteneurs Azure pour stocker et gérer des images conteneur Docker privées et les artefacts associés.

Le Plugin Centreon Azure Container Registry s'appuie sur les API Azure Monitor afin de récupérer les métriques relatives au service Container Registry.

Il est possible d'utiliser les 2 modes de connexion aux API Azure proposés par Microsoft: RestAPI ou Azure CLI.

Contenu du Pack​

Objets supervisés​

  • Registries
    • Storage-usage

Règles de découverte​

Le connecteur de supervision Centreon Azure Container Registry inclut un fournisseur de découverte d'Hôtes nommé Microsoft Azure Container Registry. Celui-ci permet de découvrir l'ensemble des instances rattachées à une souscription Microsoft Azure donnée:

image

La découverte Azure Container Registry n'est compatible qu'avec le mode 'api'. Le mode 'azcli' n'est pas supporté dans le cadre de cette utilisation. 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​

Metric NameDescriptionUnit
instance#azure.containerregistry.storage.used.bytesStorage usedB

Prérequis​

Rendez-vous sur la documentation dédiée afin d'obtenir les prérequis nécessaires pour interroger les API d'Azure.

Installation​

  1. Installer le Plugin sur tous les collecteurs Centreon devant superviser des resources Azure Container Registry:
yum install centreon-plugin-Cloud-Azure-Storage-ContainerRegistry-Api
  1. Sur l'interface Web Centreon, installer le Pack Azure Container Registry depuis la page Configuration > Gestionnaire de connecteurs de supervision.

Configuration​

Hôte​

  • Ajoutez un Hôte à Centreon, remplissez le champ Adresse IP/DNS avec l'adresse 127.0.0.1 et appliquez-lui le Modèle d'Hôte Cloud-Azure-Storage-ContainerRegistry-custom.
  • Une fois le modèle appliqué, les Macros ci-dessous indiquées comme requises (Mandatory) doivent être renseignées selon le custom mode utilisé.

Deux méthodes peuvent être utilisées lors de l'assignation des Macros:

  • Utilisation de l'ID complet de la ressource (de type /subscriptions/<subscription_id>/resourceGroups/<resourcegroup_id>/providers/Microsoft.ContainerRegistry/registries/<resource_name>) dans la Macro AZURERESOURCE
  • Utilisation du nom de la ressource dans la Macro AZURERESOURCE associée à la Macro AZURERESOURCEGROUP
MandatoryNomDescription
XAZURECUSTOMMODECustom mode 'api'
XAZURESUBSCRIPTIONSubscription ID
XAZURETENANTTenant ID
XAZURECLIENTIDClient ID
XAZURECLIENTSECRETClient secret
XAZURERESOURCEID or name of the Container Registry resource
AZURERESOURCEGROUPAssociated Resource Group if resource name is used

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 votre collecteur Centreon en vous connectant avec l'utilisateur centreon-engine (#su - centreon-engine):

/usr/lib/centreon/plugins/centreon_azure_storage_acr_api.pl \
    --plugin=cloud::azure::storage::acr::plugin \
    --mode=storage-usage \
    --custommode='api' \
    --subscription='xxxxxxxxx' \
    --tenant='xxxxxxxxx' \
    --client-id='xxxxxxxxx' \
    --client-secret='xxxxxxxxx' \
    --resource='ACR001ABCD' \
    --resource-group='RSG1234'
    --aggregation='Total' \
    --timeframe='3600' \
    --interval='PT1H' \
    --warning-storage-used='80000000000' \
    --critical-item-errors='90000000000'

La commande devrait retourner un message de sortie similaire à: 

OK: Instance 'ACR001ABCD' Statistic 'total' Metrics Storage used: 74.86GB |
'ACR001ABCD~total#azure.containerregistry.storage.used.bytes'=80379853954.00B;0:70000000000;0:90000000000;0;

La commande ci-dessus vérifie l'état du stockage dédié à l'instance Container Registry nommée ACR001ABCD (--plugin=cloud::azure::storage::acr::plugin --mode=storage-usage --resource='ACR001ABCD') et liée au Resource Group RSG1234 (--resource-group='RSG1234').

Le mode de connexion utilisé est 'api' (--custommode=api), les paramètres d'authentification nécessaires à l'utilisation de ce mode sont donc renseignés en fonction (--subscription='xxxxxxxxx' --tenant='xxxxxxx' --client-id='xxxxxxxx' --client-secret='xxxxxxxxxx').

Les valeurs obtenus sont le résultat de la récupération d'un point unique sur une période d'une heure / 3600 secondes. (--timeframe='3600' --interval='PT1H').

Dans cet exemple, une alarme de type WARNING sera déclenchée lorsque le stockage utilisé est supérieur à 80GB (--warning-storage-used='80000000000'); l'alarme sera de type CRITICAL au-delà de 90GB d'utilisation (--critical-storage-used='90000000000').

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_azure_storage_acr_api.pl \
    --plugin=cloud::azure::storage::acr::plugin \
    --mode=storage-usage  \
    --help

Diagnostic des erreurs communes​

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