Existen diferencias clave entre la instalación de Agentes en un servidor y en un entorno de contenedores:

• Diferencias de configuración:

  • Servidor: El Agente se configura utilizando un archivo YAML.
  • Contenedor: Las opciones de configuración se pasan utilizando variables de entorno, por ejemplo:

  `DD_API_KEY` # Datadog API key
  `DD_SITE`    # Datadog site
  

• Detección de integraciones:

  • Servidor: Las integraciones se identifican a través del archivo de configuración del Agente.
  • Contenedor: Las integraciones se identifican automáticamente utilizando la función de Autodiscovery de Datadog. Consulta Basic Agent Autodiscovery para aprender más.

Además, consulta el Agente de Docker o Kubernetes para una guía sobre cómo ejecutar el Agente en un entorno de contenedores.

Las etiquetas añaden una capa adicional de metadatos a tus métricas y eventos. Te permiten delimitar y comparar tus datos en las visualizaciones de Datadog. Cuando se envían datos a Datadog desde múltiples servidores, etiquetar esta información te permite enfocarte en los datos que más te interesa visualizar.

Por ejemplo, supongamos que tienes datos recolectados de diferentes equipos y solo te interesa ver las métricas del equipo alfa; etiquetar esos servidores específicos con la etiqueta team:alpha o team:bravo te da la capacidad de filtrar las métricas que están etiquetadas con team:alpha. Consulta Introducción a las etiquetas para aprender más sobre cómo etiquetar tus datos.

1. Localiza el archivo de configuración principal de tu Agente. Para Ubuntu, la ubicación del archivo es /etc/datadog-agent/datadog.yaml.

2. En el archivo datadog.yaml, localiza el parámetro tags. Las etiquetas a nivel de servidor se pueden establecer en la configuración datadog.yaml para aplicar etiquetas en todas las métricas, trazas y registros enviados desde este servidor.

   ## @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>
   

3. Descomenta el parámetro de etiquetas y el ejemplo proporcionado de etiqueta team:infra. También puedes agregar 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
   

4. Reinicia el Agente ejecutando el comando de reinicio del Agente. El comando de reinicio de Ubuntu:

   sudo service datadog-agent restart
   

5. Después de unos minutos, ve a la Metrics Summary page nuevamente y haz clic en la métrica datadog.agent.started. Además de las etiquetas predeterminadas host y version, también puedes ver la etiqueta team y cualquier etiqueta personal que hayas agregado. También puedes filtrar métricas por el campo Tag en la parte superior de la página.

6. Ve a la Event Explorer page y encuentra las etiquetas personalizadas mostradas con el último evento del Agente.

Puedes confirmar que el Agente está funcionando correctamente revisando sus métricas predeterminadas en la interfaz de usuario de Datadog. Ve a la Metrics Summary page y busca la métrica datadog.agent.started o la métrica datadog.agent.running. Si estas métricas no son visibles de inmediato, puede tardar unos minutos para que el Agente envíe los datos a Datadog.

Haz clic en cualquiera de las métricas y se abrirá un panel de métricas. Este panel muestra metadatos adicionales sobre dónde se recopilan estas métricas y cualquier etiqueta asociada. Si no se configuran etiquetas en un servidor, deberías ver solo las etiquetas predeterminadas que Datadog asigna a las métricas, incluyendo version y host. Consulte la sección anterior sobre cómo establecer etiquetas a través de los archivos de configuración del Agente para aprender más sobre cómo agregar etiquetas.

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

La cantidad de espacio y recursos que utiliza el Agente depende de la configuración y de los datos que está enviando. Al principio, puede esperar alrededor del 0.08% de CPU utilizada en promedio con un espacio en disco de aproximadamente 880MB a 1.3GB.

Consulte Sobrecarga del Agente para aprender más sobre estos puntos de referencia.

La recopilación de datos de registros, trazas y procesos se puede habilitar a través del archivo de configuración del Agente. Estas funciones no están habilitadas por defecto. Por ejemplo, en el archivo de configuración, el parámetro logs_enabled está configurado como falso.

##################################
## Log collection Configuration ##
##################################

## @param logs_enabled - boolean - optional - default: false
## @env DD_LOGS_ENABLED - boolean - optional - default: false
## Enable Datadog Agent log collection by setting logs_enabled to true.
#
# logs_enabled: false

Otras funciones de Datadog que se pueden configurar a través del archivo de configuración del Agente incluyen:

• Habilitar Ingesta de Trazas OTLP
• Personalizar la recopilación de registros para filtrar o eliminar datos sensibles
• Configurar datos personalizados a través de DogStatsD

A lo largo de su configuración, cuando la documentación se refiere al archivo datadog.yaml o al archivo de configuración del Agente, este es el archivo que necesita configurar.