Son varios los mecanismos responsables de decidir si los tramos (spans) generados por tus aplicaciones se envían a Datadog (tramos ingeridos). La lógica de estos mecanismos está en las bibliotecas de rastreo y en el Datadog Agent. Según la configuración, el tráfico generado por los servicios instrumentados puede ingerirse de forma total o parcial.

A cada tramo consumido, se le adjunta un motivo de ingesta único en referencia a uno de los mecanismos que se describen en esta página. Las métricas de uso datadog.estimated_usage.apm.ingested_bytes y datadog.estimated_usage.apm.ingested_spans tienen la etiqueta (tag) ingestion_reason.

Utiliza el Dashboard de motivos de ingesta para investigar todos los motivos de ingesta en contexto. Obtén información general sobre el volumen atribuido a cada mecanismo para identificar rápidamente las opciones de configuración pertinentes.

Muestreo basado en la fase inicial

El mecanismo de muestreo que se usa por defecto se denomina head-based sampling (muestreo basado en la fase inicial). La decisión sobre si se conserva o se descarta la traza se toma en el momento preciso en el que esta comienza, al inicio del tramo raíz. Luego, se propaga la decisión a los demás servicios como parte del contexto de la solicitud, por ejemplo, como un encabezado de la solicitud HTTP.

Como la decisión se toma al comienzo de la traza y, luego, se transmite a todas las partes de esta, existe la garantía de que se conservará o descartará la traza completa.

Puedes configurar la frecuencias de muestreo para el muestreo basado en la fase inicial en dos lugares:

• En el Agent (por defecto)
• En la Biblioteca de rastreo: los mecanismos de la biblioteca de rastreo sustituyen a la configuración del Agent.

En el Agent

ingestion_reason: auto

El Datadog Agent envía las frecuencias de muestreo de forma continua a las bibliotecas de rastreo para aplicarlas a la raíz de las trazas. El Agent ajusta las frecuencias para alcanzar el objetivo general de diez trazas por segundo, las cuales se distribuyen entre los servicios en función del tráfico.

Por ejemplo, si el servicio A tiene más tráfico que el servicio B, el Agent podría modificar la frecuencia de muestreo de A para que A no conserve más de siete trazas por segundo y ajustar de un modo similar la frecuencia de muestreo de B para que B no conserve más de tres trazas por segundo, de modo que se obtenga un total de 10 trazas por segundo.

Configuración remota

La configuración de la frecuencia de muestreo en el Agent se puede configurar de forma remota si utilizas el Agent versión 7.42.0 o superior. Para empezar, configura Configuración remota y, a continuación, configura el parámetro ingestion_reason desde la Página de control de la ingesta. La configuración remota te permite cambiar el parámetro sin tener que reiniciar el Agent. La configuración remota tiene prioridad sobre las configuraciones locales, incluidas las variables de entorno y la configuración de datadog.yaml.

Configuración local

Define el objetivo de trazas por segundo del Agent en su archivo principal de la configuración (datadog.yaml) o a modo de variable de entorno:

@param max_traces_per_second - integer - optional - default: 10
@env DD_APM_MAX_TPS - integer - optional - default: 10

Notas:

• La frecuencia de muestreo de trazas por segundo configurada en el Agent solo se aplica a las bibliotecas de rastreo de Datadog. No tiene ningún efecto en otras bibliotecas de rastreo como OpenTelemetry SDK.
• El máximo de trazas por segundo es un objetivo, no un valor fijo. En realidad, fluctúa en función de los picos de tráfico y otros factores.

Todos los tramos de una traza muestreada utilizando el Datadog Agent frecuencias de muestreo calculadas automáticamente se etiquetan con el motivo de la ingesta auto. La etiqueta del ingestion_reason también se configura en las métricas de uso. Los servicios que utilizan el mecanismo por defecto del Datadog Agent se etiquetan como Automatic en la columna de configuración de la Página de control de la ingesta.

En las bibliotecas de rastreo: reglas definidas por el usuario

ingestion_reason: rule

Para llevar a cabo un control más pormenorizado, utiliza las opciones de configuración de muestreo de la biblioteca de rastreo:

• Configura una frecuencia de muestreo específica que se aplicará a la raíz del rastreo, por servicio y/o nombre del recurso, sustituyendo el [mecanismo por defecto] del Agent(#in-the-Agent).
• Configura un límite de frecuencia para restringir el número de trazas ingeridas por segundo. El límite de la frecuencia por defecto es de 100 trazas por segundo por instancia de servicio (cuando se utiliza el mecanismo por defecto del Agent, se omite el limitador de frecuencia).

Nota: Las reglas de muestreo son también controles de muestreo basado en la fase inicial. Si el tráfico para un servicio es superior al máximo configurado de trazas por segundo, entonces las trazas se descartan en la raíz. No se crean trazas incompletas.

La configuración se puede definir a través de las variables de entorno o directamente en el código:

# utilizando la propiedad del sistema
java -Ddd.trace.sampling.rules='[{\"service\": \"my-service\", \"resource\": \"GET /checkout\", \"sample_rate\":1},{\"service\": \"my-service\", \"sample_rate\":0.2}]' -javaagent:dd-java-agent.jar -jar my-app.jar

# utilizando las variables de entorno
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "resource":"GET /checkout", "sample_rate": 1},{"service": "my-service", "sample_rate": 0.2}]'

export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "resource": "GET /checkout", "sample_rate": 1},{"service": "my-service", "sample_rate": 0.2}]'

export DD_TRACE_SAMPLE_RATE=0.1
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "sample_rate": 0.5}]'

export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "resource": "GET /checkout", "sample_rate": 1},{"service": "my-service", "sample_rate": 0.2}]'

tracer.init({
    ingestion: {
        sampler: {
            sampleRate: 0.1,
            rules: [
                { sampleRate: 0.5, service: 'my-service' }
            ]
        }
    }
});

export DD_TRACE_SAMPLE_RATE=0.1
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "sample_rate": 0.5}]'

export DD_TRACE_SAMPLE_RATE=0.1
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "sample_rate": 0.5}]'

export DD_TRACE_SAMPLE_RATE=0.1
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "sample_rate": 0.5}]'

Nota: Todos los tramos de una traza muestreada utilizando una configuración de biblioteca de rastreo se etiquetan con el motivo de la ingesta rule. Los servicios configurados con reglas de muestreo definidas por el usuario se marcan como Configured en la columna de configuración de la Página de control de la ingesta.

Trazas con errores o poco frecuentes

Para las trazas que no se capturan a través del muestreo basado en la fase inicial, existen dos mecanismos de muestreo adicionales del Datadog Agent para asegurar la conservación y la ingesta de trazas críticas y diversas. Estos dos muestreadores conservan un conjunto diverso de trazas locales (conjuntos de tramos del mismo host) mediante la captura de todas las combinaciones de un conjunto predeterminado de etiquetas:

• Trazas con errores: Es importante muestrear los errores, dado que así se pueden observar los posibles errores del sistema.
• Trazas poco frecuentes: Muestrear las trazas poco frecuentes te permite mantener la visibilidad sobre la totalidad del sistema, puesto que te aseguras de que los servicios y recursos con poco tráfico se sigan monitorizando.

Nota: Los muestreadores de trazas con errores o poco frecuentes se omitirán en los servicios en los que hayas configurado las reglas de muestreo de bibliotecas.

Trazas con errores

ingestion_reason: error

El muestreador de trazas con errores captura fragmentos de trazas que contienen tramos con errores no capturados mediante el muestreo basado en la fase inicial. Puedes capturar hasta 10 trazas con errores por segundo (por Agent). Esto garantiza una visibilidad completa de los errores cuando la frecuencia del muestreo basado en la fase inicial es baja.

Con el Agent 7.33 y sus versiones posteriores, puedes configurar el muestreador de errores en el archivo principal de configuración del Agent (datadog.yaml) o con las variables de entorno:

@param errors_per_second - integer - optional - default: 10
@env DD_APM_ERROR_TPS - integer - optional - default: 10

Notas:

1. Establece el parámetro en 0 para desactivar el muestreador de errores.
2. El muestreador de errores captura trazas locales con tramos con errores en el nivel del Agent. Si se distribuye la traza, no hay ninguna garantía de que la traza completa se envíe a Datadog.
3. Por defecto, los tramos descartados mediante las reglas de rastreo de la biblioteca o la lógica personalizada como manual.drop se excluyen en el muestreador de errores.

Datadog Agent 7.42.0 y superior

El muestreo de errores se puede configurar de forma remota si utilizas el Agent versión 7.42.0 o superior. Sigue la documentación para habilitar la configuración remota en tus Agents. Con la configuración remota, puedes habilitar la recopilación de tramos poco frecuentes sin tener que reiniciar el Datadog Agent.

Datadog Agent 6/7.41.0 y superior

Para sustituir el comportamiento por defecto de modo que el muestreador de errores incluya los tramos descartados a través de las reglas de la biblioteca de rastreo o la lógica personalizada como manual.drop, activa la función con: DD_APM_FEATURES=error_rare_sample_tracer_drop en el Datadog Agent (o el contenedor del Trace Agent dedicado en el pod del Datadog Agent en Kubernetes).

Datadog Agent 6/7.33 a 6/7.40.x

El comportamiento por defecto del muestreo de errores no puede modificarse para estas versiones del Agent. Actualiza el Datadog Agent al Datadog Agent 6/7.41.0 y superiores.

Trazas poco frecuentes

ingestion_reason: rare

El muestreador de trazas poco frecuentes envía un conjunto de tramos poco frecuentes a Datadog. Puede capturar hasta 5 trazas por segundo con combinaciones de env, service, name, resource, error.type y http.status (por Agent). Además, garantiza la visibilidad de los recursos con poco tráfico cuando la frecuencia del muestreo basado en la fase inicial es baja.

Nota: El muestreador de trazas poco frecuentes captura las trazas locales en el nivel del Agent. Si la traza se distribuye, no habrá forma de garantizar el envío de la traza completa a Datadog.

Datadog Agent 7.42.0 y superiores

La frecuencia de muestreo de trazas poco frecuentes se puede configurar de forma remota si utilizas el Agent versión 7.42.0 o superior. Sigue la documentación para habilitar la configuración remota en tus Agents. Con la configuración remota, puedes cambiar el valor del parámetro sin tener que reiniciar el Datadog Agent .

Datadog Agent 6/7.41.0 y superiores

Por defecto, el muestreador de trazas poco frecuentes está no activado.

**Nota: Cuando se habilita, los tramos descartados a través de las reglas de la biblioteca de rastreo o la lógica personalizada como manual.drop se excluyen en este muestreador.

Para configurar el muestreador de trazas poco frecuentes, actualiza la configuración apm_config.enable_rare_sampler en el archivo principal de la configuración del Agent (datadog.yaml) o con la variable de entorno DD_APM_ENABLE_RARE_SAMPLER :

@params apm_config.enable_rare_sampler - boolean - optional - default: false
@env DD_APM_ENABLE_RARE_SAMPLER - boolean - optional - default: false

Para evaluar los tramos descartados a través de las reglas de la biblioteca de rastreo o la lógica personalizada como manual.drop, activa la función con: DD_APM_FEATURES=error_rare_sample_tracer_drop en el Trace Agent .

Datadog Agent 6/7.33 a 6/7.40.x

Por defecto, el muestreador de trazas poco frecuentes está activado.

**Nota: Cuando está activado, los tramos descartados a través de las reglas de la biblioteca de rastreo o la lógica personalizada como manual.drop están excluidos en este muestreador. Para incluir estos tramos en esta lógica, actualiza al Datadog Agent 6.41.0/7.41.0 o superior.

Para cambiar la configuración por defecto del muestreador de trazas poco frecuentes, actualiza la configuración apm_config.disable_rare_sampler en el archivo principal de la configuración del Agent (datadog.yaml) o con la variable entorno DD_APM_DISABLE_RARE_SAMPLER :

@params apm_config.disable_rare_sampler - boolean - optional - default: false
@env DD_APM_DISABLE_RARE_SAMPLER - boolean - optional - default: false

Forzar la conservación y el descarte

ingestion_reason: manual

El mecanismo de muestreo basado en la fase inicial se puede sustituir en la biblioteca de rastreo. Por ejemplo, si necesitas monitorizar una transacción crítica, puedes forzar la conservación de la traza asociada. Por otro lado, también puedes forzar el descarte de la traza en caso de que contenga información repetitiva o innecesaria, como los checks de estado.

• Configura Manual Keep en un tramo para indicar que se deben ingerir este y todos los tramos secundarios. El rastreo resultante puede aparecer incompleto en la interfaz de usuario si el tramo en cuestión no es el tramo raíz de la traza.

• Configura Manual Drop en un tramo para asegurarte de que no se ingiera ningún tramo secundario. Los muestreadores de trazas con errores y poco frecuentes se ignorarán en el Agent.

import datadog.trace.api.DDTags;
import io.opentracing.Span;
import datadog.trace.api.Trace;
import io.opentracing.util.GlobalTracer;

public class MyClass {
    @Trace
    public static void myMethod() {
        // grab the active span out of the traced method
        Span span = GlobalTracer.get().activeSpan();
        // Siempre conserva la traza
        span.setTag(DDTags.MANUAL_KEEP, true);
        // method impl follows
    }
}

import datadog.trace.api.DDTags;
import io.opentracing.Span;
import datadog.trace.api.Trace;
import io.opentracing.util.GlobalTracer;

public class MyClass {
    @Trace
    public static void myMethod() {
        // grab the active span out of the traced method
        Span span = GlobalTracer.get().activeSpan();
        // Siempre descarta la traza
        span.setTag(DDTags.MANUAL_DROP, true);
        // method impl follows
    }
}

from ddtrace import tracer
from ddtrace.constants import MANUAL_DROP_KEY, MANUAL_KEEP_KEY

@tracer.wrap()
def handler():
    span = tracer.current_span()
    # Siempre conserva la traza
    span.set_tag(MANUAL_KEEP_KEY)
    # method impl follows

from ddtrace import tracer
from ddtrace.constants import MANUAL_DROP_KEY, MANUAL_KEEP_KEY

@tracer.wrap()
def handler():
    span = tracer.current_span()
    # Siempre descarta el tramo
    span.set_tag(MANUAL_DROP_KEY)
    # method impl follows

Datadog::Tracing.trace(name, options) do |span, trace|
  trace.keep! # Afecta la traza activa
  # Sigue el método de implementación
fin

Datadog::Tracing.trace(name, options) do |span, trace|
  trace.reject! # Afecta la traza activa
  # Sigue el método de implementación
fin

package main

import (
    "log"
    "net/http"
    "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/ext"
    "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"
)

func handler(w http.ResponseWriter, r *http.Request) {
    // Crea un tramo para una solicitud web en la /posts URL.
    tramo := tracer.StartSpan("web.request", tracer.ResourceName("/posts"))
    defer span.Finish()

    // Siempre conserva esta traza:
    span.SetTag(ext.ManualKeep, true)
    //method impl follows

}

package main

import (
    "log"
    "net/http"

    "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/ext"
    "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"
)

func handler(w http.ResponseWriter, r *http.Request) {
    // Crea un tramo para una solicitud web en la /posts URL.
    tramo := tracer.StartSpan("web.request", tracer.ResourceName("/posts"))
    defer span.Finish()

    // Siempre descarta esta traza:
    span.SetTag(ext.ManualDrop, true)
    //method impl follows
}

const tracer = require('dd-trace')
const tags = require('dd-trace/ext/tags')

const span = tracer.startSpan('web.request')

// Siempre conserva la traza
span.setTag(tags.MANUAL_KEEP)
//method impl follows

const tracer = require('dd-trace')
const tags = require('dd-trace/ext/tags')

const span = tracer.startSpan('web.request')

// Siempre descarta la traza
span.setTag(tags.MANUAL_DROP)
//method impl follows

using Datadog.Trace;

using(var scope = Tracer.Instance.StartActive("my-operation"))
{
    var span = scope.Span;

    // Siempre conserva esta traza
    span.SetTag(Datadog.Trace.Tags.ManualKeep, "true");
    //method impl follows
}

using Datadog.Trace;

using(var scope = Tracer.Instance.StartActive("my-operation"))
{
    var span = scope.Span;

    // Siempre descarta esta traza
    span.SetTag(Datadog.Trace.Tags.ManualDrop, "true");
    //method impl follows
}

<?php
  $tracer = \DDTrace\GlobalTracer::get();
  $span = $tracer->getActiveSpan();

  if (null !== $span) {
    // Siempre conserva esta traza
    $span->setTag(\DDTrace\Tag::MANUAL_KEEP, true);
  }
?>

<?php
  $tracer = \DDTrace\GlobalTracer::get();
  $span = $tracer->getActiveSpan();

  if (null !== $span) {
    // Siempre conserva esta traza
    $span->setTag(\DDTrace\Tag::MANUAL_DROP, true);
  }
?>

...
#include <datadog/tags.h>
#include <datadog/trace_segment.h>
#include <datadog/sampling_priority.h>
...

dd::SpanConfig span_cfg;
span_cfg.resource = "operation_name";

auto span = tracer.create_span(span_cfg);
// Siempre conserva esta traza
span.trace_segment().override_sampling_priority(int(dd::SamplingPriority::USER_KEEP));
//method impl follows

...
#include <datadog/tags.h>
#include <datadog/trace_segment.h>
#include <datadog/sampling_priority.h>
...

using namespace dd = datadog::tracing;

dd::SpanConfig span_cfg;
span_cfg.resource = "operation_name";

auto another_span = tracer.create_span(span_cfg);
// Siempre descarta esta traza
span.trace_segment().override_sampling_priority(int(dd::SamplingPriority::USER_DROP));
//method impl follows

La conservación manual de las trazas debe realizarse antes de la propagación del contexto. Si se mantiene después de la propagación del contexto, el sistema no puede asegurar que se mantenga la traza completa en todos los servicios. La conservación de la traza manual se configura en la ubicación del cliente del rastreo, por lo que la ubicación del Agent o del servidor todavía puede descartar la traza de acuerdo con las reglas de muestreo.

Tramos únicos

ingestion_reason: single_span

Si necesitas muestrear un tramo específico, pero no necesitas que esté disponible la traza completa, las bibliotecas de rastreo te permiten establecer una frecuencia de muestreo que se configurará para un único tramo.

Por ejemplo, si estás creando métricas desde tramos para monitorizar servicios específicos, puedes configurar las reglas de muestreo de tramos para garantizar que estas métricas estén basadas en el 100 % del tráfico de la aplicación, sin tener que consumir el 100 % de las trazas para todas las solicitudes que fluyen a través del servicio.

Esta función está disponible para el Datadog Agent v7.40.0+.

Nota: Las reglas de muestreo de tramos únicos no pueden utilizarse para descartar tramos que se conservan mediante el muestreo basado en en la fase inicial, solo para conservar tramos adicionales que se descartan a través del muestreo basado en la fase inicial.

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

@env DD_SPAN_SAMPLING_RULES=[{"resource": "POST /api/create_issue", "tags": { "priority":"high" }, "sample_rate":1.0}]

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

@env DD_SPAN_SAMPLING_RULES='[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]'

Tramos consumidos por productos

Trazas de RUM

ingestion_reason:rum

Una solicitud de una aplicación web o móvil genera una traza cuando se instrumentan los servicios del backend . La integración de APM con Real User Monitoring vincula las solicitudes de aplicaciones web y móviles a sus trazas de backend correspondientes para que puedas ver todos tus datos frontend y backend a través de una sola lente.

Empezando con la versión 4.30.0 del SDK del navegador RUM, puedes controlar los volúmenes consumidos y mantener un muestreo de las trazas del backend mediante la configuración del parámetro de inicialización traceSampleRate. Establece traceSampleRate en un número entre 0 y 100. Si no se establece ningún valor traceSampleRate, por defecto, el 100 % de las trazas procedentes de las solicitudes del navegador se envían a Datadog.

De un modo similar, controla la frecuencia de muestreo de trazas en otros SDK utilizando parámetros parecidos:

Trazas Synthetic

ingestion_reason:synthetics y ingestion_reason:synthetics-browser

Las pruebas de HTTP y del navegador generan trazas cuando se instrumentan los servicios del backend. La integración de APM pruebas Synthetic vincula sus pruebas Synthetic con el backend con las trazas correspondientes del backend. Ve desde una ejecución de prueba que no aprobó a la causa raíz del problema mirando la traza generada por esa ejecución de prueba.

Por defecto, el 100 % de las pruebas de HTTP Synthetic y del navegador generan trazas del backend.

Otros productos

Algunos motivos adicionales de consumo se atribuyen a tramos generados por productos específicos de Datadog:

Mecanismos de consumo en OpenTelemetry

ingestion_reason:otel

Según tu configuración con los SDK de OpenTelemetry (mediante la utilización de OpenTelemetry Collector o el Datadog Agent), tienes muchas formas de controlar el muestreo del consumo. Consulta Muestreo del consumo con OpenTelemetry para obtener más información sobre las opciones disponibles para el muestreo en el nivel de OpenTelemetry SDK, OpenTelemetry Collector, y el Datadog Agent en diversas configuraciones de OpenTelemetry.

Leer más

Additional helpful documentation, links, and articles:

Controles de la ingestaDOCUMENTACIÓN Retención de trazasDOCUMENTACIÓN Métricas de usoDOCUMENTACIÓN