/ansible-role-datadog

Ansible role for Datadog Agent

Primary LanguagePythonApache License 2.0Apache-2.0

Ansible Datadog Role

Ansible Galaxy Build Status

Install and configure Datadog base agent & checks.

Supports most Debian and RHEL-based Linux distributions.

Installation

ansible-galaxy install Datadog.datadog

Role Variables

  • datadog_api_key - Your Datadog API key.
  • datadog_agent_version - The pinned version of the Agent to install (optional, but highly recommended) Examples: 1:5.12.3-1 on apt-based platforms, 5.12.3-1 on yum-based platforms
  • datadog_checks - YAML configuration for agent checks to drop into /etc/dd-agent/conf.d.
  • datadog_config - Settings to place in the /etc/dd-agent/datadog.conf INI file that go under the [Main] section.
  • datadog_config_ex - Extra INI sections to go in /etc/dd-agent/datadog.conf (optional).
  • datadog_process_checks - Array of process checks and options (DEPRECATED: use process under datadog_checks instead)
  • datadog_apt_repo - Override default Datadog apt repository
  • datadog_apt_key_url - Override default url to Datadog apt key
  • datadog_apt_key_url_new - Override default url to the new Datadog apt key (in the near future the apt repo will have to be checked against this new key instead of the current key)
  • datadog_allow_agent_downgrade - Set to yes to allow agent downgrades on apt-based platforms (use with caution, see defaults/main.yml for details)

Dependencies

None

Example Playbooks

- hosts: servers
  roles:
    - { role: Datadog.datadog, become: yes }  # On Ansible < 1.9, use `sudo: yes` instead of `become: yes`
  vars:
    datadog_api_key: "123456"
    datadog_agent_version: "1:5.12.3-1" # for apt-based platforms, use a `5.12.3-1` format on yum-based platforms
    datadog_config:
      tags: "mytag0, mytag1"
      log_level: INFO
      apm_enabled: "true" # has to be set as a string
    datadog_config_ex:
      trace.config:
        env: dev
      trace.concentrator:
        extra_aggregators: version
    datadog_checks:
      process:
        init_config:
        instances:
          - name: ssh
            search_string: ['ssh', 'sshd' ]
          - name: syslog
            search_string: ['rsyslog' ]
            cpu_check_interval: 0.2
            exact_match: true
            ignore_denied_access: true
      ssh_check:
        init_config:
        instances:
          - host: localhost
            port: 22
            username: root
            password: changeme
            sftp_check: True
            private_key_file:
            add_missing_keys: True
      nginx:
        init_config:
        instances:
          - nginx_status_url: http://example.com/nginx_status/
            tags:
              - instance:foo
          - nginx_status_url: http://example2.com:1234/nginx_status/
            tags:
              - instance:bar

- hosts: servers
  roles:
    - { role: Datadog.datadog, become: yes, datadog_api_key: "mykey" }  # On Ansible < 1.9, use `sudo: yes` instead of `become: yes`

License

Apache2

Author Information

brian@akins.org

dustinjamesbrown@gmail.com --Forked from brian@akins.org

Datadog info@datadoghq.com --Forked from dustinjamesbrown@gmail.com