Para una configuración sin contenedor, instala el Datadog Agent en Elastic Beanstalk utilizando la Personalización avanzada de entorno con archivos de configuración (.ebextensions):

1. Crea una carpeta llamada .ebextensions en la raíz de tu paquete de aplicaciones de origen.
2. Descarga 99datadog.config y colócalo en la carpeta .ebextensions.
3. Cambia el valor de api_key dentro de la plantilla de archivo por/etc/datadog-agent/datadog.yaml con tu clave de API Datadog.
4. Cambia el valor de site en /etc/datadog-agent/datadog.yaml por el de tu región Datadog (por ejemplo: ) para asegurarte de que el Agent envía los datos a la localización de Datadog correcta.
5. Fija una versión específica del Agent configurando DD_Agent_VERSION en option_settings para asegurarte de que todos los hosts ejecutan la misma versión del Agent.
6. Despliega tu aplicación con la consola de Elastic Beanstalk, la EB CLI o la AWS CLI.

Puedes añadir parámetros adicionales al Agent en /etc/datadog-agent/datadog.yaml.

Por ejemplo, para habilitar la Monitorización de procesos en vivo:

process_config:
  enabled: "true"

Recopilación de trazas

Cuando la aplicación no está en un contenedor y el Datadog Agent está configurado con 99datadog.config, el rastreo se habilita sin ninguna configuración adicional, siempre que la aplicación esté instrumentada con la configuración de la biblioteca de rastreo.

Para una configuración sin contenedor, instala el Datadog Agent en Elastic Beanstalk utilizando la Personalización avanzada de entorno con archivos de configuración (.ebextensions):

1. Crea una carpeta llamada .ebextensions en la raíz de tu paquete de aplicaciones de origen.
2. Descarga 99datadog-windows.config y desplázalo a la carpeta .ebextensions. Revisa el ejemplo de configuración y realiza las modificaciones necesarias.
3. En 99datadog-windows.config, sustituye el valor APIKEY por tu clave de API Datadog.
4. (Opcional) Si necesitas añadir variables de entorno, configúralas en la sección 00_setup-env1 de 99datadog-windows.config. Puedes eliminar esta sección si no necesitas configurar variables entorno.
5. (Opcional) Si no quieres habilitar APM en tu entorno, elimina la sección packages.msi.DotnetAPM, la sección 02_setup-APM1 y la sección 03_setup-APM2.
6. Para la recopilación de trazas con .NET APM:
   1. Sustituye el enlace packages.msi.DotnetAPM por el archivo MSI (Windows Installer) de la versión deseada en las notas de lanzamiento dd-trace-dotnet.
   2. (Opcional) Si necesitas añadir variables de entorno para .NET APM, configúralas en la sección 00_setup-env1 de 99datadog-windows.config.
7. Despliegue su aplicación con Elastic Beanstalk Console, EB CLI, o AWS CLI.

Recopilación de trazas

Cuando la aplicación no está en un contenedor y el Datadog Agent está configurado con 99datadog-windows.config, el rastreo se habilita sin ninguna configuración adicional a los pasos indicados en la sección anterior. Para más información sobre la instrumentación del rastreo, consulta Configuración de Datadog APM.

Para la configuración de un contenedor Docker único, instala el Datadog Agent en Elastic Beanstalk utilizando la Personalización avanzada de entorno con archivos de configuración (.ebextensions).

Nota: Esta configuración requiere que tu clave de API se coloque en el directorio .ebextensions, que forma parte del código fuente. Para proteger tu clave de API, utiliza AWS Secret Manager u otra herramienta de gestión de secretos.

1. Crea una carpeta llamada .ebextensions en la raíz de tu paquete de aplicaciones de origen.
2. Descarga 99datadog.config y colócalo en la carpeta .ebextensions.
3. Cambia el valor de api_key dentro de la plantilla de archivo por/etc/datadog-agent/datadog.yaml con tu clave de API Datadog.
4. Cambia el valor de site en /etc/datadog-agent/datadog.yaml por el de tu región Datadog (por ejemplo: ) para asegurarte de que el Agent envía los datos a la localización de Datadog correcta.
5. Fija una versión específica del Agent configurando DD_Agent_VERSION en option_settings para asegurarte de que todos los hosts ejecutan la misma versión del Agent.
6. Despliega tu aplicación con la consola de Elastic Beanstalk, la EB CLI o la AWS CLI.

Puedes añadir parámetros adicionales al Agent en /etc/datadog-agent/datadog.yaml.

Por ejemplo, para habilitar la Monitorización de procesos en vivo:

process_config:
  enabled: "true"

Recopilación de trazas

Para habilitar el rastreo para contenedores Docker individuales:

1. Actualiza la sección /etc/datadog-agent/datadog.yaml del archivo 99datadog.config con apm_non_local_traffic, con el siguiente formato:

   apm_config:
     enabled: "true"
     apm_non_local_traffic: "true"
   

2. Configura las bibliotecas de rastreo para dirigir trazas a la IP de pasarela del puente de red, que por defecto es 172.17.0.1, desde dentro del contenedor de la aplicación. (Si tienes dudas de que esta sea la IP de la pasarela, ejecuta docker inspect <container id> para confirmarlo).

Para todos los lenguajes, define la variable de entorno DD_AGENT_HOST en la IP de pasarela. Alternativamente, para los siguientes lenguajes, define el nombre del host mediante programación:

Python

from ddtrace import tracer

tracer.configure(hostname="172.17.0.1")

Node.js

const tracer = require('dd-trace');

tracer.init({ hostname: "172.17.0.1" });

Ruby

require 'ddtrace'

Datadog.Configurar do |c|
  c.tracer hostname: "172.17.0.1")
end

Go

package main

import (
    "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"
)

func main() {
  tracer.Start(tracer.WithAgentAddr("172.17.0.1"))
  defer tracer.Stop()

  // ...
}

Para múltiples contenedores Docker, utiliza el Datadog Agent contenedorizado para monitorizar el uso de Docker con un archivo llamado Dockerrun.aws.json.

Un archivo Dockerrun.aws.json es un archivo JSON específico de Elastic Beanstalk que describe cómo desplegar un conjunto de contenedores Docker como una aplicación Elastic Beanstalk. Puede utilizar este archivo para un multicontenedor Docker entorno . Dockerrun.aws.json describe los contenedores que se deben implementar en cada instancia Contenedor del entorno y los volúmenes de datos que se deben crear en la instancia host para que se monten los contenedores.

Un archivo Dockerrun.aws.json se puede utilizar solo o comprimido con código fuente adicional en un único archivo. El código fuente que se archiva con Dockerrun.aws.json se despliega en instancias de contenedor y es accesible en el directorio /var/app/current/. Utiliza la sección volumes de la configuración para proporcionar puntos de montaje para los contenedores que se ejecutan en la instancia y la sección mountPoints de las definiciones de contenedor integradas para montarlos desde los contenedores.

El siguiente ejemplo de código ilustra un Dockerrun.aws.json declarando el Datadog Agent. Actualiza la sección containerDefinitions con tu clave de API Datadog, etiquetas (tags) (opcional) y cualquier definición adicional de contenedor. Si es necesario, este archivo se puede comprimir con contenido adicional, como se ha descrito anteriormente. Para obtener más información sobre la sintaxis de este archivo, consulta la configuración de Docker multicontenedor.

Notas:

• Para un uso elevado de recursos, es posible que necesites un límite de memoria más alto.
• Para garantizar que todos hosts ejecuten la misma versión Agent, es recomendado cambiar agent:7 a una versión menor específica de la imagenDocker .

{
    "AWSEBDockerrunVersion": 2,
    "volumes": [
        {
            "name": "docker_sock",
            "host": {
                "sourcePath": "/var/run/Docker.sock"
            }
        },
        {
            "name": "proc",
            "host": {
                "sourcePath": "/proc/"
            }
        },
        {
            "name": "cgroup",
            "host": {
                "sourcePath": "/cgroup/"
            }
        }
    ],
    "containerDefinitions": [
        {
            "name": "dd-Agent",
            "image": "gcr.io/datadoghq/Agent:7",
            "entorno": [
                {
                    "name": "DD_API_KEY",
                    "value": "<YOUR_DD_API_KEY>"
                },
                {
                    "name": "DD_SITE",
                    "value": "<YOUR_DD_SITE>"
                },
                {
                    "name": "DD_TAGS",
                    "value": "<SIMPLE_TAG>, <KEY:VALUE_TAG>"
                }
            ],
            "memoria": 256,
            "mountPoints": [
                {
                    "sourceVolume": "docker_sock",
                    "containerPath": "/var/run/Docker.sock",
                    "readOnly": false
                },
                {
                    "sourceVolume": "proc",
                    "containerPath": "/host/proc",
                    "readOnly": true
                },
                {
                    "sourceVolume": "cgroup",
                    "containerPath": "/host/sys/fs/cgroup",
                    "readOnly": true
                }
            ]
        }
    ]
}

Creación del entorno

Una vez que la definición del contenedor esté lista, envíala a Elastic Beanstalk. Para obtener instrucciones específicas, consulta los entornos Docker multicontenedor en la documentación de AWS Elastic Beanstalk.

DogStatsD

Para recopilar métricas personalizadas de tu contenedor de aplicación utilizando DogStatsD en el entorno Docker multicontenedor, añade lo siguiente a tu Dockerrun.aws.json:

1. Añada la variable entorno DD_DOGSTATSD_NON_LOCAL_TRAFFIC bajo la dd-agent Contenedor :

   {
     "name": "DD_DOGSTATSD_NON_LOCAL_TRAFFIC",
     "value": "true"
   }
   

2. Añada un enlace a dd-agent Contenedor bajo su aplicación Contenedor:

   "links": [ "dd-agent:dd-agent"]
   

Para obtener más información, consulta DogStatsD y Docker.