Ansible

Crawler

Overview

Install the Datadog Ansible callback integration to:

• Get real-time reports on Ansible server runs
• Track key Ansible performance metrics across all your servers
• Quickly identify and discuss failed Ansible runs with your team

For more information about using Datadog integrations with Ansible, read the blog post Ansible + Datadog: Monitor your automation, automate your monitoring.

Setup

Installation

1. Ensure the prerequisite python libraries are installed on the server:

   • datadogpy
   • pyyaml (install with pip install pyyaml)
   • For Mac OS X users: If you’re running OS-installed python 2.7.10 or below, upgrade to a newer version of OpenSSL - pip install pyopenssl idna

2. Clone the ansible-datadog-callback GitHub repo.

3. Copy datadog_callback.py to your playbook callback directory (by default callback_plugins/ in your playbook’s root directory). Create the directory if it doesn’t exist.

4. Create a datadog_callback.yml file alongside datadog_callback.py, and set its contents with your API key, as following:

   ```yaml
   api_key: <YOUR_DATADOG_API_KEY>
   ```

5. You should start seeing Ansible events and metrics appear on Datadog when your playbook is run.

To install the Datadog Agent using Ansible, refer to the installation documentation here.

Log Collection

Refer to the playbook example to learn how to install the Datadog Agent with Log collection enabled using Ansible.

Data Collected

Metrics

Events

The Ansible integration does not include any events.

Service Checks

The Ansible integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.