Ansible

Crawler Crawler
docs>integrations>Ansible
Dashboard Ansible

Présentation

Installez l’intégration de rappel Datadog/Ansible pour :

  • Obtenir des rapports en temps réel sur les exécutions de serveur Ansible
  • Surveiller des métriques clés de performance d’Ansible sur tous vos serveurs
  • Identifier rapidement les exécutions Ansible ayant échoué et en discuter avec votre équipe

Pour obtenir davantage d’informations sur l’utilisation des intégrations Datadog avec Ansible, lisez l’article de blog Ansible et Datadog : surveillez votre automatisation et automatisez votre surveillance (en anglais).

Configuration

Installation

  1. Assurez-vous que les bibliothèques Python pré-requises sont installées sur le serveur :

    • datadogpy
    • pyyaml (installer avec pip install pyyaml)
    • Pour les utilisateurs Mac OS X : si vous utilisez la version 2.7.10 ou une version antérieure de Python installée sur l’OS, installez une version plus récente d’OpenSSL avec pip install pyopenssl idna.

  2. Dupliquez le référentiel GitHub ansible-datadog-callback.

  3. Copiez datadog_callback.py dans votre répertoire de rappel de playbook (par défaut, callback_plugins/ dans le répertoire racine de votre playbook). Créez ce répertoire s’il n’existe pas.

  4. Créez un fichier datadog_callback.yml dans le même répertoire que datadog_callback.py et définissez son contenu avec votre clé d’API tel que suit :

     api_key: <VOTRE_CLÉ_API_DATADOG>

  5. Les événements et les métriques Ansible apparaissent dans Datadog après l’exécution de votre playbook.

Pour installer l’Agent Datadog en utilisant Ansible, consultez les instructions d’installation de l’Agent.

Collecte de logs

Consultez l’exemple de playbook pour découvrir comment installer l’Agent Datadog en activant la collecte de logs via Ansible.

Données collectées

Métriques

ansible.elapsed_time
(gauge)		Time taken to execute a playbook
Shown as second
ansible.task.ok
(gauge)		Number of tasks that did not require any change
Shown as task
ansible.task.failures
(gauge)		Number of tasks that failed
Shown as task
ansible.task.skipped
(gauge)		Number of tasks that got skipped
Shown as task
ansible.task.unreachable
(gauge)		Number of tasks for which nodes were unreachable
Shown as task
ansible.task.changed
(gauge)		Number of tasks that successfully applied changes
Shown as task

Événements

L’intégration ansible-datadog-callback capture les événements Ansible issus des exécutions de votre playbook.

Checks de service

L’intégration Ansible n’inclut aucun check de service.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.