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:2,js:5,dotnet:3" DD_ENV=<AGENT_ENV> bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
   

   Sustituye <YOUR_DD_API_KEY> por tu clave de API Datadog, <YOUR_DD_SITE> por tu sitio Datadog y <AGENT_ENV> por el entorno en el que está instalado tu Agent (por ejemplo, staging).

   Para ver más opciones, consulta Opciones avanzadas.

2. Inicia una nueva sesión de shell.

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

Para un contenedor Linux Docker:

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

   DD_APM_INSTRUMENTATION_ENABLED=docker DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:2,js:5,dotnet:3" DD_NO_AGENT_INSTALL=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_ENV=<AGENT_ENV> \
     -e DD_APM_NON_LOCAL_TRAFFIC=true \
     -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true \
     -e DD_APM_RECEIVER_SOCKET=/var/run/datadog/apm.socket \
     -e DD_DOGSTATSD_SOCKET=/var/run/datadog/dsd.socket \
     -v /var/run/datadog:/var/run/datadog \
     -v /var/run/docker.sock:/var/run/docker.sock:ro \
     gcr.io/datadoghq/agent:7
   

   Sustituye <YOUR_DD_API_KEY> por tu clave de API Datadog y <AGENT_ENV> por el entorno en el que está instalado tu Agent (por ejemplo, staging).
   Para ver más opciones, consulta Opciones avanzadas.
3. Reinicia los contenedores Docker.
4. Explora la observabilidad del rendimiento de tus servicios en Datadog.

Puedes habilitar APM instalando el Agent con cualquiera de las dos opciones:

• Datadog Operator
• Helm Chart Datadog

Requisitos

• Kubernetes v1.20 y posterior
• Helm para desplegar el Datadog Operator.
• CLI Kubectl para instalar el Datadog Agent.

DD_APM_INSTRUMENTATION_LIBRARIES: personalizar bibliotecas de APM

Por defecto, las bibliotecas de Datadog APM para Java, Python, Ruby, Node.js y .NET Core se instalan cuando se establece DD_APM_INSTRUMENTATION_ENABLED. DD_APM_INSTRUMENTATION_LIBRARIES se utiliza para anular qué bibliotecas se instalan. El valor es una cadena separada por comas de pares de nombres y versiones de biblioteca separados por dos puntos.

Valores de ejemplo para DD_APM_INSTRUMENTATION_LIBRARIES:

• DD_APM_INSTRUMENTATION_LIBRARIES="java:1": instala sólo la biblioteca de Datadog APM para Java fijada a la línea de lanzamiento de la versión principal 1.
• DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:2": instala sólo las bibliotecas de Datadog APM para Java y Python fijadas a las versiones principales 1 y 2 respectivamente.
• DD_APM_INSTRUMENTATION_LIBRARIES="java:1.38.0,python:2.10.5": instala sólo las bibliotecas de Datadog APM para Java y Python fijadas a las versiones específicas 1.38.0 y 2.10.5 respectivamente.

Las versiones disponibles figuran en los repositorios fuentes de cada lenguaje:

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

DD_APM_INSTRUMENTATION_LIBRARIES: personaliza bibliotecas de APM

Por defecto, las bibliotecas de Datadog APM para Java, Python, Ruby, Node.js y .NET Core se instalan cuando se establece DD_APM_INSTRUMENTATION_ENABLED. DD_APM_INSTRUMENTATION_LIBRARIES se utiliza para anular qué bibliotecas se instalan. El valor es una cadena separada por comas de pares de nombres y versiones de biblioteca separados por dos puntos.

Valores de ejemplo para DD_APM_INSTRUMENTATION_LIBRARIES:

• DD_APM_INSTRUMENTATION_LIBRARIES="java:1": instala sólo la biblioteca de Datadog APM para Java fijada a la línea de lanzamiento de la versión principal 1.
• DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:2": instala sólo las bibliotecas de Datadog APM para Java y Python fijadas a las versiones principales 1 y 2 respectivamente.
• DD_APM_INSTRUMENTATION_LIBRARIES="java:1.38.0,python:2.10.5": instala sólo las bibliotecas de Datadog APM para Java y Python fijadas a las versiones específicas 1.38.0 y 2.10.5 respectivamente.

Las versiones disponibles figuran en los repositorios fuentes de cada lenguaje:

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

Habilitar o deshabilitar la instrumentación para espacios de nombres

Puedes elegir habilitar o deshabilitar la instrumentación para aplicaciones en espacios de nombres específicos. Sólo puedes definir espacios de nombres habilitados o espacios de nombres deshabilitados, no ambos.

El archivo que tienes que configurar depende de si has habilitado la instrumentación de un solo paso con el Datadog Operator o con Helm:

   features:
     apm:
       instrumentation:
         enabled: true
         enabledNamespaces: # Add namespaces to instrument
           - default
           - applications

   features:
     apm:
       instrumentation:
         enabled: true
         disabledNamespaces: # Add namespaces to not instrument
           - default
           - applications

   datadog:
      apm:
        instrumentation:
          enabled: true
          enabledNamespaces: # Añadir espacios de nombres que se van a instrumentar
             - namespace_1
             - namespace_2

   datadog:
      apm:
        instrumentation:
          enabled: true
          disabledNamespaces: # Añadir espacios de nombres que no se van a instrumentar
            - namespace_1
            - namespace_2

Especificación de versiones de bibliotecas de rastreo

Especifica bibliotecas de rastreo de Datadog y sus versiones para instrumentar automáticamente las aplicaciones escritas en esos lenguajes. Puedes configurarlo de dos maneras, que se aplican en el siguiente orden de precedencia:

1. Especificarlas a nivel del servicio o bien
2. Especificarlas a nivel del clúster.

Por defecto: Si no especificas ninguna versión de biblioteca yapm.instrumentation.enabled=true, las aplicaciones escritas en los lenguajes soportados se instrumentan automáticamente utilizando las últimas versiones de bibliotecas de rastreo.

Especificación a nivel del servicio

Para instrumentar automáticamente aplicaciones en pods específicos, añade la anotación de lenguaje y la versión de biblioteca adecuadas para tu aplicación en la especificación de tu pod:

Sustituye <CONTAINER IMAGE TAG> por la versión de biblioteca deseada. Las versiones disponibles se enumeran en los registros de contenedores de Datadog y en los repositorios de orígenes de rastreadores para cada lenguaje:

• Java
• Node.js
• Python
• .NET
• Ruby

Por ejemplo, para instrumentar aplicaciones Java automáticamente:

apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    # ...
spec:
  template:
    metadata:
      annotations:
        admission.datadoghq.com/java-lib.version: "<CONTAINER IMAGE TAG>"
    spec:
      containers:
        - # ...

Especificación a nivel del clúster

Si no habilitas la instrumentación automática para pods específicos utilizando las anotaciones, puedes especificar qué lenguajes instrumentar en todo el clúster utilizando la configuración de la instrumentación de un solo paso. Cuando se define apm.instrumentation.libVersions, sólo se instrumentan las aplicaciones escritas en los lenguajes especificados, utilizando las versiones de biblioteca especificadas.

El archivo que tienes que configurar depende de si has habilitado la instrumentación de un solo paso con el Datadog Operator o con Helm:

   features:
     apm:
       instrumentation:
         enabled: true
         libVersions: # Add any libraries and versions you want to set
            dotnet: "3.2.0"
            python: "1.20.6"
            js: "4.17.0"

   datadog:
     apm:
       instrumentation:
         enabled: true
         libVersions: # Add any libraries and versions you want to set
            dotnet: "3.2.0"
            python: "1.20.6"
            js: "4.17.0"

Registros de contenedores

Datadog publica imágenes de bibliotecas de instrumentación en gcr.io, Docker Hub y Amazon ECR:

La variable de entorno DD_ADMISSION_CONTROLLER_AUTO_INSTRUMENTATION_CONTAINER_REGISTRY en la configuración del Datadog Cluster Agent especifica el registro utilizado por el controlador de admisión. El valor por defecto es gcr.io/datadoghq.

Puedes extraer la biblioteca de rastreo de un registro diferente cambiándolo por docker.io/datadog, public.ecr.aws/datadog u otra URL, si alojas las imágenes en un registro de contenedores local.

Para obtener instrucciones sobre cómo cambiar el registro de contenedores, consulta Para cambiar tu registro de contenedores.

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.

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.

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"
   

2. Aplica la configuración:

   kubectl apply -f /path/to/your/deployment.yaml
   

3. Reinicia los servicios de los que quieres eliminar la instrumentación.

1. Ejecuta:

   dd-host-install --uninstall
   

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

1. Ejecuta:

   dd-container-install --uninstall
   

2. Reinicia Docker:

   systemctl restart docker
   

   O utiliza el equivalente para tu entorno.

El archivo que tienes que configurar depende de si has habilitado la instrumentación de un solo paso con el Datadog Operator o con Helm: