Ansible

Overview

The Datadog Ansible collection, datadog.dd, is the official collection of Ansible-related Datadog content. At the moment, it only contains the Ansible Datadog Role. This role can be accessed as datadog.dd.agent, allowing to install and configure the Datadog Agent and integrations. Agent version 7 is installed by default.

Setup

Requirements

  • Requires Ansible v2.10+.

  • Supports most Debian, RHEL-based and SUSE-based Linux distributions, macOS, and Windows.

  • When using to manage Windows hosts, requires the ansible.windows collection to be installed:

    ansible-galaxy collection install ansible.windows
    
  • When using to manage openSUSE/SLES hosts, requires the community.general collection to be installed:

    ansible-galaxy collection install community.general
    

Installation

To install from Ansible Galaxy, run:

ansible-galaxy collection install datadog.dd

The Datadog Ansible collection is also available through the Red Hat Automation Hub, where it is officially certified by Red Hat.

Usage

To deploy the Datadog Agent on hosts, add the Datadog role and your API key to your playbook:

- hosts: servers
  tasks:
    - name: Import the Datadog Agent role from the Datadog collection
      import_role:
        name: datadog.dd.agent
  vars:
    datadog_api_key: "<YOUR_DD_API_KEY>"

Note for users installing the collection through the Ansible Automation Hub: OpenSUSE/SLES functionality depends on a community collection community.general. Red Hat Support does not provide support for any issues related to community content. Thus, all support issues for OpenSUSE/SLES should be directed to Datadog Support.

Collection role list

Further Reading

Additional helpful documentation, links, and articles: