Con un solo comando, puedes instalar, configurar e iniciar el Agent, al tiempo que instrumentas tus servicios con AAP.

Para un host Ubuntu:

1. Ejecuta el comando de instalación de una línea:

   DD_API_KEY=<YOUR_DD_API_KEY> DD_SITE="<YOUR_DD_SITE>" DD_APM_INSTRUMENTATION_ENABLED=host DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:3,js:5,dotnet:3,php:1" DD_APPSEC_ENABLED=true bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
   

   a. Sustituye <YOUR_DD_API_KEY> por tu clave de API de Datadog.

   b. Sustituye <YOUR_DD_SITE> por tu sitio de Datadog.

   You can also optionally configure the following:

   • Specifying tracing library versions.
   • Tagging observability data by environment.

2. Sal de la sesión de shell actual.

3. Inicia una nueva sesión de shell.

4. Reinicia los servicios en el host o la máquina virtual.

5. Explora la observabilidad del rendimiento de tus servicios en Datadog.

Nota: Para configurar un solo step (UI) / paso (generic) para la protección contra amenazas de AAP, añade la variable de entorno DD_APPSEC_ENABLED=true a tu comando de instalación de una línea.

Especificación de las versiones de biblioteca de rastreo

En forma predeterminada, al activar APM en tu servidor se instala la compatibilidad con los servicios de Java, Python, Node.js y .NET Core. Si sólo tienes servicios implementados en algunos de estos lenguajes, configura DD_APM_INSTRUMENTATION_LIBRARIES en tu comando de instalación de una línea:

DD_APM_INSTRUMENTATION_LIBRARIES="java:1.25.0,python" DD_API_KEY=<YOUR_DD_API_KEY> DD_SITE="<YOUR_DD_SITE>" DD_APM_INSTRUMENTATION_ENABLED=host DD_APPSEC_ENABLED=true DD_ENV=staging bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

Opcionalmente, puedes proporcionar un número de versión para la biblioteca de rastreo colocando dos puntos después del nombre del leguaje y especificando la versión de la biblioteca de rastreo. Si no especificas una versión, se utilizará por defecto la versión más reciente. Los nombres de lenguaje están separados por comas.

Los lenguajes admitidos son:

• .NET (dotnet)
• Python (python)
• Java (java)
• Node.js (js)
• PHP (php)

Nota: Para la biblioteca de rastreo Node.js, diferentes versiones de Node.js son compatibles con diferentes versiones de la biblioteca de rastreo Node.js. Consulta DataDog/dd-trace-js: Rastreador de JavaScript APM para obtener más información.

Etiquetado de datos de observabilidad por entorno

Establece DD_ENV en tu comando de instalación de una línea para Linux a fin de etiquetar automáticamente los servicios instrumentados y otra telemetría que pase a través del Agent con un entorno específico. Por ejemplo, si el Agent está instalado en tu entorno de staging, configura DD_ENV=staging para asociar tus datos de observabilidad con staging.

Por ejemplo:

DD_API_KEY=<YOUR_DD_API_KEY> DD_SITE="<YOUR_DD_SITE>" DD_APM_INSTRUMENTATION_ENABLED=host DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:3,js:5,dotnet:3,php:1" DD_APPSEC_ENABLED=true DD_ENV=staging bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

Para un contenedor Linux Docker:

1. Instala el inyector de biblioteca:

   DD_APM_INSTRUMENTATION_ENABLED=docker DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:3,js:5,dotnet:3,php:1" DD_NO_AGENT_INSTALL=true DD_APPSEC_ENABLED=true bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
   

2. Configura el Agent en Docker:

   docker run -d --name dd-agent \
     -e DD_API_KEY=${YOUR_DD_API_KEY} \
     -e DD_APM_ENABLED=true \
     -e DD_APPSEC_ENABLED=true \
     -e DD_APM_NON_LOCAL_TRAFFIC=true \
     -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true \
     -e DD_APM_RECEIVER_SOCKET=/opt/datadog/apm/inject/run/apm.socket \
     -e DD_DOGSTATSD_SOCKET=/opt/datadog/apm/inject/run/dsd.socket \
     -v /opt/datadog/apm:/opt/datadog/apm \
     -v /var/run/docker.sock:/var/run/docker.sock:ro \
     gcr.io/datadoghq/agent:7
   

   Sustituye <YOUR_DD_API_KEY> por tu API de Datadog.
   You can also optionally configure the following:

   • Specifying tracing library versions.
   • Tagging observability data by environment.
3. Reinicia los contenedores Docker.
4. Explora la observabilidad del rendimiento de tus servicios en Datadog.

Especificación de las versiones de biblioteca de rastreo

Por defecto, la habilitación de APM en tu servidor instala el soporte para los servicios Java, Python, Node.js, y .NET. Si solo tienes servicios implementados en algunos de estos lenguajes, configura DD_APM_INSTRUMENTATION_LIBRARIES cuando ejecutes el script de instalación.

Por ejemplo, para instalar el soporte únicamente para la versión v1.25.0 de la biblioteca de rastreo Java y la última versión de la biblioteca de rastreo Python, añade lo siguiente al comando de instalación:

DD_APM_INSTRUMENTATION_LIBRARIES="java:1.25.0,python" DD_APM_INSTRUMENTATION_ENABLED=docker DD_NO_AGENT_INSTALL=true DD_APPSEC_ENABLED=true bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

Opcionalmente, puedes proporcionar un número de versión para la biblioteca de rastreo colocando dos puntos después del nombre del leguaje y especificando la versión de la biblioteca de rastreo. Si no especificas una versión, se utilizará por defecto la versión más reciente. Los nombres de lenguaje están separados por comas.

Los lenguajes admitidos son:

• .NET (dotnet)
• Python (python)
• Java (java)
• Node.js (js)
• Ruby (ruby)
• PHP (php)

Nota: Para la biblioteca de rastreo Node.js, diferentes versiones de Node.js son compatibles con diferentes versiones de la biblioteca de rastreo Node.js. Consulta DataDog/dd-trace-js: Rastreador de JavaScript APM para obtener más información.

Etiquetado de datos de observabilidad por entorno

Establece DD_ENV en el comando de instalación del inyector de biblioteca para que Docker etiquete automáticamente los servicios instrumentados y otra telemetría que pase por el Agent con un entorno específico. Por ejemplo, si el Agent está instalado en tu entorno de staging, configura DD_ENV=staging para asociar los datos de observabilidad con staging.

Por ejemplo:

docker run -d --name dd-agent \
  -e DD_API_KEY=${YOUR_DD_API_KEY} \
  -e DD_APM_ENABLED=true \
  -e DD_APPSEC_ENABLED=true \
  -e DD_ENV=staging \
  -e DD_APM_NON_LOCAL_TRAFFIC=true \
  -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true \
  -e DD_APM_RECEIVER_SOCKET=/opt/datadog/apm/inject/run/apm.socket \
  -e DD_DOGSTATSD_SOCKET=/opt/datadog/apm/inject/run/dsd.socket \
  -v /opt/datadog/apm:/opt/datadog/apm \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  gcr.io/datadoghq/agent:7

Puedes habilitar APM instalando el Agent con el Datadog Helm chart. Esto despliega el Datadog Agent a través de todos los nodos en el clúster de Kubernetes basado en Linux con un DaemonSet.

Nota: La instrumentación de un solo paso no instrumenta aplicaciones en el espacio de nombres donde se instala el Datadog Agent. Se recomienda instalar el Agent en un espacio de nombres separado en un clúster donde no ejecutes tus aplicaciones.

Requisitos

• Asegúrate de tener instalado Helm.

Instalación

Para habilitar la instrumentación de un solo paso con Helm:

1. Añade el repositorio de Datadog Helm:

   helm repo add datadog https://helm.datadoghq.com
   helm repo update
   

2. Crea un secreto de Kubernetes para almacenar la clave de API de Datadog:

   kubectl create secret generic datadog-secret --from-literal api-key=$DD_API_KEY
   

1. Añade la variable de entorno DD_INSTRUMENT_SERVICE_WITH_APM al comando de inicio de servicio:

   DD_INSTRUMENT_SERVICE_WITH_APM=false <service_start_command>
   

2. Reinicia el servicio.
3. Para desactivar AAP, elimina la variable de entorno DD_APPSEC_ENABLED=true de la configuración de tu aplicación y reinicia tu servicio.

1. Añade la variable de entorno DD_INSTRUMENT_SERVICE_WITH_APM al comando de inicio de servicio:

   docker run -e DD_INSTRUMENT_SERVICE_WITH_APM=false <service_start_command>
   

2. Reinicia el servicio.
3. Para desactivar AAP, elimina la variable de entorno DD_APPSEC_ENABLED=true de la configuración de tu aplicación y reinicia tu servicio.

1. Establece la etiqueta admission.datadoghq.com/enabled: en "false" para la especificación del pod:

   spec:
     template:
       metadata:
         labels:
           admission.datadoghq.com/enabled: "false"
   

1. Ejecuta:

   dd-host-install --uninstall
   

2. Reinicia el host.

1. Desinstala la inyección de biblioteca local:

   dd-container-install --uninstall
   

2. Reinicia Docker:

   systemctl restart docker
   

   O utiliza el equivalente para tu entorno.

1. En apm:, elimina instrumentation: y toda la configuración siguiente en datadog-values.yaml.
2. En asm:, elimina threats: y toda la configuración siguiente en datadog-values.yaml.
3. Ejecuta el siguiente comando:

   helm upgrade datadog-agent -f datadog-values.yaml datadog/datadog