Présentation

Remarque : cette intégration s’applique uniquement à la version 13 et aux versions ultérieures d’OpenStack (conteneurisées). Pour recueillir des métriques pour les versions 12 et antérieures (non conteneurisées), utilisez l’intégration OpenStack.

Ce check permet de surveiller OpenStack depuis le nœud de contrôleur.

Configuration

Installation

Le check OpenStack Controller est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur votre serveur.

Configuration

L’intégration OpenStack Controller est conçue pour recueillir des informations auprès de tous vos nœuds de calcul ainsi que des serveurs exécutés sur ceux-ci. Elle doit être exécutée à partir d’un seul Agent afin de surveiller votre environnement OpenStack. Ce déploiement peut être effectué sur votre nœud de contrôleur ou sur un serveur adjacent ayant accès aux endpoints Keystone et Nova.

Préparer OpenStack

Créez un utilisateur datadog afin de l’utiliser dans votre fichier openstack_controller.d/conf.yaml. Cet utilisateur doit disposer des autorisations admin en lecture seule sur tout votre environnement : il pourra ainsi être exécuté à partir d’un seul nœud et lire les informations système de haut niveau sur tous vos serveurs et nœuds.

Configuration de l’Agent

1. Modifiez le fichier openstack_controller.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance OpenStack Controller. Consultez le fichier d’exemple openstack_controller.d/conf.yaml pour découvrir toutes les options de configuration disponibles :

   init_config:
   
   instances:
     ## @param name - string - required
     ## Unique identifier for this instance.
     #
     - name: "<INSTANCE_NAME>"
   
       ## @param user - object - required
       ## Password authentication is the only auth method supported
       ## User expects username, password, and user domain id
       ## `user` should resolve to a structure like
       ## {'password': '<PASSWORD>', 'name': '<USER_NAME>', 'domain': {'id': '<DOMAIN_ID>'}}
       ## The check uses the Unscoped token method to collect information about
       ## all available projects to the user.
       #
       user:
         password: "<PASSWORD>"
         name: "<USER_NAME>"
         domain:
           id: "<DOMAIN_ID>"
   

2. Redémarrez l’Agent.

Collecte de logs

1. La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous pouvez l’activer dans datadog.yaml :

   logs_enabled: true
   

2. Ajoutez ce bloc de configuration à votre fichier openstack_controller.d/conf.yaml pour commencer à recueillir vos logs Openstack :

   logs:
     - type: file
       path: "<LOG_FILE_PATH>"
       source: openstack
   

   Modifiez la valeur du paramètre path et configurez-le pour votre environnement. Consultez le fichier d’exemple openstack_controller.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

Validation

Lancez la sous-commande status de l’Agent et cherchez openstack_controller dans la section Checks.

Données collectées

Métriques

Événements

OpenStack Controller n’inclut aucun événement.

Checks de service

openstack.neutron.api.up
Returns CRITICAL if the Agent is unable to query the Neutron API and UNKNOWN if endpoint is not found in the catalog. Returns OK otherwise.
Statuses: ok, critical, unknown

openstack.nova.api.up
Returns CRITICAL if the Agent is unable to query the Nova API and UNKNOWN if endpoint is not found in the catalog Returns OK otherwise.
Statuses: ok, critical, unknown

openstack.keystone.api.up
Returns CRITICAL if the Agent is unable to query the Keystone API and UNKNOWN if endpoint is not found in the catalog. Returns OK otherwise.
Statuses: ok, critical

openstack.ironic.api.up
Returns CRITICAL if the Agent is unable to query the Ironic API and UNKNOWN if endpoint is not found in the catalog. Returns OK otherwise.
Statuses: ok, critical

openstack.cinder.api.up
Returns CRITICAL if the Agent is unable to query the Cinder API and UNKNOWN if endpoint is not found in the catalog. Returns OK otherwise.
Statuses: ok, critical

openstack.octavia.api.up
Returns CRITICAL if the Agent is unable to query the Octavia API and UNKNOWN if endpoint is not found in the catalog. Returns OK otherwise.
Statuses: ok, critical

openstack.glance.api.up
Returns CRITICAL if the Agent is unable to query the Glance API and UNKNOWN if endpoint is not found in the catalog. Returns OK otherwise.
Statuses: ok, critical

openstack.nova.hypervisor.up
Returns UNKNOWN if the Agent is unable to get the Hypervisor state, CRITICAL if the Hypervisor is down. Returns OK otherwise.
Statuses: ok, critical, unknown

openstack.neutron.network.up
Returns UNKNOWN if the Agent is unable to get the Network state, CRITICAL if the Network is down. Returns OK otherwise.
Statuses: ok, critical, unknown

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.