Edita tu datadog-agent.yaml para establecer features.apm.enabled en true.

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    credentials:
      apiKey: <DATADOG_API_KEY>

  features:
    apm:
      enabled: true
      unixDomainSocketConfig:
        path: /var/run/datadog/apm.socket # default

Cuando APM está habilitado, la configuración predeterminada crea un directorio en el host y lo monta dentro del Agente. El Agente luego crea y escucha en un archivo de socket /var/run/datadog/apm/apm.socket. Los pods de la aplicación pueden montar este volumen de manera similar y escribir en este mismo socket. Puedes modificar la ruta y el socket con el valor de configuración features.apm.unixDomainSocketConfig.path.

After making your changes, apply the new configuration by using the following command:

kubectl apply -n $DD_NAMESPACE -f datadog-agent.yaml

Nota: En minikube, puedes recibir un Unable to detect the kubelet URL automatically error. En este caso, establece global.kubelet.tlsVerify en false.

Si usaste Helm para instalar el Datadog Agent, APM está habilitado por defecto a través de UDS o tubería nombrada de Windows.

Para verificar, asegúrate de que datadog.apm.socketEnabled esté establecido en true en tu datadog-values.yaml.

datadog:
  apm:
    socketEnabled: true    

La configuración predeterminada crea un directorio en el host y lo monta dentro del Datadog Agent. El Datadog Agent luego crea y escucha en un archivo de socket /var/run/datadog/apm.socket. Los pods de la aplicación pueden montar este volumen de manera similar y escribir en este mismo socket. Puedes modificar la ruta y el socket con los valores de configuración datadog.apm.hostSocketPath y datadog.apm.socketPath.

datadog:
  apm:
    # the following values are default:
    socketEnabled: true
    hostSocketPath: /var/run/datadog/
    socketPath: /var/run/datadog/apm.socket

Para deshabilitar APM, establece datadog.apm.socketEnabled en false.

After making your changes, upgrade your Datadog Helm chart using the following command:

helm upgrade -f datadog-values.yaml <RELEASE NAME> datadog/datadog

Nota: En minikube, puedes recibir un Unable to detect the kubelet URL automatically error. En este caso, establece datadog.kubelet.tlsVerify en false.

El Datadog Admission Controller es un componente del Datadog Cluster Agent que simplifica la configuración de tus pods de aplicación. Aprende más leyendo la documentación del Datadog Admission Controller.

Utiliza el Datadog Admission Controller para inyectar variables de entorno y montar los volúmenes necesarios en nuevos pods de aplicación, configurando automáticamente la comunicación de trazas entre el pod y el Datadog Agent. Aprende cómo configurar automáticamente tu aplicación para enviar trazas al Datadog Agent leyendo la documentación de Injecting Libraries Using Datadog Admission Controller.

Si estás enviando trazas al Datadog Agent usando UDS, monta el directorio del host donde se encuentra el socket (que creó el Datadog Agent) en el contenedor de la aplicación y especifica la ruta al socket con DD_TRACE_AGENT_URL:

apiVersion: apps/v1
kind: Deployment
#(...)
    spec:
      containers:
      - name: "<CONTAINER_NAME>"
        image: "<CONTAINER_IMAGE>/<TAG>"
        env:
        - name: DD_TRACE_AGENT_URL
          value: 'unix:///var/run/datadog/apm.socket'
        volumeMounts:
        - name: apmsocketpath
          mountPath: /var/run/datadog
        #(...)
      volumes:
        - hostPath:
            path: /var/run/datadog/
          name: apmsocketpath

Configura tus SDKs de aplicación para emitir trazas:

Después de configurar tu Datadog Agent para recolectar trazas y dar a tus pods de aplicación la configuración sobre dónde enviar trazas, instala el SDK de Datadog en tus aplicaciones para emitir las trazas. Una vez hecho esto, el SDK envía las trazas al DD_TRACE_AGENT_URL punto de conexión apropiado.

Si estás enviando trazas al Datadog Agent usando TCP (<IP_ADDRESS>:8126), proporciona esta dirección IP a tus pods de aplicación—ya sea automáticamente con el Datadog Admission Controller, o manualmente usando la API descendente para obtener la IP del host. El contenedor de la aplicación necesita la variable de entorno DD_AGENT_HOST que apunta a status.hostIP:

apiVersion: apps/v1
kind: Deployment
#(...)
    spec:
      containers:
      - name: "<CONTAINER_NAME>"
        image: "<CONTAINER_IMAGE>/<TAG>"
        env:
          - name: DD_AGENT_HOST
            valueFrom:
              fieldRef:
                fieldPath: status.hostIP

Nota: Esta configuración requiere que el Datadog Agent esté configurado para aceptar trazas a través de TCP

Configura tus SDKs de aplicación para emitir trazas:

Después de configurar el Datadog Agent para recolectar trazas y dar a tus pods de aplicación la configuración sobre dónde enviar trazas, instala el Datadog SDK en tus aplicaciones para emitir las trazas. Una vez hecho esto, el SDK envía automáticamente las trazas al DD_AGENT_HOST punto de conexión apropiado.

Actualice su datadog-agent.yaml con lo siguiente:

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    credentials:
      apiKey: <DATADOG_API_KEY>

  features:
    apm:
      enabled: true
      hostPortConfig:
        enabled: true
        hostPort: 8126 # default

After making your changes, apply the new configuration by using the following command:

kubectl apply -n $DD_NAMESPACE -f datadog-agent.yaml

Advertencia: El parámetro hostPort abre un puerto en su host. Asegúrese de que su firewall solo permita el acceso desde sus aplicaciones o fuentes de confianza. Si su complemento de red no admite hostPorts, agregue hostNetwork: true en las especificaciones del pod del Datadog Agent. Esto comparte el espacio de nombres de red de su host con el Datadog Agent. Esto también significa que todos los puertos abiertos en el contenedor están abiertos en el host. Si un puerto se utiliza tanto en el host como en su contenedor, hay un conflicto (ya que comparten el mismo espacio de nombres de red) y el pod no se inicia. Algunas instalaciones de Kubernetes no permiten esto.

Actualice su archivo datadog-values.yaml con la siguiente configuración de APM:

datadog:
  apm:
    portEnabled: true
    port: 8126 # default

After making your changes, upgrade your Datadog Helm chart using the following command:

helm upgrade -f datadog-values.yaml <RELEASE NAME> datadog/datadog

Advertencia: El parámetro datadog.apm.portEnabled abre un puerto en su host. Asegúrese de que su firewall solo permita el acceso desde sus aplicaciones o fuentes de confianza. Si su complemento de red no admite hostPorts, agregue hostNetwork: true en las especificaciones del pod del Datadog Agent. Esto comparte el espacio de nombres de red de su host con el Datadog Agent. Esto también significa que todos los puertos abiertos en el contenedor están abiertos en el host. Si un puerto se utiliza tanto en el host como en su contenedor, hay un conflicto (ya que comparten el mismo espacio de nombres de red) y el pod no se inicia. Algunas instalaciones de Kubernetes no permiten esto.

Establezca variables de entorno adicionales de APM bajo override.nodeAgent.containers.trace-agent.env:

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  override:
    nodeAgent:
      containers:
        trace-agent:
          env:
            - name: <ENV_VAR_NAME>
              value: <ENV_VAR_VALUE>

Establezca variables de entorno adicionales de APM bajo agents.containers.traceAgent.env:

agents:
  containers:
    traceAgent:
      env:
        - name: <ENV_VAR_NAME>
          value: <ENV_VAR_VALUE>

Agregue variables de entorno al DaemonSet o Despliegue (para el Datadog Cluster Agent).

apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: datadog
spec:
  template:
    spec:
      containers:
        - name: agent
          ...
          env:
            - name: <ENV_VAR_NAME>
              value: <ENV_VAR_VALUE>