Instalación del Datadog Agent 5

Documentos > Agent > Guías del Agent > Instalación del Datadog Agent 5

Esta guía cubre la instalación del Agent 5. Datadog recomienda instalar o actualizar al Agent 7 para obtener las últimas características. Para obtener información sobre la instalación de la última versión del Agent, sigue las instrucciones de instalación del Agent 7. Para obtener información sobre la actualización al Agent 7 desde una versión anterior, consulta Actualizar al Datadog Agent v7.

macOS

Instalar el Agent

Línea de comandos

Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/osx/install.sh)"

Para gestionar el Agent, utiliza el comando datadog-agent. Por defecto, el binario datadog-agent se encuentra en /usr/local/bin. Habilita o deshabilita las integraciones en /opt/datadog-agent/etc/conf.d.

Interfaz gráfica de usuario (GUI)

Descarga e instala el paquete DMG.
Añade la siguiente línea a /opt/datadog-agent/etc/datadog.conf, sustituyendo MY_API_KEY por tu clave de API de Datadog:
```
api_key:MY_API_KEY
```

Para gestionar el Agent, utiliza la aplicación Datadog Agent en la bandeja del sistema. Habilita o deshabilita las integraciones en /opt/datadog-agent/etc/conf.d.

Comportamiento de ejecución del Agent

Por defecto, el Agent se ejecuta al iniciar sesión. Puedes desactivarlo utilizando la aplicación del Datadog Agent en la bandeja del sistema. Si quieres ejecutar el Agent en el inicio, utiliza los siguientes comandos:

sudo cp '/opt/datadog-agent/etc/com.datadoghq.agent.plist' /Library/LaunchDaemons
sudo launchctl load -w /Library/LaunchDaemons/com.datadoghq.agent.plist

Desinstalar

Detén y cierra el Datadog Agent seleccionando el icono en forma de hueso de la bandeja.
Arrastra la aplicación de Datadog desde la carpeta de aplicaciones a la papelera.

Ejecuta:

sudo rm -rf /opt/datadog-agent
sudo rm -rf /usr/local/bin/datadog-agent
sudo rm -rf ~/.datadog-agent/** # to remove broken symlinks

Si has ejecutado los comandos de instalación opcionales para que el Agent se ejecute en el arranque, ejecuta lo siguiente para finalizar la desinstalación:

sudo launchctl unload -w /Library/LaunchDaemons/com.datadoghq.agent.plist
sudo rm /Library/LaunchDaemons/com.datadoghq.agent.plist

Windows

Instalación del Agent

Interfaz gráfica de usuario (GUI)

Descarga y ejecuta el instalador del Datadog Agent:

Instalador de 64 bits.
Instalador de 32 bits. Las instalaciones de 32 bits solo son compatibles hasta la versión 5.10.1 del Agent.

Los enlaces a todas las versiones disponibles del instalador de Windows están disponibles en formato JSON.

Línea de comandos

Descarga el Agent:
- Para instalaciones nuevas, descarga el instalador del Datadog Agent.
- Si estás actualizando desde una versión anterior a la 5.12.0 del Datadog Agent, utiliza el método de instalación EXE.
En un shell cmd.exe del directorio donde descargaste el instalador, ejecuta el siguiente comando. Sustituye MY_API_KEY por tu clave de API de Datadog:
```
start /wait msiexec /qn /i ddagent-cli-latest.msi APIKEY="MY_API_KEY"
```
Opcionalmente, añade los valores de TAG y HOSTNAME.

Implementación en Azure

Para instalar el Agent en Azure, consulta la documentación de Microsoft Azure.

Nuevo procedimiento de actualización de la versión 5.12

Si ya eres cliente y utilizas un Agent de Windows anterior a la versión 5.12, es posible que tengas que realizar pasos adicionales para actualizar tu dispositivo. En concreto, la última versión del Agent es una instalación «por equipo». Las versiones anteriores del Agent eran «por usuario» por defecto. También pueden ser necesarios pasos adicionales si lo estás implementando con Chef. Para obtener más información, consulta la Instalación del Agent de Windows.

Desinstalar

Existen dos métodos diferentes para desinstalar el Agent en Windows. Ambos borran el Agent, pero no eliminan la carpeta de configuración C:\ProgramData\Datadog del host.

Nota: Para el Agent < v5.12.0, es importante desinstalar el Agent con la cuenta original utilizada para instalar el Agent, de lo contrario puede que no se elimine correctamente.

Añadir o eliminar programas

Pulsa CTRL y Esc o utiliza la tecla de Windows para ejecutar Windows Search.
Busca add y haz clic en Add or remove programs (Añadir o eliminar programas).
Busca Datadog Agent y haz clic en Uninstall (Desinstalar).

PowerShell

Nota: Habilita WinRM para utilizar los comandos que se muestran a continuación.

Utiliza el siguiente comando de PowerShell para desinstalar el Agent sin tener que reiniciar:

start-process msiexec -Wait -ArgumentList ('/log', 'C:\uninst.log', '/norestart', '/q', '/x', (Get-CimInstance -ClassName Win32_Product -Filter "Name='Datadog Agent'" -ComputerName .).IdentifyingNumber)

Linux y Unix

Instalación en un solo paso

El comando de un solo paso instala los paquetes APT para el Datadog Agent y te pide la contraseña. Si el Agent aún no está instalado en el equipo y no quieres que se inicie automáticamente después de la instalación, añade DD_INSTALL_ONLY=true al principio del comando antes de ejecutarlo.

Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

Instalación en varios pasos

Configura APT para que pueda descargarse a través de HTTPS e instala curl y gnupg:
```
sudo apt-get update
sudo apt-get install apt-transport-https curl gnupg
```

Configura el repositorio de Debian de Datadog en el sistema y crea un conjunto de claves de archivo de Datadog:

sudo sh -c "echo 'deb [signed-by=/usr/share/keyrings/datadog-archive-keyring.gpg] https://apt.datadoghq.com/ stable main' > /etc/apt/sources.list.d/datadog.list"
sudo touch /usr/share/keyrings/datadog-archive-keyring.gpg
sudo chmod a+r /usr/share/keyrings/datadog-archive-keyring.gpg

curl https://keys.datadoghq.com/DATADOG_APT_KEY_CURRENT.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_06462314.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_C0962C7D.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_F14F620E.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_382E94DE.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch

Si ejecutas Debian v8 o una versión anterior, copia el conjunto de claves en /etc/apt/trusted.gpg.d:
```
sudo cp -a /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d/
```

Actualiza tu repositorio local de APT e instala el Agent:

sudo apt-get update
sudo apt-get install datadog-agent datadog-signing-keys

Ejecuta el siguiente comando para copiar la configuración de ejemplo en su lugar. Sustituye MY_API_KEY por tu clave de API de Datadog:
```
sudo sh -c "sed 's/api_key:.*/api_key:MY_API_KEY /' /etc/dd-agent/datadog.conf.example > /etc/dd-agent/datadog.conf"
```
Inicia el Agent:
```
sudo /etc/init.d/datadog-agent start
```

Instalación en un solo paso

Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

Instalación en varios pasos

Configura APT para que pueda descargarse a través de HTTPS e instala curl y gnupg:
```
sudo apt-get update
sudo apt-get install apt-transport-https curl gnupg
```

Configura el repositorio de Debian de Datadog en el sistema y crea un conjunto de claves de archivo de Datadog:

sudo sh -c "echo 'deb [signed-by=/usr/share/keyrings/datadog-archive-keyring.gpg] https://apt.datadoghq.com/ stable main' > /etc/apt/sources.list.d/datadog.list"
sudo touch /usr/share/keyrings/datadog-archive-keyring.gpg
sudo chmod a+r /usr/share/keyrings/datadog-archive-keyring.gpg

curl https://keys.datadoghq.com/DATADOG_APT_KEY_CURRENT.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_06462314.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_C0962C7D.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_F14F620E.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_382E94DE.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch

Si ejecutas Debian v8 o una versión anterior, copia el conjunto de claves en /etc/apt/trusted.gpg.d:
```
sudo cp -a /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d/
```

Actualiza tu repositorio local de APT e instala el Agent:

sudo apt-get update
sudo apt-get install datadog-agent datadog-signing-keys

Ejecuta el siguiente comando para copiar la configuración de ejemplo en su lugar. Sustituye MY_API_KEY por tu clave de API de Datadog:
```
sudo sh -c "sed 's/api_key:.*/api_key:MY_API_KEY /' /etc/dd-agent/datadog.conf.example > /etc/dd-agent/datadog.conf"
```
Inicia el Agent:
```
sudo /etc/init.d/datadog-agent start
```

Desinstalar

Para desinstalar el Agent, ejecuta el siguiente comando:

sudo apt-get remove datadog-agent -y

Este comando borra el Agent, pero no elimina:

El archivo de configuración datadog.yaml
Los archivos que ha creado el usuario en la carpeta de configuración /etc/dd-agent
Los archivos que ha creado el usuario en la carpeta /opt/datadog-agent
El usuario dd-agent
Archivos de log de Datadog

Si también quieres borrar estos elementos, ejecuta este comando después de eliminar el Agent:

sudo apt-get --purge remove datadog-agent -y

Instalación en un solo paso

El comando de un solo paso instala los paquetes YUM para el Datadog Agent y te pide la contraseña. Si el Agent aún no está instalado en el equipo y no quieres que se inicie automáticamente después de la instalación, añade DD_INSTALL_ONLY=true al principio del comando antes de ejecutarlo.

Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

Instalación en varios pasos

Configura el repositorio de YUM de Datadog creando /etc/yum.repos.d/datadog.repo con el siguiente contenido:

[datadog]
name=Datadog, Inc.
baseurl=https://yum.datadoghq.com/rpm/x86_64/
enabled=1
gpgcheck=1
gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public
       https://keys.datadoghq.com/DATADOG_RPM_KEY_B01082D3.public
       https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public

Nota: En la arquitectura i386/i686, sustituye «x86_64» por «i386».

Actualiza el repositorio de YUM local e instala el Agent:
```
sudo yum makecache
sudo yum install datadog-agent
```

Copia la configuración de ejemplo en su lugar. Sustituye MY_API_KEY por tu clave de API de Datadog:

sudo sh -c "sed 's/api_key:.*/api_key:MY_API_KEY /' /etc/dd-agent/datadog.conf.example > /etc/dd-agent/datadog.conf"

Reinicia el Agent:
```
sudo /etc/init.d/datadog-agent restart
```

Desinstalar

Para desinstalar el Agent, ejecuta el siguiente comando:

sudo yum remove datadog-agent

Este comando borra el Agent, pero no elimina:

El archivo de configuración datadog.yaml
Los archivos que ha creado el usuario en la carpeta de configuración /etc/dd-agent
Los archivos que ha creado el usuario en la carpeta /opt/datadog-agent
El usuario dd-agent
Archivos de log de Datadog

Si también quieres borrar estos elementos, ejecuta este comando después de eliminar el Agent:

sudo userdel dd-agent \
&& sudo rm -rf /opt/datadog-agent/ \
&& sudo rm -rf /etc/dd-agent/ \
&& sudo rm -rf /var/log/datadog/

Instalación en un solo paso

Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

Instalación en varios pasos

Configura el repositorio de YUM de Datadog creando /etc/yum.repos.d/datadog.repo con el siguiente contenido:

[datadog]
name=Datadog, Inc.
baseurl=https://yum.datadoghq.com/rpm/x86_64/
enabled=1
gpgcheck=1
gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public
       https://keys.datadoghq.com/DATADOG_RPM_KEY_B01082D3.public
       https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public

Nota: En la arquitectura i386/i686, sustituye «x86_64» por «i386».

Actualiza tu repositorio de YUM local e instala el Agent:

sudo yum makecache
sudo yum remove datadog-agent-base 
sudo yum install datadog-agent

Copia la configuración de ejemplo en su lugar. Sustituye MY_API_KEY por tu clave de API de Datadog:

sudo sh -c "sed 's/api_key:.*/api_key:MY_API_KEY /' /etc/dd-agent/datadog.conf.example > /etc/dd-agent/datadog.conf"

Reinicia el Agent:
```
sudo /etc/init.d/datadog-agent restart
```

Desinstalar

Para desinstalar el Agent, ejecuta el siguiente comando:

sudo yum remove datadog-agent

Este comando borra el Agent, pero no elimina:

El archivo de configuración datadog.yaml
Los archivos que ha creado el usuario en la carpeta de configuración /etc/dd-agent
Los archivos que ha creado el usuario en la carpeta /opt/datadog-agent
El usuario dd-agent
Archivos de log de Datadog

Si también quieres borrar estos elementos, ejecuta este comando después de eliminar el Agent:

sudo userdel dd-agent \
&& sudo rm -rf /opt/datadog-agent/ \
&& sudo rm -rf /etc/dd-agent/ \
&& sudo rm -rf /var/log/datadog/

Instalación en un solo paso

Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

Instalación en varios pasos

Configura el repositorio de YUM de Datadog creando /etc/yum.repos.d/datadog.repo con el siguiente contenido:

[datadog]
name=Datadog, Inc.
baseurl=https://yum.datadoghq.com/rpm/x86_64/
enabled=1
gpgcheck=1
gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public
       https://keys.datadoghq.com/DATADOG_RPM_KEY_B01082D3.public
       https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public

Nota: En la arquitectura i386/i686, sustituye «x86_64» por «i386».

Actualiza tu repositorio de YUM local e instala el Agent:
```
sudo yum makecache
sudo yum install datadog-agent
```

Copia la configuración de ejemplo en su lugar. Sustituye MY_API_KEY por tu clave de API de Datadog:

sudo sh -c "sed 's/api_key:.*/api_key:MY_API_KEY /' /etc/dd-agent/datadog.conf.example > /etc/dd-agent/datadog.conf"

Reinicia el Agent:
```
sudo /etc/init.d/datadog-agent restart
```

Desinstalar

Para desinstalar el Agent, ejecuta el siguiente comando:

sudo yum remove datadog-agent

Este comando borra el Agent, pero no elimina:

El archivo de configuración datadog.yaml
Los archivos que ha creado el usuario en la carpeta de configuración /etc/dd-agent
Los archivos que ha creado el usuario en la carpeta /opt/datadog-agent
El usuario dd-agent
Archivos de log de Datadog

Si también quieres borrar estos elementos, ejecuta este comando después de eliminar el Agent:

sudo userdel dd-agent \
&& sudo rm -rf /opt/datadog-agent/ \
&& sudo rm -rf /etc/dd-agent/ \
&& sudo rm -rf /var/log/datadog/

Instalación en un solo paso

Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

Instalación en varios pasos

Configura el repositorio de YUM de Datadog creando /etc/yum.repos.d/datadog.repo con el siguiente contenido:

[datadog]
name=Datadog, Inc.
enabled=1
baseurl=https://yum.datadoghq.com/suse/rpm/x86_64
type=rpm-md
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_B01082D3.public
gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public

Actualiza tu repositorio Zypper local e instala el Agent:
```
sudo zypper refresh
sudo zypper install datadog-agent
```

Copia la configuración de ejemplo en su lugar. Sustituye MY_API_KEY por tu clave de API de Datadog:

sudo sh -c "sed 's/api_key:.*/api_key: MY_API_KEY/' /etc/dd-agent/datadog.conf.example > /etc/dd-agent/datadog.conf"

Reinicia el Agent:
```
sudo /etc/init.d/datadog-agent restart
```

Desinstalar

Para desinstalar el Agent, ejecuta el siguiente comando:

sudo zypper remove datadog-agent

Este comando borra el Agent, pero no elimina:

El archivo de configuración datadog.yaml
Los archivos que ha creado el usuario en la carpeta de configuración /etc/dd-agent
Los archivos que ha creado el usuario en la carpeta /opt/datadog-agent
El usuario dd-agent
Archivos de log de Datadog

Si también quieres borrar estos elementos, ejecuta este comando después de eliminar el Agent:

sudo userdel dd-agent \
&& sudo rm -rf /opt/datadog-agent/ \
&& sudo rm -rf /etc/dd-agent/ \
&& sudo rm -rf /var/log/datadog/

Instalación en un solo paso

El comando de un solo paso instala la última versión del paquete BFF para el Datadog Agent y te pide la contraseña. Si el Agent aún no está instalado en el equipo y no quieres que se inicie automáticamente después de la instalación, añade DD_INSTALL_ONLY=true al principio del comando antes de ejecutarlo.

Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

Actualizar desde una instalación anterior

Para instalar el Agent manteniendo la configuración actual, ejecuta el siguiente comando:

DD_UPGRADE=true ksh -c "$(curl -L https://raw.githubusercontent.com/DataDog/datadog-unix-agent/master/scripts/install_script.sh)"

Para ver una lista completa de las variables de entorno del script de instalación disponibles, consulta Uso básico del Agent de AIX.

Instalación en varios pasos

Descarga el paquete BFF preferido de las versiones de repositorios de datadog-unix-agent:

Instala el artefacto como raíz con installp:

installp -aXYgd datadog-unix-agent-latest.powerpc.aix..bff datadog-unix-agent

Si no dispones de un archivo de configuración, copia la configuración de ejemplo. Sustituye MY_API_KEY por tu clave de API de Datadog:
```
sudo sh -c "sed 's/api_key:.*/api_key: MY_API_KEY/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
```

Asegúrate de que el Datadog Agent tiene los permisos correctos:

sudo sh -c "chown dd-agent:dd-agent /etc/datadog-agent/datadog.yaml && chmod 660 /etc/datadog-agent/datadog.yaml"

Detén el servicio del Agent:
```
sudo stopsrc -s datadog-agent
```
Comprueba si el servicio del Agent se ha detenido:
```
sudo lssrc -s datadog-agent
```
Reinicia el servicio del Agent:
```
sudo startsrc -s datadog-agent
```

Desinstalar

Para desinstalar el Agent, ejecuta el siguiente comando:

Para eliminar un Agent ya instalado, ejecuta el siguiente comando installp:

installp -e dd-aix-uninstall.log -uv datadog-unix-agent

Nota: Los logs de desinstalación del Agent se pueden encontrar en el archivo dd-aix-install.log. Para desactivar este log, elimina el parámetro -e en el comando de desinstalación.

Nube y contenedores

Instalación del Agent

Instalación con DaemonSets

Si estás ejecutando Kubernetes 1.1.0 o una versión posterior, puedes aprovechar DaemonSets para implementar automáticamente el Datadog Agent en todos tus nodos.

Crea un secreto que contenga tu clave de API. Este secreto se utiliza en el manifiesto para implementar el Datadog Agent. Sustituye MY_API_KEY por tu clave de API de Datadog:
```
kubectl create secret generic datadog-secret --from-literal api-key =" MY_API_KEY"
```

Crea el siguiente manifiesto denominado dd-agent.yaml:

apiVersion: extensions/v1beta1
kind: DaemonSet
metadata:
name: dd-agent
spec:
template:
   metadata:
      labels:
      app: dd-agent
      name: dd-agent
   spec:
      containers:
      - image: gcr.io/datadoghq/docker-dd-agent:latest
      imagePullPolicy: Always
      name: dd-agent
      ports:
         - containerPort: 8125
            name: dogstatsdport
            protocol: UDP
      env:
         - name: DD_API_KEY
            valueFrom:
            secretKeyRef:
               name: datadog-secret
               key: api-key
         - name: KUBERNETES
            value: "yes"
         - name: SD_BACKEND
            value: docker
         # Uncomment this variable if the agent has issues reaching kubelet
         # - name: KUBERNETES_KUBELET_HOST
         #   valueFrom:
         #     fieldRef:
         #       fieldPath: status.hostIP  # Kubernetes >= 1.7
         #       # or
         #       # fieldPath: spec.nodeName  # Kubernetes < 1.7
      resources:
         requests:
            memory: "256Mi"
            cpu: "200m"
         limits:
            memory: "256Mi"
            cpu: "200m"
      volumeMounts:
         - name: dockersocket
            mountPath: /var/run/docker.sock
         - name: procdir
            mountPath: /host/proc
            readOnly: true
         - name: cgroups
            mountPath: /host/sys/fs/cgroup
            readOnly: true
      livenessProbe:
         exec:
            command:
            - ./probe.sh
         initialDelaySeconds: 15
         periodSeconds: 5
      volumes:
      - hostPath:
            path: /var/run/docker.sock
         name: dockersocket
      - hostPath:
            path: /proc
         name: procdir
      - hostPath:
            path: /sys/fs/cgroup
         name: cgroups

Implementa el DaemonSet:
```
kubectl create -f dd-agent.yaml
```

Este manifiesto activa la función de auto-configuración de Autodiscovery. Para deshabilitar la función de auto-configuración, elimina la definición de la variable de entorno SD_BACKEND. Para saber cómo configurar Autodiscovery, consulta Integraciones de Kubernetes Autodiscovery.

Ejecutar el Agent como contenedor de Docker

Si no estás ejecutando Kubernetes 1.1.0 o una versión posterior, o si no quieres utilizar DaemonSets, ejecuta el Agent como contenedor de Docker en cada nodo que quieras monitorizar. Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:

docker run -d --name dd-agent -h `hostname` -v /var/run/docker.sock:/var/run/docker.sock:ro -v /proc/:/host/proc/:ro -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro -e API_KEY=MY_API_KEY -e KUBERNETES=yes -e SD_BACKEND=docker gcr.io/datadoghq/docker-dd-agent:latest

Enviar métricas personalizadas

Si tienes previsto enviar métricas personalizadas utilizando DogStatsD:

Vincula el puerto StatsD del contenedor a la dirección IP del nodo añadiendo hostPort a la sección ports de tu manifiesto:
```
ports:
  - containerPort: 8125
    hostPort: 8125
    name: dogstatsdport
    protocol: UDP
```
Configura tu biblioteca cliente para enviar paquetes de UDP a la dirección IP del nodo. Si utilizas redes puente, la pasarela por defecto del contenedor de tu aplicación coincidirá con la dirección IP del nodo. También puedes utilizar la API descendente para exponer el nombre de host del nodo como una variable de entorno.

Personalizar la configuración de tu Agent

Para personalizar la configuración de tu Agent, consulta la documentación en el repositorio del Agent 5 docker-dd-agent. Para ajustar la configuración de Autodiscovery, consulta Integraciones de Kubernetes Autodiscovery. Para desactivar Autodiscovery, elimina la variable de entorno SD_BACKEND de tu manifiesto.

Para obtener información sobre la recopilación de métricas, checks de servicios y eventos, consulta la documentación sobre las integraciones de Kubernetes.

Instalación en un solo paso

La instalación en un solo paso ejecuta un contenedor de Docker que se integra en el Datadog Agent para monitorizar tu host. La integración de Docker está habilitada por defecto, así como Autodiscovery en modo de auto-configuración. Para deshabilitar Autodiscovery, elimina la variable SD_BACKEND del comando de instalación en un solo paso.

Amazon Linux

Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:

docker run -d --name dd-agent -v /var/run/docker.sock:/var/run/docker.sock:ro -v /proc/:/host/proc/:ro -v /cgroup/:/host/sys/fs/cgroup:ro -e API_KEY=MY_API_KEY -e SD_BACKEND=docker gcr.io/datadoghq/docker-dd-agent:latest

Otros sistemas operativos

Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:

docker run -d --name dd-agent -v /var/run/docker.sock:/var/run/docker.sock:ro -v /proc/:/host/proc/:ro -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro -e API_KEY=MY_API_KEY -e SD_BACKEND=docker gcr.io/datadoghq/docker-dd-agent:latest

Solucionar problemas

Si el comando de instalación en un paso no funciona, es posible que el sistema monte el directorio cgroup en un lugar inesperado o que no utilice CGroups para la gestión de la memoria. Los CGroups son necesarios para que el check de Docker funcione correctamente. Para habilitar los CGroups, consulta la documentación del repositorio de docker-dd-agent. Si el check falla debido a la localización inesperada de un directorio cgroup:

Ejecuta mount | grep "cgroup type tmpfs" para recuperar la localización del directorio cgroup.
Sustituye la primera aparición de /sys/fs/cgroup en el comando de instalación en un solo paso por la localización del directorio cgroup.

Enviar métricas personalizadas

Para enviar métricas personalizadas utilizando DogStatsD:

Añade la opción «-p 8125:8125/udp» al comando de instalación. Esto vincula el puerto StatsD del contenedor a la dirección IP del host.
Configura tu biblioteca cliente para enviar paquetes de UDP a la dirección IP del host.

Personalizar la configuración de tu Agent

Para personalizar la configuración de tu Agent, consulta la documentación en el repositorio del Agent 5 docker-dd-agent. Para ajustar la configuración de Autodiscovery, consulta Integraciones de Docker Autodiscovery. Para deshabilitar Autodiscovery, elimina la variable de entorno SD_BACKEND del comando de instalación en un solo paso.

La ejecución de contenedores CoreOS Linux es compatible con el runtime de Docker. Para obtener instrucciones de instalación, consulta Docker.

Para ejecutar CoreOS Tectonic en Kubernetes, consulta Kubernetes.

Para obtener información sobre la instalación de Datadog con OpenShift, consulta el repositorio de datadog-openshift.

La versión de BOSH del Datadog Agent solo funciona con células madre de Ubuntu y Red Hat.

Carga la versión del Datadog Agent a tu director BOSH:

# BOSH CLI v1
bosh upload release https://cloudfoundry.datadoghq.com/datadog-agent/datadog-agent-boshrelease-latest.tgz

# BOSH CLI v2
bosh upload-release https://cloudfoundry.datadoghq.com/datadog-agent/datadog-agent-boshrelease-latest.tgz

Configura Datadog como complemento en tu configuración de ejecución. Sustituye MY_API_KEY por tu clave de API de Datadog:

# runtime.yml
---
releases:
- name: datadog-agent
   version: $UPLOADED_VERSION # e.g. 1.0.5140

addons:
- name: datadog
jobs:
- name: dd-agent
   release: datadog-agent
properties:
   dd:
      use_dogstatsd: yes
      dogstatsd_port: 18125 # Many Cloud Foundry deployments have their own StatsD listening on port 8125
      api_key: MY_API_KEY
      tags: ["my-cloud-foundry-deployment"] # optional. Add any tags you wish
      # Optionally, enable any Agent Checks here
      # integrations:
      #   directory:
      #     init_config: {}
      #     instances:
      #       directory: "."

Añade el runtime a tu configuración de runtime:

# BOSH cli v1
bosh update runtime-config runtime.yml

# BOSH cli v2
bosh update-runtime-config runtime.yml

Vuelve a desplegar cualquier implementación existente:

# BOSH cli v1
bosh deployment myDeployment.yml
bosh -n deploy

# BOSH cli v2
bosh -n -d myDeployment deploy myDeployment.yml

Gestión de la configuración

La colección Ansible de Datadog es compatible con la mayoría de las distribuciones de Linux basadas en Debian, RHEL, SUSE, macOS y Windows.
Requiere la versión 2.10 o posterior de Ansible.

Requisitos previos

Windows

Antes de poder utilizar la colección Ansible de Datadog para gestionar hosts de Windows, debes instalar la colección ansible.windows:

ansible-galaxy collection install ansible.windows

openSUSE y SLES

Antes de poder utilizar la colección Ansible de Datadog para gestionar hosts openSUSE/SLES, debes instalar la colección community.general:

ansible-galaxy collection install community.general

Instalar Datadog

Instala la colección Ansible de Datadog desde Ansible Galaxy en el servidor Ansible:
```
ansible-galaxy collection install datadog.dd
```
- La colección Ansible de Datadog también está disponible a través de Red Hat Automation Hub, donde está oficialmente certificada por Red Hat.
- Se recomienda instalar la colección. Si es necesario, también puedes instalar Datadog utilizando el rol independiente.
Para implementar el Datadog Agent en hosts, añade el rol de Datadog y tu clave de API al cuaderno de estrategias. Sustituye MY_API_KEY por tu clave de API de Datadog:
```
- hosts: servers
tasks:
   - name: Import the Datadog Agent role from the Datadog collection
      import_role:
      name: datadog.dd.agent
vars:
   datadog_api_key: "MY_API_KEY"
   datadog_agent_major_version: 5
```
Para asegurarte de que el Agent puede agrupar tus hosts, utiliza únicamente nombres de host de nodos que el Datadog Agent esté rastreando. Puedes comprobar qué nombres de host está rastreando el Agent utilizando el siguiente comando:
```
service datadog-agent info
```

Checks específicos del Agent

Para utilizar un check o una integración específicos del Agent en uno de tus nodos, puedes utilizar la variable datadog_checks. El siguiente es un ejemplo de check de procesos:

- hosts: servers
  tasks:
    - name: Import the Datadog Agent role from the Datadog collection
      import_role:
        name: datadog.dd.agent
  vars:
    datadog_api_key: "MY_API_KEY"
    datadog_agent_major_version: 5
    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

Puedes encontrar más ejemplos de uso de los roles del Agent en el repositorio de Github para el rol independiente.

Métricas y eventos

Para obtener métricas y eventos en Datadog tras la ejecución de Ansible, consulta la página de Github del proyecto de callbacks de Ansible.

El módulo datadog_agent solo es compatible con nodos Linux.
Requiere Puppet Agent versión 2.7 o posterior.

Instala el módulo datadog_agent desde Puppet Forge en tu servidor Puppet:
- Para instalaciones nuevas, ejecuta el module install command:
```
puppet module install datadog-datadog_agent
```
- Si el módulo ya está instalado, actualízalo:
```
puppet module upgrade datadog-datadog_agent
```
Para implementar el Datadog Agent en nodos, añade esta clase parametrizada a tus manifiestos. Sustituye MY_API_KEY por tu clave de API de Datadog:
```
node "db1.mydomain.com" {
   class { "datadog_agent":
      api_key => "MY_API_KEY"
   }
}
```
Para asegurarte de que el Agent puede agrupar tus hosts, utiliza únicamente nombres de host de nodos que el Datadog Agent esté rastreando. Puedes comprobar qué nombres de host está rastreando el Agent utilizando el siguiente comando:
```
service datadog-agent info
```

Habilita la realización de informes a Datadog en tu servidor Puppet:

Añade los siguientes parámetros a /etc/puppet/puppet.conf:

[master]
report = true
reports = datadog_reports
pluginsync = true

[agent]
report = true
pluginsync = true

En tu manifiesto, añade la opción puppet_run_reports a tu servidor Puppet. Por ejemplo:

node "puppet" {
   class { "datadog_agent":
      api_key            => "MY_API_KEY",
      puppet_run_reports => true
      }
}

Ejecuta Puppet en tu servidor Puppet para instalar todas las dependencias necesarias.
Reinicia tu servidor Puppet para empezar a recibir datos de Puppet en Datadog.

Checks específicos del Agent

Para utilizar un check o una integración específicos del Agent en uno de tus nodos, consulta el manifiesto de integraciones correspondiente para ver un ejemplo de código. El siguiente es un ejemplo de integración de Elasticsearch:

node "elastic-node1.mydomain.com" {
    class { "datadog_agent":
        api_key => ""
    }
    include "datadog_agent::integrations::elasticsearch"
}

Requiere la versión Chef 10.14 o posterior.

Añade el cookbook de Datadog:
- Si utilizas Berkshelf, añade el cookbook a tu Berksfile:
```
cookbook 'datadog'
```
- Si no estás utilizando Berkshelf, instala el cookbook en tu repositorio utilizando Knife:
```
knife cookbook site install datadog 
```

Establece atributos específicos de Datadog en un rol, un entorno u otra receta. Sustituye MY_API_KEY por tu clave de API de Datadog:

node.default['datadog']['api_key'] = "MY_API_KEY"
# Use an existing application key or create a new one for Chef
node.default['datadog']['application_key'] = "Generate Application Key"

Carga el cookbook actualizado en tu servidor Chef:

berks upload
# or
knife cookbook upload datadog
knife cookbook list | grep datadog && 
echo -e "e[0;32mdatadog cookbook - OKe[0m" ||
echo -e "e[0;31mmissing datadog cookbook - OKe[0m"

Añade el cookbook a la run_list o al role de tu nodo:
```
"run_list": [
 "recipe[datadog::dd-agent]"
]
```
Espera a la siguiente ejecución programada de chef-client.

La fórmula Saltstack de Datadog solo es compatible con sistemas basados en Debian y RedHat.

Las siguientes instrucciones añaden la fórmula de Datadog al entorno Salt de base. Para añadirla a otro entorno Salt, sustituye las referencias de base por el nombre de tu entorno Salt.

Instalar utilizando `gitfs_remotes`

Instala la fórmula de Datadog en el entorno de base de tu nodo Salt Master utilizando la opción gitfs_remotes en tu archivo de configuración Salt Master (por defecto, /etc/salt/master):

fileserver_backend:
- roots # Active by default, necessary to be able to use the local salt files we define in the next steps
- gitfs # Adds gitfs as a fileserver backend to be able to use gitfs_remotes

gitfs_remotes:
- https://github.com/DataDog/datadog-formula.git:
  - saltenv:
    - base:
    - ref: 3.0 # Pin here the version of the formula you want to use

Reinicia el servicio Salt Master:

systemctl restart salt-master

service salt-master restart

Instalación clonando la fórmula de Datadog

Clona la fórmula de Datadog en tu nodo Salt Master:

mkdir -p /srv/formulas && cd /srv/formulas git clone https://github.com/DataDog/datadog-formula.git

Añade la fórmula clonada al entorno de base en el file_roots de tu archivo de configuración de Salt Master (por defecto, /etc/salt/master):
```
file_roots:
  base:
    - /srv/salt/
    - /srv/formulas/datadog-formula/
```

Implementar el Agent en tus hosts

Añade la fórmula de Datadog a tu archivo superior (por defecto, /srv/salt/top.sls):
```
base:
  '*':
    - datadog
```
Añade un archivo pillar datadog.sls a tu directorio pillar (por defecto, /srv/pillar/) y añade tu clave de API. Sustituye MY_API_KEY por tu clave de API de Datadog:
```
datadog:
  config:
    api_key: MY_API_KEY
  install_settings:
    agent_version: <AGENT5_VERSION>
```
Añade el archivo pillar datadog.sls al archivo pillar superior (por defecto, /srv/pillar/top.sls):
```
base:
  '*':
    - datadog
```

Para utilizar un check o una integración específicos del Agent en uno de tus hosts, puedes utilizar la variable checks. El siguiente es un ejemplo de integración de un directorio:

datadog:
  config:
    api_key: MY_API_KEY
  install_settings:
    agent_version: <AGENT5_VERSION>
  checks:
    directory:
      config:
        instances:
          - directory: "/srv/pillar"
            name: "pillars"

Consulta la fórmula repositorio de Github para la configuración de logs, ejemplos de check y casos de uso avanzados.

Instalar desde la fuente

El Datadog Agent requiere la versión Python 2.7 y Sysstat en Linux.

Utiliza el script de instalación en un solo paso desde el origen. Sustituye MY_API_KEY por tu clave de API de Datadog:

DD_API_KEY=MY_API_KEY sh -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/setup_agent.sh)"

El script instala el Agent en su propio sandbox autónomo ubicado en ~/.datadog-agent.

Para que la instalación sea permanente, configura tu daemon init para que ejecute $sandbox_dir/bin/agent con $sandbox_dir en el directorio de trabajo actual. El directorio sandbox es portátil y puede ejecutarse desde cualquier ubicación de tu sistema de archivos. El directorio sandbox está configurado por defecto en ~/.datadog-agent.

Leer más

Más enlaces, artículos y documentación útiles:

Uso básico del AgentDOCUMENTACIÓN

Instalación del Datadog Agent 5

macOS

Instalar el Agent

Línea de comandos

Interfaz gráfica de usuario (GUI)

Comportamiento de ejecución del Agent

Desinstalar

Windows

Instalación del Agent

Interfaz gráfica de usuario (GUI)

Línea de comandos

Implementación en Azure

Nuevo procedimiento de actualización de la versión 5.12

Desinstalar

Añadir o eliminar programas

PowerShell

Linux y Unix

Instalación en un solo paso

Instalación en varios pasos

Instalación en un solo paso

Instalación en varios pasos

Desinstalar

Instalación en un solo paso

Instalación en varios pasos

Desinstalar

Instalación en un solo paso

Instalación en varios pasos

Desinstalar

Instalación en un solo paso

Instalación en varios pasos

Desinstalar

Instalación en un solo paso

Instalación en varios pasos

Desinstalar

Instalación en un solo paso

Actualizar desde una instalación anterior

Instalación en varios pasos

Desinstalar

Nube y contenedores

Instalación del Agent

Instalación con DaemonSets

Ejecutar el Agent como contenedor de Docker

Enviar métricas personalizadas

Personalizar la configuración de tu Agent

Instalación en un solo paso

Amazon Linux

Otros sistemas operativos

Solucionar problemas

Enviar métricas personalizadas

Personalizar la configuración de tu Agent

Gestión de la configuración

Requisitos previos

Windows

openSUSE y SLES

Instalar Datadog

Checks específicos del Agent

Métricas y eventos

Checks específicos del Agent

Instalar utilizando gitfs_remotes

Instalación clonando la fórmula de Datadog

Implementar el Agent en tus hosts

Instalar desde la fuente

Leer más

Instalar utilizando `gitfs_remotes`