Using the Datadog Ansible integration with Ansible Tower

README.md

Datadog and Ansible Tower

This doc explains the nuances of using the Datadog Ansible Integration with Ansible Tower.

Ansible Setup

In a directory of your choosing, run the following commands:

• vagrant init ansible/tower
• vagrant up --provider virtualbox
• vagrant ssh

Upon SSH'ing into the vagrant you'll be greeted with a MOTD similar to:

Welcome to Ansible Tower!

  Log into the web interface here:

    https://10.42.0.42/

    Username: admin
    Password: <redacted>

Open up the URL provided. Enter the username and password provided. You'll then need to fill out a quick form to get a trial license key. The email arrived within ~5 minutes of filling out the form. Upload the key that was sent via email.

Datadog Integration Setup

• Enable the integration in the Datadog Web UI.
• Following the instructions install the following on the vagrant (a little extra work is required here because of missing packages on the vagrant):
  • curl -o get-pip.py https://bootstrap.pypa.io/get-pip.py
  • python get-pip.py
  • sudo pip install datadog

At this juncture, the user could either decide to include datadog_callback.py in every playbook in the callback_plugins directory or they can install it globally for all playbooks on the Ansible Tower server. The context of this document is to install it globally.

The Ansible Tower documentation is incorrect (as of v3.1.4 which was latest asof 2017-07-27; permalink for v3.1.4) as to where the plugin should be installed. The installation directory for datadog_callback.py, contrary to the documentation, is actually /usr/lib/python2.7/site-packages/ansible/plugins/callback.

The following command set will get the Datadog Ansible plugin setup properly:

• cd /usr/lib/python2.7/site-packages/ansible/plugins/callback
• curl -o datadog_callback.py https://raw.githubusercontent.com/DataDog/ansible-datadog-callback/master/datadog_callback.py
• sudo vi datadog_callback.yml
  • insert api_key: <your-api-key> into this yaml file. Note: must be an API key not an App key

Executing Ansible Playbook and viewing Datadog Events

Use the Ansible Tower Web UI to execute a playbook:

Verify execution of playbook:

Note events in Datadog Web UI event stream: