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 Actualización a 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:
Para gestionar el Agent, utiliza el comando datadog-agent. Por defecto, el binario datadog-agent se encuentra en /usr/local/bin. Habilita o deshabilita integraciones en /opt/datadog-agent/etc/conf.d.
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 integraciones en /opt/datadog-agent/etc/conf.d.
Comportamiento de ejecución del Agent
Por defecto, Agent se ejecuta al iniciar sesión. Puedes desactivarlo utilizando la aplicación Datadog Agent en la bandeja del sistema. Si quieres ejecutar el Agent en el arranque, utiliza estos comandos:
Si estás actualizando desde una versión <5.12.0 de Datadog Agent, utiliza el método de instalación EXE.
En un shell cmd.exe en el directorio donde descargaste el instalador, ejecuta el siguiente comando. Sustituye MY_API_KEY por tu clave de API de Datadog:
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 máquina”. Las versiones anteriores del Agent eran “por usuario” por defecto. También pueden ser necesarios pasos adicionales si estás implementando con Chef. Para obtener más información, consulta Instalación de un Agent de Windows.
Linux y Unix
Instalación en un solo paso
El comando de un solo paso instala los paquetes APT para Datadog Agent y te pide tu contraseña. Si el Agent aún no está instalado en tu equipo y no quieres que se inicie automáticamente después de la instalación, añade DD_INSTALL_ONLY=true al comando antes de ejecutarlo.
Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:
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
El comando de un solo paso instala los paquetes APT para Datadog Agent y te pide tu contraseña. Si el Agent aún no está instalado en tu equipo y no quieres que se inicie automáticamente después de la instalación, añade DD_INSTALL_ONLY=true al comando antes de ejecutarlo.
Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:
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
El comando de un solo paso instala los paquetes YUM para Datadog Agent y te pide tu contraseña. Si el Agent aún no está instalado en tu máquina y no quieres que se inicie automáticamente después de la instalación, añade DD_INSTALL_ONLY=true al comando antes de ejecutarlo.
Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:
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
Instalación en un solo paso
El comando de un solo paso instala los paquetes YUM para Datadog Agent y te pide tu contraseña. Si el Agent aún no está instalado en tu máquina y no quieres que se inicie automáticamente después de la instalación, añade DD_INSTALL_ONLY=true al comando antes de ejecutarlo.
Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:
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
Instalación en un solo paso
El comando de un solo paso instala los paquetes YUM para Datadog Agent y te pide tu contraseña. Si el Agent aún no está instalado en tu máquina y no quieres que se inicie automáticamente después de la instalación, añade DD_INSTALL_ONLY=true al comando antes de ejecutarlo.
Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:
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
Instalación en un solo paso
El comando de un solo paso instala los paquetes YUM para Datadog Agent y te pide tu contraseña. Si el Agent aún no está instalado en tu máquina y no quieres que se inicie automáticamente después de la instalación, añade DD_INSTALL_ONLY=true al comando antes de ejecutarlo.
Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:
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
Instalación en un solo paso
El comando de un solo paso instala la última versión del paquete BFF para Datadog Agent y te pide tu contraseña. Si el Agent aún no está instalado en tu máquina y no quieres que se inicie automáticamente después de la instalación, añade DD_INSTALL_ONLY=true al comando antes de ejecutarlo.
Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:
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 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
Nube y contenedores
Instalar el Agent
Instalación con DaemonSets
Si estás ejecutando Kubernetes >= 1.1.0, puedes aprovechar DaemonSets para implementar automáticamente Datadog Agent en todos tus nodos.
Crea un secreto que contenga tu clave de API. Este secreto se utiliza en el manifiesto para implementar Datadog Agent . Sustituye MY_API_KEY por tu clave de API de Datadog:
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 Discovery.
Ejecutar el Agent como contenedor 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 Docker en cada nodo que quieras monitorizar. Ejecuta el siguiente comando, sustituyendo MY_API_KEY por tu clave de API de Datadog:
Configura tu biblioteca cliente para enviar paquetes UDP a la dirección IP del nodo. Si utilizas redes puente, la pasarela por defecto del contenedor de tu aplicación coincide 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.
Personaliza la configuración de tu Agent
Para personalizar la configuración de tu Agent, consulta la documentación en el repositorio de Agent 5 docker-dd-Agent. Para ajustar la configuración de Autodiscovery, consulta Integraciones de Kubernetes Discovery. 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 la integración de Kubernetes.
Instalación en un solo paso
La instalación en un solo paso ejecuta un contenedor Docker que se integra a 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:
Si el comando de instalación en un paso no funciona, es posible que tu 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.
Envío de 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 UDP a la dirección IP del host.
Personaliza la configuración de tu Agent
Para personalizar la configuración de tu Agent, consulta la documentación en el repositorio de Agent 5 docker-dd-Agent. Para ajustar la configuración de Autodiscovery, consulta Integraciones de Kubernetes Discovery. 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 de Datadog Agent solo funciona con células madre de Ubuntu y Red Hat.
Carga la versión de Datadog Agent a tu director BOSH:
# BOSH CLI v1bosh upload release https://cloudfoundry.datadoghq.com/datadog-agent/datadog-agent-boshrelease-latest.tgz
# BOSH CLI v2bosh 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-agentversion:$UPLOADED_VERSION# e.g. 1.0.5140addons:- name:datadogjobs:- name:dd-agentrelease:datadog-agentproperties:dd:use_dogstatsd:yesdogstatsd_port:18125# Many Cloud Foundry deployments have their own StatsD listening on port 8125api_key:MY_API_KEYtags:["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 v1bosh update runtime-config runtime.yml
# BOSH cli v2bosh update-runtime-config runtime.yml
Vuelve a implementar cualquier implementación existente:
# BOSH cli v1bosh deployment myDeployment.yml
bosh -n deploy
# BOSH cli v2bosh -n -d myDeployment deploy myDeployment.yml
Gestión de la configuración
La colección Datadog Ansible es compatible con la mayoría de las distribuciones de Linux basadas en Debian, RHEL y 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 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 Datadog para gestionar los hosts openSUSE/SLES hosts, debes instalar la colección community.general:
Instala la colección Datadog Ansible desde Ansible Galaxy en tu servidor Ansible:
ansible-galaxy collection install datadog.dd
La colección Datadog Ansible también está disponible a través de Red Hat Automation Hub donde está oficialmente certificada por Red Hat.
Recomendamos instalar la colección. Si es necesario, también puedes instalar Datadog utilizando el rol autónomo.
Para implementar Datadog Agent en hosts, añade el rol de Datadog y tu clave de API a tu cuaderno de estrategias. Sustituye MY_API_KEY por tu clave de API de Datadog:
- hosts:serverstasks:- name:Import the Datadog Agent role from the Datadog collectionimport_role:name:datadog.dd.agentvars: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 Datadog Agent esté rastreando. Puedes comprobar cuáles nombres de host está rastreando Agent, utilizando el siguiente comando:
service datadog-agent info
Checks específicos de Agent
Para utilizar un check o una integración específicos de Agent en uno de tus nodos, puedes utilizar la variable datadog_checks. He aquí un ejemplo de check de proceso:
- hosts:serverstasks:- name:Import the Datadog Agent role from the Datadog collectionimport_role:name:datadog.dd.agentvars:datadog_api_key:"MY_API_KEY"datadog_agent_major_version:5datadog_checks:process:init_config:instances:- name:sshsearch_string:['ssh','sshd']- name:syslogsearch_string:['rsyslog']cpu_check_interval:0.2exact_match:trueignore_denied_access:true
Puedes encontrar más ejemplos de uso del rol de Agent en el repositorio de Github para el rol autónomo.
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 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 Datadog Agent en nodos, añade esta clase parametrizada a tus manifiestos. Sustituye MY_API_KEY por tu clave de API de Datadog:
Para asegurarte de que Agent puede agrupar tus hosts, utiliza únicamente nombres de host de nodos que Datadog Agent esté rastreando. Puedes comprobar qué nombres de host está rastreando Agent, utilizando el siguiente comando:
service datadog-agent info
Habilita los informes a Datadog en tu servidor Puppet:
Añade los siguientes parámetros a /etc/puppet/puppet.conf:
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 de Agent
Para utilizar un check o una integración específicos de Agent en uno de tus nodos, consulta el manifiesto de integración correspondiente para ver un ejemplo de código. He aquí un ejemplo de integración de Elasticsearch:
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 de Chef:
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 Datadog solo es compatible con sistemas basados en Debian y RedHat.
Las siguientes instrucciones añaden la fórmula Datadog al entorno de base Salt. Para añadirla a otro entorno Salt, sustituye las referencias a base por el nombre de tu entorno Salt.
Instalar utilizando gitfs_remotes
Instala la fórmula 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_remotesgitfs_remotes:- https://github.com/DataDog/datadog-formula.git:- saltenv:- base:- ref:3.0# Pin here the version of the formula you want to use
Añade la fórmula 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:
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 de Agent en uno de tus hosts, puedes utilizar la variable checks. He aquí un ejemplo de integración de un directorio:
Consulta la fórmula repositorio de Github para la configuración de logs, ejemplos de check y casos de uso avanzados.
Instalar desde el origen
Datadog Agent requiere Python 2.7 y sysstat en Linux.
Utiliza el script de instalación de origen en un solo paso. 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 aislado 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
Additional helpful documentation, links, and articles: