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.



  • 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 collection to be installed:

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

    ansible-galaxy collection install community.general


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.


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

- hosts: servers
    - name: Import the Datadog Agent role from the Datadog collection
        name: datadog.dd.agent
    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: