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
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
.
Dupliquez le référentiel GitHub ansible-datadog-callback.
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.
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>
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.