Empezando con el Agent

Docs > Empezando > Empezando con el Agent

Esta guía sirve de introducción al Agent y te explica cómo usarlo para enviar métricas de nivel de sistema a la plataforma de Datadog. Se utilizará como ejemplo la instalación del Agent en Ubuntu. Estos son los puntos que trataremos:

Instalación del Agent
Verificar que el Agent se esté ejecutando
Configurar las funciones del Agent
Solucionar problemas en los recursos

Información general

Acerca del Agent

El Datadog Agent es un software que se ejecuta en tus hosts. Recopila eventos y métricas de los hosts y los envía a Datadog, donde puedes analizar tus datos de monitorización y rendimiento. Puede ejecutarse en tus hosts locales (Windows, MacOS), entornos contenedorizados (Docker, Kubernetes) y en los centros de datos on-premise. Para instalarlo y configurarlo, puedes utilizar herramientas de gestión de configuración (como Chef, Puppet o Ansible).

El Agent puede recopilar entre 75 y 100 métricas de nivel de sistema cada 15-20 segundos. Con configuración adicional, el Agent puede enviar datos, logs y trazas en tiempo real desde los procesos en ejecución a la plataforma de Datadog. El Datadog Agent es de código abierto, y su código fuente está disponible en GitHub: DataDog/datadog-agent.

Sobrecarga del Agent

La cantidad de espacio y recursos que es capaz de absorber el Agent depende de la configuración y del tipo datos configurados para su envío. Al principio, lo normal es que se utilice de media alrededor del 0,08 % de la CPU con un espacio en disco de entre 830 MB y 880 MB.

Para obtener más información sobre estos puntos de referencia, consulta Sobrecarga del Agent.

Datos recopilados

Métricas del Agent

Las métricas del Agent que presentamos a continuación son información que el Agent envía a Datadog sobre sí mismo. Su propósito es que dispongas de datos como en qué hosts y contenedores se están ejecutando Agents, cuándo se inicia un Agent y qué versión de Python se está utilizando.

Métrica	Descripción
`datadog.agent.python.version`	Muestra un valor de `1` si el Agent envía información a Datadog. La métrica se etiqueta con el parámetro `python_version`.
`datadog.agent.running`	Muestra un valor de `1` si el Agent envía información a Datadog.
`datadog.agent.started`	Envía un count con un valor de `1` cuando se inicia el Agent (disponible en v6.12+).

Para ver la lista completa de métricas del Agent, consulta la integración de Métricas del Agent.

Checks

Dependiendo de la plataforma que utilices, el Agent puede tener varios checks básicos activados de forma predeterminada que recopilen métricas.

Check	Métricas	Platformas
CPU	Sistema	Todas
Disco	Disco	Todas
E/S	Sistema	Todas
Memoria	Sistema	Todas
Red	Red	Todas
NTP	NTP	Todas
Tiempo de actividad	Sistema	Todas
Identificador de archivos	Sistema	Todas menos Mac
Carga	Sistema	Todas menos Windows
Docker	Docker	Docker
Winproc	Sistema	Windows

Para recopilar métricas de otras tecnologías, consulta la página de Integraciones.

Diferencias entre Agents para hosts y para contenedores

En esta guía, te enseñaremos a instalar y configurar un Agent en un host. Si tu intención es instalar Agents en un entorno contenedorizado, deberías tener en cuenta que existen algunas diferencias.

En un host, el Agent se configura mediante un archivo YAML (como podrás comprobar más adelante en esta guía). En cambio, las opciones de configuración del Agent en un contenedor se habilitan con variables de entorno como, por ejemplo:
- DD_API_KEY para la clave de API de Datadog
- DD_SITE para el sitio de Datadog
De un modo similar, mientras que en un host las integraciones se identifican mediante el archivo de configuración del Agent, en un entorno de contenedor se identifican automáticamente mediante la función Autodiscovery de Datadog. Para más información, consulta Autodiscovery básico del Agent.

Consulta Docker Agent o Kubernetes para ver un tutorial sobre cómo ejecutar el Agent en un entorno contenedorizado.

¿Por qué debería instalar el Agent?

Para que el Agent envíe datos desde cualquiera de las numerosas integraciones basadas en Agent, tiene que estar instalado. No tiene necesidad de desviar los datos a la plataforma de Datadog; por ejemplo, puedes enviar logs y métricas a través de la API de Datadog. Sin embargo, el Agent es el método recomendado obstante para desviar tus datos hacia la plataforma de Datadog.

El Agent recopila datos del host cada 15 segundos para ofrecer información precisa sobre lo que sucede en tus entornos. Como se ha mencionado anteriormente en la sección Checks, el Agent tiene varios checks activados que recopilan más de 50 métricas predeterminadas para brindar más información sobre los datos de nivel de sistema.

Configuración

Requisitos previos

Crea una cuenta de Datadog.
Ten a mano tu clave de API de Datadog.
Ten la IU de Datadog abierta.

Nota: El sistema operativo que se utiliza en este tutorial es Ubuntu. Consulta la página de Uso básico del Agent para ver la lista completa de plataformas compatibles.

Instalación

En la IU de Datadog, dirígete a Integrations > Agent (Integraciones > Agent) y selecciona Ubuntu para ir a la página de instalación del Agent de Ubuntu. Para instalar el Datadog Agent en un host, usa el comando de instalación de una línea que aparece en esa página (como en el ejemplo de abajo) con tu clave de API de Datadog.

Ejemplo de comando de instalación de una línea en Ubuntu:

DD_API_KEY=<DATADOG_API_KEY> DD_SITE="" bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

En la aplicación, dirígete a la página Instalación del Agent) correspondiente a tu sistema operativo y consulta las instrucciones de instalación más recientes.

Validación

Comando del terminal

Ejecuta el comando de estado del Agent para verificar la instalación.

sudo datadog-agent status

Si la instalación se realiza correctamente, devolverá un informe de estado de Agent con la información del Agent al comienzo. Ejemplo:

===============
Agent (v7.36.1)
===============

  Status date: 2022-06-15 15:54:48.364 EDT / 2022-06-15 19:54:48.364 UTC (1655322888364)
  Agent start: 2022-06-15 15:54:29.85 EDT / 2022-06-15 19:54:29.85 UTC (1655322869850)
  Pid: 9801
  Go Version: go1.17.6
  Python Version: 3.8.11
  Build arch: amd64
  Agent flavor: agent
  Check Runners: 6
  Log Level: info

Events (Eventos)

En la interfaz de usuario Datadog, ve a la página de gestión de eventos Gestión de servicio > Gestión de event. El Agent envía eventos a Datadog cuando se inicia o reinicia Agent. El siguiente mensaje aparece si tu Agent se instala correctamente:

Agent de Datadog (v. 7.XX.X) iniciado en <Hostname>

Checks de servicios

El Agent está configurado para ofrecer los siguientes checks de servicios:

datadog.agent.up: Devuelve OK si el Agent conecta con Datadog.
datadog.agent.check_status: Devuelve CRITICAL si un check de Agent no puede enviar métricas a Datadog; en caso contrario, devuelve OK.

Estos checks se pueden utilizar en la plataforma de Datadog para visualizar rápidamente el estado del Agent a través de los dashboards y monitores. Para más detalles, consulta la información general sobre los checks de servicios.

Métricas

En la IU de Datadog, dirígete a la página Metrics Summary (Resumen de métricas) Metrics > Summary (Métricas > Resumen) y busca la métrica datadog.agent.started o la métrica datadog.agent.running. Si no las ves al momento, puede que el Agent tarde unos minutos en enviar los datos a la plataforma de Datadog.

Haz clic en cualquiera de las métricas para que se abra un panel de métrica. Aquí, podrás ver metadatos adicionales sobre el lugar desde el que se recopilaron las métricas, así como cualquier etiqueta asociada. Como no se ha configurado ninguna etiqueta en el host a estas alturas del tutorial, solo deberías ver las etiquetas predeterminadas que Datadog asigna a las métricas, como version y host. Para obtener más información sobre cómo añadir etiquetas, consulta la siguiente sección sobre los archivos de configuración del Agent.

Explora otras métricas predeterminadas, como ntp.offset o system.cpu.idle.

Archivos de configuración del Agent

El archivo de configuración principal del Agent es datadog.yaml. Estos son los parámetros obligatorios:

tu clave de API de Datadog, que se utiliza para asociar los datos del Agent con tu organización, y
el sitio de Datadog ().

Consulta el archivo config_template.yaml de muestra para ver todas las opciones de configuración disponibles.

Puedes modificar los archivos de configuración del Agent para aprovechar otras funciones de Datadog, incluidas las etiquetas.

Configurar etiquetas mediante el archivo de configuración del Agent

Las etiquetas añaden un nivel adicional de metadatos a tus métricas y eventos. Gracias a ellas, puedes determinar el contexto de tus datos y compararlos en las visualizaciones de Datadog. Cuando se envían datos de varios hosts a Datadog, el etiquetado de esta información te permite acotar los datos que más te interesa visualizar.

Por ejemplo, si tienes datos recopilados a partir de varios equipos diferentes y solo te interesan las métricas del equipo “alpha”, etiquetar esos hosts concretos con team:alpha o team:bravo te permitirá filtrar las métricas que presenten la etiqueta team:alpha. Para más información sobre el etiquetado de tus datos, consulta Empezando con las etiquetas.

Localiza el archivo de configuración principal de tu Agent. En Ubuntu, el archivo se encuentra en /etc/datadog-agent/datadog.yaml.

En el archivo datadog.yaml, localiza el parámetro tags. Puedes definir las etiquetas de nivel de host en la configuración de datadog.yaml para aplicar las etiquetas en todas las métricas, rastreos y logs que se desvíen desde este host.

## @param tags  - list of key:value elements - optional
## @env DD_TAGS - space separated list of strings - optional
## List of host tags. Attached in-app to every metric, event, log, trace, and service check emitted by this Agent.
##
## This configuration value merges with `DD_EXTRA_TAGS`, allowing some
## tags to be set in a configuration file (`tags`), and additional tags to be added
## with an environment variable (`DD_EXTRA_TAGS`).
##
## Learn more about tagging: https://docs.datadoghq.com/tagging/
#
# tags:
#   - team:infra
#   - <TAG_KEY>:<TAG_VALUE>

Quita la marca de comentario del parámetro de etiquetas y de la etiqueta team:infra del ejemplo. También puedes añadir tu propia etiqueta personalizada (por ejemplo, test:agent_walkthrough).

## @param tags  - list of key:value elements - optional
## @env DD_TAGS - space separated list of strings - optional
## List of host tags. Attached in-app to every metric, event, log, trace, and service check emitted by this Agent.
##
## This configuration value merges with `DD_EXTRA_TAGS`, allowing some
## tags to be set in a configuration file (`tags`), and additional tags to be added
## with an environment variable (`DD_EXTRA_TAGS`).
##
## Learn more about tagging: https://docs.datadoghq.com/tagging/
#
tags:
   - team:infra
   - test:agent_walkthrough

Reinicia el Agent ejecutando el comando de reinicio del Agent. Comando de reinicio en Ubuntu:
```
sudo service datadog-agent restart
```
Unos minutos más tarde, dirígete de nuevo a Metrics > Summary (Métricas > Resumen) y haz clic en la métrica datadog.agent.started. Además de las etiquetas host y version predeterminadas, verás la etiqueta team y las etiquetas personales que hayas añadido. También puedes filtrar las métricas con el campo Tag en la parte superior de la página.
Ve a Service Mgmt > Event Management (Gestión de servicios > Gestión de eventos) y busca el etiquetas personalizadas que aparecen con el último evento del Agent.

Otras opciones de configuración

La recopilación de datos de los logs, rastreos y procesos puede activarse a través del archivo de configuración del Agent. Ten en cuenta que estas funciones no están activadas de forma predeterminada. Por ejemplo, si vas al archivo de configuración, verás que el parámetro logs_enabled está establecido como false.

##################################
## Configuración de la recopilación de logs ##
##################################

## @param logs_enabled - boolean - optional - default: false
## @env DD_LOGS_ENABLED - boolean - optional - default: false
## Para activar la recopilación de logs del Datadog Agent, establece logs_enabled como true.
#
# logs_enabled: false

Para configurar otras funciones de Datadog mediante el archivo de configuración del Agent, es necesario:

Activar la ingesta de rastreos OTLP
Personalizar la recopilación de logs para filtrar o limpiar los datos confidenciales
Configurar los datos personalizados mediante DogStatsD

Durante la configuración, cuando veas que la documentación hace referencia al archivo datadog.yaml o al archivo de configuración del Agent, ten en cuenta que se trata del archivo que tienes que configurar.