Un servicio puede manejar una variedad de solicitudes, algunas de las cuales puede que no quieras que se rastreen o se incluyan en métricas de trazas (traces). Un ejemplo de esto son, posiblemente, las comprobaciones de estado en una aplicación web.

Hay dos formas de especificar que un punto de conexión de este tipo no debe rastrearse y debe excluirse de las métricas de trazas:

• configuración de Trace Agent (en Datadog Agent) o bien
• configuración del rastreador.

Si necesitas asistencia, ponte en contacto con soporte técnico de Datadog.

Opciones de configuración de Trace Agent

El componente Trace Agent dentro del Datadog Agent tiene dos métodos para evitar que aparezcan ciertas trazas: ignorar etiquetas (tags) de tramos (spans) o ignorar recursos. Si se descartan trazas debido a esta configuración, las métricas de trazas excluyen estas solicitudes.

La configuración del Trace Agent para ignorar ciertos tramos o recursos se aplica a todos los servicios que envían trazas a este Datadog Agent particular. Si tienes requisitos específicos de la aplicación, utiliza, en su lugar, el método de configuración del rastreador.

Ignorar en función de las etiquetas de tramos

Empezando con el Datadog Agent 6.27.0/7.27.0, la opción filtrar etiquetas descarta trazas con tramos de raíz que coincidan con etiquetas de tramos especificadas. Esta opción se aplica a todos los servicios que envían trazas a este Datadog Agent particular. Las trazas que se descartan debido al filtro de etiquetas no se incluyen en las métricas de trazas.

Si puedes identificar mediante programación un conjunto de trazas que sabes que no quieres enviar a Datadog y ninguna otra opción de esta guía resuelve tu necesidad, puedes considerar la posibilidad de añadir una etiqueta de tramo personalizada para poder descartar las trazas. Ponte en contacto con el servicio de soporte técnico para tratar tu caso de uso con más detalle, de modo que Datadog pueda seguir ampliando esta funcionalidad.

La opción de filtro de etiquetas requiere una coincidencia exacta de las cadenas. Si tu caso de uso requiere ignorar por regex, consulta Ignorar en función de los recursos.

Puedes especificar etiquetas de tramos para requerir o rechazar utilizando un lista de claves y valores separados por espacios en variables de entornos:

DD_APM_FILTER_TAGS_REQUIRE

Recopila solo las trazas que tienen tramos de raíz con una coincidencia exacta con las etiquetas de tramos y valores especificados. Si no coincide con esta regla, se descarta la traza. Por ejemplo, DD_APM_FILTER_TAGS_REQUIRE="key1:value1 key2:value2". En Datadog Agent 7.49+, las expresiones regulares pueden estar provistas de DD_APM_FILTER_TAGS_REGEX_REQUIRE.

DD_APM_FILTER_TAGS_REJECT

Rechaza trazas que tienen tramos de raíz con una coincidencia exacta con las etiquetas de tramos y valores especificados. Si coincide con esta regla, se descarta la traza. Por ejemplo, DD_APM_FILTER_TAGS_REJECT="key1:value1 key2:value2". En Datadog Agent 7.49+, las expresiones regulares pueden estar provistas de DD_APM_FILTER_TAGS_REGEX_REJECT.

apm_config:
  filter_tags:
    requerir: ["db:sql", "db.instance:mysql"]
    rechazar: ["outcome:success", "key2:value2"]

apm_config:
  filter_tags:
    rechazar: ["http.url:http://localhost:5050/healthcheck"]

apiVersion: datadoghq.com/v2alpha1
clase: DatadogAgent
metadatos:
  nombre: datadog
spec:
  sustituir:
    nodeAgent:
      contenedores:
        trace-agent:
          env:
            - nombre: DD_APM_FILTER_TAGS_REJECT
              valor: tag_key1:tag_val2 tag_key2:tag_val2

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

agentes:
  contenedores:
    traceAgent:
      env:
        - nombre: DD_APM_FILTER_TAGS_REJECT
          valor: tag_key1:tag_val2 tag_key2:tag_val2

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

Mediante el filtrado de trazas de esta manera, se eliminan estas solicitudes de métricas de trazas. Para obtener más información sobre cómo reducir el consumo sin afectar las métricas de trazas, consulta Controles de consumo.

En el backend, Datadog crea y añade las siguientes etiquetas de tramos a tramos después del consumo. Estas etiquetas no pueden utilizarse para descartar trazas en el nivel del Datadog Agent .

Comunicaciones de red

Solicitudes HTTP

Base de datos

Cola de mensajes

Llamadas a procedimientos remotos

Errores

Ignorar en función de los recursos

La opción ignorar recursos permite excluir recursos si el tramo de raíz global de la traza coincide con determinados criterios. Consulta Excluir recursos de la recopilación. Esta opción se aplica a todos los servicios que envían trazas a este Datadog Agent particular. Las trazas que se descartan porque se ignoran recursos no se incluyen en las métricas de trazas.

Puedes especificar los recursos que deseas ignorar en el archivo de configuración del Agent, datadog.yaml o con la variable de entorno DD_APM_IGNORE_RESOURCES. Consulta los ejemplos siguientes.

apm_config:
## @param ignore_resources - lista de cadenas - opcional
## Se puede proporcionar un lista de expresiones regulares para excluir determinados trazas en función del nombre del recurso.
## Todas las entradas deben ir entre comillas dobles y separadas por comas.

  ignore_resources: ["(GET|POST) /healthcheck","API::NotesController#index"]

Notas:

• La sintaxis expresiones regulares que acepta el Trace Agent se evalúa con regexp de Go.
• Según cuál sea tu estrategia de despliegue, puedes tener que ajustar la expresión regular escapando caracteres especiales.
• Si utilizas contenedores dedicados con Kubernetes, asegúrate de que la variable de entorno para la opción de ignorar recursos se esté aplicando al contenedor del Trace-Agent Contenedor.

Ejemplo

Considera una traza que contiene llamadas a /api/healthcheck desde la cual no deseas trazas:

Toma nota del nombre del recurso del tramo de raíz global.

• Nombre de la operación: rack.request
• Nombre del recurso: Api::HealthchecksController#index
• Http.url: /api/healthcheck

Para utilizar correctamente la opción de ignorar recurso, la regla de la expresión regular escrita debe coincidir con el nombre del recurso, Api::HealthchecksController#index. Hay varias opciones de expresiones regulares posibles, pero para filtrar trazas desde este recurso tal como está, una posible expresión regular es Api::HealthchecksController#index$.

Según tu forma de despliegue, la sintaxis será un poco diferente:

apm_config:
  ignore_resources: Api::HealthchecksController#index$

apm_config:
  ignore_resources: ["value1", "Api::HealthchecksController#index$"]

   entorno:
      // otras variables de entorno del Datadog Agent 
      - DD_APM_IGNORE_RESOURCES=Api::HealthchecksController#index$$

   entorno:
      // otras variables de entorno del Datadog Agent
      - DD_APM_IGNORE_RESOURCES="value1","Api::HealthchecksController#index$$"

docker run -d --name datadog-agent \
              --cgroupns host \
              --pid host \
              -v /var/run/docker.sock:/var/run/docker.sock:ro \
              -v /proc/:/host/proc/:ro \
              -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
              -e DD_API_KEY=<> \
              -e DD_APM_IGNORE_RESOURCES="Api::HealthchecksController#index$" \
              -e DD_APM_ENABLED=true \
              -e DD_APM_NON_LOCAL_TRAFFIC=true \
              gcr.io/datadoghq/agent:latest

              -e DD_APM_IGNORE_RESOURCES=["value1","Api::HealthchecksController#index$"] \

    - nombre: trace-agent
        imagen: "gcr.io/datadoghq/agent:latest"
        imagePullPolicy: IfNotPresent
        comando: ["trace-agent", "-config=/etc/datadog-agent/datadog.yaml"]
        recursos: {}
        puertos:
        - containerPort: 8126
          hostPort: 8126
          nombre: traceport
          protocolo: TCP
        env:
        - nombre: DD_API_KEY
          valueFrom:
            secretKeyRef:
              nombre: "datadog-secret"
              clave: api-key
        - nombre: DD_KUBERNETES_KUBELET_HOST
          valueFrom:
            fieldRef:
              fieldPath: status.hostIP
        - nombre: KUBERNETES
          valor: "yes"
        - nombre: DOCKER_HOST
          valor: unix:///host/var/run/docker.sock
        - nombre: DD_LOG_LEVEL
          valor: "INFO"
        - nombre: DD_APM_ENABLED
          valor: "true"
        - nombre: DD_APM_NON_LOCAL_TRAFFIC
          valor: "true"
        - nombre: DD_APM_RECEIVER_PORT
          valor: "8126"
        - nombre: DD_KUBELET_TLS_VERIFY
          valor: "false"
        - nombre: DD_APM_IGNORE_RESOURCES
          valor: "Api::HealthchecksController#index$"

        - nombre: DD_APM_IGNORE_RESOURCES
          valor: '"value1","Api::HealthchecksController#index$"'

    traceAgent:
      # agents.containers.traceAgent.env -- Variables de entorno adicionales para el contenedor de trace-agent
      env:
        - nombre: DD_APM_IGNORE_RESOURCES
          valor: Api::HealthchecksController#index$

        - nombre: DD_APM_IGNORE_RESOURCES
          valor: value1, Api::HealthchecksController#index$

helm install dd-agent -f values.yaml \
  --configurar datadog.apiKeyExistingSecret="datadog-secret" \
  --configurar agents.containers.traceAgent.env[0].name=DD_APM_IGNORE_RESOURCES, \
    agents.containers.traceAgent.env[0].value="Api::HealthchecksController#index$" \
  datadog/datadog

    "entorno": [
    // otras variables de entorno para el Datadog Agent
        {
          "nombre": "DD_APM_IGNORE_RESOURCES",
          "valor": "Api::HealthchecksController#index$"
        }
     ]

Opciones de configuración del rastreador

Algunos de los rastreadores específicos del lenguaje tienen una opción para modificar tramos antes de que se envíen al Datadog Agent. Utiliza esta opción si tienes requisitos específicos de la aplicación y utilizas uno de los lenguajes que se enumeran a continuación.

Datadog::Tracing.before_flush(
   Datadog::Tracing::Pipeline::SpanFilter.new {|span| span.resource =~ /Api::HealthchecksController#index/}
)

desde ddtrace importa el rastreador
desde ddtrace.filters importa FilterRequestsOnUrl
tracer.configure(settings={
    'FILTROS': [
        FilterRequestsOnUrl(r'http://.*/healthcheck$'),
    ],
})

const tracer = require('dd-trace').init();
tracer.use('http', {
  // las solicitudes http entrantes coinciden en la ruta
  servidor: {
    lista de bloqueados: ['/healthcheck']
  },
  // las solicitudes http salientes coinciden en una URL completa
  cliente: {
    lista de bloqueados: ['https://telemetry.example.org/api/v1/record']
  }
})

//importar http

clase pública GreetingController {
   estático {
       // En un bloque estático de clase para evitar initializar muchas veces.
       GlobalTracer.get().addTraceInterceptor(new TraceInterceptor() {
           @Override
           public Collection<? extends MutableSpan> onTraceComplete(Collection<? amplía MutableSpan> traza) {
               para (tramo MutableSpan : traza) {
                   si ("OBTENER /healthcheck".contentEquals(span.getResourceName())) {
                       devolver Collections.emptyList();
                   }
               }
               devolver traza;
           }
           @Override
           prioridad int pública() {
               devolver 200;  // Algún número único
           }
       });
   }
}