Rol de Ansible para el Agente de Datadog

La rol de Ansible para el Agente de Datadog instala y configura el Agente de Datadog y sus integraciones.

Rol de Ansible versus Colección de Ansible

La rol de Ansible para el Agente de Datadog está disponible a través de 2 canales diferentes:

• Como parte de la colección de Datadog, accesible bajo el nombre datadog.dd en Ansible Galaxy (recomendado).
• Como un rol independiente, accesible bajo el nombre datadog.datadog en Ansible Galaxy (legado).

La versión 4 del rol y la versión 5 de la colección instalan por defecto el Agente de Datadog v7.

Configuración

Ten en cuenta que las instrucciones de instalación en este documento describen la instalación del rol independiente de Datadog. Para las instrucciones de instalación de la colección de Datadog, consulta el archivo README de la colección. Las variables de configuración son las mismas tanto para el rol independiente como para el rol accesible a través de la colección.

Requisitos

• Requiere Ansible v2.6+.

• Soporta la mayoría de distribuciones de Linux basadas en Debian y RHEL, macOS y Windows.

• Al usar Ansible 2.10+ para gestionar hosts de Windows, requiere que la colección ansible.windows esté instalada:

  ansible-galaxy collection install ansible.windows
  

• Al usar Ansible 2.10+ para gestionar hosts de openSUSE/SLES, requiere que la colección community.general esté instalada:

  ansible-galaxy collection install community.general
  

Instalación

Instala el [rol de Datadog][1] desde Ansible Galaxy en tu servidor Ansible:

ansible-galaxy install datadog.datadog

Para desplegar el Agente de Datadog en los hosts, añade el rol de Datadog y tu clave API a tu playbook:

- hosts: servers
  roles:
    - { role: datadog.datadog, become: yes }
  vars:
    datadog_api_key: "<TU_LLAVE_API_DD>"

La clave API es obligatoria y, si falta, la ejecución del rol falla. Si deseas proporcionarla de otra manera, fuera del control de Ansible, especifica una clave de marcador y sustituye la clave en otro momento.

Variables del rol

Estas variables proporcionan configuración adicional durante la instalación del Agente de Datadog. Deben especificarse en la sección vars de tu playbook.

Variable	Descripción
datadog_api_key	Tu clave API de Datadog. Esta variable es obligatoria desde 4.21.
datadog_site	El sitio de recepción de Datadog para enviar datos del Agente. Por defecto es datadoghq.com, se debe establecer a datadoghq.eu para enviar datos al sitio de la UE. Esta opción solo está disponible con la versión del Agente >= 6.6.0.
datadog_agent_flavor	Sobrescribe el paquete predeterminado de Debian / RedHat para instalaciones IOT en RPI. Por defecto es "datadog-agent" - utiliza "datadog-iot-agent" para RPI.
datadog_agent_version	La versión fijada del Agente a instalar (opcional, pero recomendado), por ejemplo: 7.16.0. No es necesario establecer datadog_agent_major_version si se utiliza datadog_agent_version.
datadog_agent_major_version	La versión principal del Agente a instalar. Los valores posibles son 5, 6 o 7 (por defecto). Si se establece datadog_agent_version, tiene prioridad, de lo contrario se instala la última versión de la especificación.
datadog_checks	Configuración YAML para los chequeos del Agente que se colocarán en: - /etc/datadog-agent/conf.d/<check_name>.d/conf.yaml para Agente v6 y v7, - /etc/dd-agent/conf.d para Agente v5.
datadog_disable_untracked_checks	Establecer en true para eliminar todos los chequeos no presentes en datadog_checks y datadog_additional_checks.
datadog_additional_checks	Lista de chequeos adicionales que no se eliminan si datadog_disable_untracked_checks se establece en true.
datadog_disable_default_checks	Establecer en true para eliminar todos los chequeos predeterminados.
datadog_config	Establecer configuración para el Agente de Datadog. El rol escribe la configuración en la ubicación correcta según el sistema operativo.
...	...

Integraciones

Para configurar una integración de Datadog (chequeo), añade una entrada a la sección datadog_checks. La clave del primer nivel es el nombre del chequeo, y el valor es el payload YAML para escribir el archivo de configuración. A continuación se proporcionan ejemplos.

Para instalar o eliminar una integración, consulta el párrafo de instalación de integración.

...

Para ver más ejemplos y configuraciones, consulta el documento completo.

Repositorios

Linux

Cuando las variables datadog_apt_repo, datadog_yum_repo y datadog_zypper_repo no están configuradas, se utilizan los repositorios oficiales de Datadog para la versión principal configurada en datadog_agent_major_version.

Windows

Cuando la variable datadog_windows_download_url no está configurada, se utiliza el paquete MSI oficial de Windows correspondiente a la datadog_agent_major_version.

macOS

Cuando la variable datadog_macos_download_url no está configurada, se utiliza el paquete DMG oficial de macOS correspondiente a la datadog_agent_major_version.

Desinstalación

En Windows, es posible desinstalar el Agente utilizando el siguiente código en tu rol de Ansible:

- name: Comprobar si el Agente de Datadog está instalado
  ...

Solución de Problemas

Si encuentras problemas específicos, como en Debian Stretch o en versiones de Windows, consulta la sección de solución de problemas en el documento completo para detalles y soluciones.

---

Nota: Este es un resumen simplificado del documento original y no incluye toda la información detallada. Asegúrate de revisar el documento completo para obtener detalles más específicos.