Instrumentación de un solo paso para el seguimiento de errores de backend

Información general

Instala o actualiza el Datadog Agent con las opciones Habilitar la Instrumentación APM y Seguimiento de errores independiente para habilitar el seguimiento de errores de backend independiente. Esta acción te permite instrumentar automáticamente tu aplicación, sin ningún paso adicional de instalación o configuración.

Instalar el Seguimiento de errores de backend independiente

Los siguientes ejemplos muestran cómo funciona para cada tipo de despliegue.

    Para un host Linux:

    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,php:1" DD_APM_ERROR_TRACKING_STANDALONE=true 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).

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

    Puedes activar el Seguimiento de errores de backend instalando el Agent con cualquiera de las dos opciones:

    • Datadog Operator
    • Helm Chart Datadog
    La Instrumentación de un solo paso no instrumenta aplicaciones en el espacio de nombres donde instalas el Datadog Agent. Se recomienda instalar el Agent en un espacio de nombres separado en tu clúster, donde no ejecutes tus aplicaciones.

    Requisitos

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

    Sigue los pasos a continuación para habilitar la Instrumentación de un solo paso en todo tu clúster utilizando el Datadog Operator. Esto permite el rastreo en todas las aplicaciones escritas en lenguajes compatibles.

    1. Instala el Datadog Operator v1.14.0 o posterior con Helm:
      helm repo add datadog https://helm.datadoghq.com
helm repo update
helm install my-datadog-operator datadog/datadog-operator
    2. Crea un secreto de Kubernetes para almacenar tu clave de API Datadog:
      kubectl create secret generic datadog-secret --from-literal api-key=<YOUR_DD_API_KEY>
    3. Crea datadog-agent.yaml con las especificaciones de configuración del despliegue de tu Datadog Agent. La siguiente configuración es la más sencilla:
      apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    site: <DATADOG_SITE>
    tags:
      - env:<AGENT_ENV>
    credentials:
      apiSecret:
        secretName: datadog-secret
        keyName: api-key
    env:
      - name: DD_CORE_AGENT_ENABLED
        value: "false"
  features:
    apm:
      errorTrackingStandalone:
        enabled: true
      instrumentation:
        enabled: true
        libVersions:
          java: "1"
          dotnet: "3"
          python: "2"
          js: "5"
          php: "1"
      Sustituye <DATADOG_SITE> por tu sitio Datadog y <AGENT_ENV> por el entorno en el que está instalado tu Agent (por ejemplo, env:staging).
    4. Ejecuta el siguiente comando:
      kubectl apply -f /path/to/your/datadog-agent.yaml
    5. Espera unos minutos a que se apliquen los cambios del Datadog Cluster Agent y reinicia tus aplicaciones.

    Sigue los pasos a continuación para habilitar la Instrumentación de un solo paso en todo tu clúster utilizando Helm. Esto permite el rastreo en todas las aplicaciones escritas en lenguajes compatibles.

    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 tu clave de API Datadog:
      kubectl create secret generic datadog-secret --from-literal api-key=<YOUR_DD_API_KEY>
    3. Crea datadog-values.yaml y añade la siguiente configuración:
      agents:
  containers:
    agent:
      env:
        - name: DD_CORE_AGENT_ENABLED
          value: "false"
datadog:
  processAgent:
    enabled: false
    containerCollection: false
  apiKeyExistingSecret: datadog-secret
  site: <DATADOG_SITE>
  tags:
    - env:<AGENT_ENV>
  apm:
    errorTrackingStandalone:
      enabled: true
    # Required to enable Single-Step Instrumentation
    instrumentation:
      enabled: true
      libVersions:
        java: "1"
        dotnet: "3"
        python: "2"
        js: "5"
        php: "1"
      Sustituye <DATADOG_SITE> por tu sitio Datadog y <AGENT_ENV> por el entorno en el que está instalado tu Agent (por ejemplo, env:staging).
    4. Ejecuta el siguiente comando para desplegar el Agent:
      helm install datadog-agent -f datadog-values.yaml datadog/datadog
    5. Espera unos minutos a que se apliquen los cambios del Datadog Cluster Agent y reinicia tus aplicaciones.

    Referencias adicionales

    Más enlaces, artículos y documentación útiles:

    Estados de problemas y flujos de trabajo de Error TrackingDOCUMENTACIÓN more more Más información sobre el Explorador de seguimiento de erroresDOCUMENTACIÓN more more Activar la monitorización de infraestructurasGUÍA more more Activar APMGUÍA more more