Los controles de ingesta afectan qué trazas envían sus aplicaciones a Datadog. Las métricas de APM siempre se calculan en función de todas las trazas y no se ven afectadas por los controles de ingesta.
La página de Ingestion Control proporciona visibilidad sobre la configuración de ingesta de sus aplicaciones y servicios. Desde la página de Ingestion Control:
Obtenga visibilidad sobre la configuración de ingesta a nivel de servicio.
Ajuste las tasas de muestreo de traza para servicios o puntos de conexión de alto rendimiento para gestionar mejor su asignación.
Ajuste las tasas de muestreo de trazas para servicios o puntos de conexión de bajo rendimiento y tráfico poco frecuente para aumentar la visibilidad.
Comprenda qué mecanismos de ingesta son responsables del muestreo de la mayoría de sus trazas.
Investigue y actúe sobre posibles problemas de configuración de ingesta, como recursos limitados de CPU o RAM para el Agent.
Comprender su configuración de ingesta
Utilice los datos en el encabezado de la página para hacer un seguimiento de la traza que ingresa:
Ingestión mensual
Muestra la cantidad de datos ingeridos hasta ahora este mes, su ingestión proyectada a fin de mes y su asignación mensual, junto con un mensaje de estado que indica si la ingestión proyectada está en camino de mantenerse dentro de su asignación.
Muestreo adaptativo de APM
Muestra qué parte de su asignación mensual está cubierta por su objetivo de muestreo adaptativo y cuántos servicios están incorporados en relación con el límite de servicios.
Ingestión a lo largo del tiempo
Un gráfico de su volumen de ingestión a lo largo del tiempo, desglosado por origen (APM, otros productos de Datadog u OTel), con su asignación mensual mostrada como línea de referencia.
La tabla de servicios contiene información sobre los volúmenes ingeridos y la configuración de ingestión, desglosada por servicio. Utilice las pestañas All services, Managed by APM, Managed by other Datadog products y Managed by OTel sobre la tabla para filtrar los servicios por origen de ingestión.
Tipo
El tipo de servicio: servicio web, base de datos, caché, navegador, etc…
Nombre
El nombre de cada servicio que envía trazas a Datadog. La tabla contiene servicios raíz y no raíz para los cuales se ingirieron datos en la última hora.
Trazas ingeridas/s
Número promedio de trazas por segundo ingeridas que comienzan desde el servicio durante la última hora.
Bytes ingeridos/s
Número promedio de bytes por segundo ingeridos para el servicio durante la última hora.
Bytes descendentes/s
Número promedio de bytes por segundo ingeridos para los cuales el servicio toma la decisión de muestreo. Esto incluye los bytes de todos los spans de los servicios descendentes en la pila de llamadas que siguen la decisión tomada al inicio de la traza. Los datos de esta columna se basan en la dimensión sampling_service, establecida en las métricas datadog.estimated_usage.apm.ingested_bytes. Para obtener más información, lea APM usage metrics.
Desglose del tráfico
Un desglose detallado del tráfico muestreado y no muestreado para las trazas que comienzan desde el servicio. Aparece un icono de advertencia junto al desglose cuando el limitador de tasa descarta el 25% o más del tráfico del servicio. Consulte Desglose de tráfico para obtener más información.
Configuración
Muestra de qué producto proviene la ingestión del servicio y, para los servicios de APM, cómo está configurado el muestreo: APM Agent si se aplica el mecanismo de muestreo basado en cabecera predeterminado del Agent, APM Local si se aplica una regla de muestreo desde la configuración en el SDK, o APM Remote si se aplica una regla de muestreo (definida por el usuario o muestreo adaptativo) de forma remota desde el UI. La ingestión a través de OpenTelemetry está etiquetada como OTel. La ingestión desde otros productos de Datadog está etiquetada como RUM, Synthetics, AppSec, CI Visibility o AWS X-Ray. Un servicio que coincide con más de una categoría muestra una insignia N Configurations; pase el cursor sobre ella para ver la lista completa. Para obtener más información sobre cómo configurar la ingestión para un servicio, lea sobre cómo cambiar la tasa de ingestión predeterminada.
Muestreo adaptativo
Muestra el estado de adopción del muestreo adaptativo del servicio: Full o Partial cuando el servicio está cubierto por el muestreo adaptativo (pase el cursor sobre la insignia para ver el porcentaje de cobertura), Compatible cuando el servicio podría incorporarse pero aún no lo está, Not Compatible cuando la versión del tracer o del Agent del servicio no admite el muestreo adaptativo, o Disabled cuando el muestreo adaptativo está desactivado explícitamente para el servicio.
Infraestructura
Hosts, contenedores y funciones en los que se ejecuta el servicio. Esta columna está oculta de forma predeterminada; actívela desde el menú de Options de la tabla.
Filtre la página por nombre de servicio, entorno, configuración o estado de muestreo adaptativo, o active Root services only para visualizar los servicios para los que necesita realizar una acción. Para reducir el volumen de ingesta global, ordene la tabla por la columna Downstream Bytes/s para ver los servicios responsables de la mayor parte de su ingesta.
Nota: La tabla funciona con las métricas de usodatadog.estimated_usage.apm.ingested_spans y datadog.estimated_usage.apm.ingested_bytes. Estas métricas están etiquetadas por service, env y ingestion_reason.
Desglose de tráfico
La columna Desglose de tráfico desglosa el destino de todas las trazas que comienzan desde el servicio. Le brinda una estimación de la proporción de tráfico que se ingiere y se descarta, y por qué razones.
El desglose se compone de las siguientes partes:
Complete traces ingested (azul): El porcentaje de trazas que han sido ingeridas por Datadog.
Complete traces not retained (gris): El porcentaje de trazas que no han sido ingeridas por Datadog. Es posible que algunas trazas se descarten debido a:
El servicio está configurado para ingerir un cierto porcentaje de trazas utilizando reglas de muestreo de trazas.
Complete traces dropped by the SDK rate limiter (naranja): Cuando elige establecer manualmente la tasa de ingesta del servicio como un porcentaje con reglas de muestreo de trazas, se habilita automáticamente un limitador de tasa, configurado en 100 trazas por segundo de forma predeterminada. Consulte la documentación del limitador de tasa para cambiar esta tasa.
Traces dropped due to the Agent CPU or RAM limit (rojo): Este mecanismo puede descartar spans y crear trazas incompletas. Para solucionar esto, aumente la asignación de CPU y memoria para la infraestructura en la que se ejecuta el Agent.
Configuración de la ingesta para un servicio
Haga clic en cualquier servicio para visualizar el Resumen de ingesta del servicio, el cual proporciona información útil y opciones de configuración para administrar la ingesta de trazas de ese servicio.
Configuración de ingesta para un servicio
Tasas de muestreo por recurso
La tabla enumera las tasas de muestreo aplicadas por recurso del servicio.
La columna Ingested bytes muestra los bytes ingeridos de los spans del servicio y recurso, mientras que la columna Downstream bytes muestra los bytes ingeridos de los spans donde la decisión de muestreo se toma a partir de ese servicio y recurso, incluyendo los bytes de los servicios descendentes en la cadena de llamadas.
La columna Configuration muestra desde dónde se aplica la tasa de muestreo del recurso:
Remote Configured si se estableció una regla de muestreo de trazas remota desde la interfaz de usuario de Datadog. Para aprender a configurar reglas de muestreo de trazas desde la página de Ingestion Control, lea la sección sobre configuración remota de reglas de muestreo de trazas.
Nota: Si el servicio no toma decisiones de muestreo, los recursos del servicio se agruparán bajo la fila Resources not making sampling decisions.
Nota: En marcos de tiempo cortos (1-4 horas), la tasa de muestreo efectiva puede mostrarse por debajo del 100% incluso cuando está configurada al 100%. Este es el comportamiento esperado debido a los cálculos estadísticos que necesitan más puntos de datos para converger. Todas las trazas se siguen capturando correctamente. Para obtener la visualización más precisa, visualice las tasas de muestreo durante períodos de tiempo más largos.
Motivos de ingesta y responsables de las decisiones de muestreo
Explore el Ingestion reasons breakdown para ver qué mecanismos son responsables de la ingesta de su servicio. Cada motivo de ingesta se relaciona con un mecanismo de ingesta específico. Después de cambiar la configuración de ingesta de su servicio, puede observar el aumento o la disminución de los bytes y spans ingeridos en este gráfico de series temporales basado en la última hora de datos ingeridos.
Si la mayor parte del volumen de ingesta de su servicio se debe a decisiones tomadas por servicios ascendentes, investigue el detalle de la lista principal Sampling decision makers. Por ejemplo, si su servicio no es raíz (lo que significa que nunca decide muestrear trazas), observe todos los servicios ascendentes responsables de la ingesta de su servicio no raíz. Configure los servicios raíz ascendentes para reducir su volumen general de ingesta.
Para investigaciones adicionales, utilice el APM Trace - Estimated Usage Dashboard, que proporciona información global de ingesta, así como gráficos de desglose por service, env y ingestion reason.
Versiones de Datadog Agent y del SDK
Consulte las Datadog Agent and SDK versions que utiliza su servicio. Compare las versiones en uso con las últimas versiones lanzadas para asegurarse de que está ejecutando Datadog Agents y bibliotecas recientes y actualizadas.
Administración de las tasas de muestreo de los servicios
Para controlar las tasas de muestreo de un servicio, es posible que desee utilizar:
Adaptive sampling: Ajustar automáticamente las tasas de muestreo para que coincidan con un objetivo de volumen de ingestión mensual configurado.
Resource-based sampling: Establecer manualmente tasas de muestreo explícitas por recurso.
Las configuraciones para estas estrategias se pueden aplicar Remotely a través de la interfaz de usuario de Datadog. Este método permite que los cambios surtan efecto de inmediato sin necesidad de volver a implementar su servicio. Para Resource-based Sampling, también tiene la opción de aplicar configuraciones localmente actualizando los archivos de configuración de su servicio y volviéndolo a implementar.
El uso de Remote Configuration para las tasas de ingesta de servicios tiene requisitos específicos.
APM Remote Configuration WritePermisos. Si no tiene estos permisos, solicite a su administrador de Datadog que actualice sus permisos desde la configuración de su organización.
A continuación encontrará la versión mínima del SDK requerida para la función:
Lenguaje
Versión mínima requerida
Java
v1.34.0
Go
v1.64.0
Python
v.2.9.0
Ruby
v2.0.0
Node.js
v5.16.0
PHP
v1.4.0
.NET
v2.53.2
C++
v0.2.2
Muestreo adaptativo
Utilice el muestreo adaptativo para permitir que Datadog gestione las tasas de muestreo de los servicios en su nombre. Especifique un volumen de ingesta mensual objetivo para uno o varios servicios mientras mantiene la visibilidad sobre todos los servicios y puntos de conexión.
Haga clic en un servicio para visualizar el Service Ingestion Summary.
Haga clic en Manage Ingestion rate.
Haga clic en Custom sampling rates only.
Haga clic en Add new rule para establecer tasas de muestreo para algunos recursos. Nota: Las reglas de muestreo utilizan coincidencia de patrones glob, por lo que puede usar comodines (*) para hacer coincidir varios recursos al mismo tiempo.
Aplique la configuración Remotely o Locally:
Esta opción aplica la configuración mediante Remote Configuration, por lo que no necesita volver a implementar el servicio para que el cambio surta efecto. Puede observar los cambios de configuración desde el Live Search Explorer.
Haga clic en Apply para guardar la configuración.
Los recursos que se han configurado remotamente se muestran como Configured Remote en la columna Configuration.
Si la aplicación de esta configuración Remotamente está deshabilitada, asegúrese de que se cumplan los requisitos de Remote Configuration.
Esta opción genera la configuración para que la aplique manualmente.
Aplique la configuración generada a su servicio. Nota: El valor del nombre del servicio distingue entre mayúsculas y minúsculas. Debe coincidir con las mayúsculas y minúsculas de su nombre de servicio.
Vuelva a implementar el servicio.
Confirme que se ha aplicado el nuevo porcentaje observando la columna Traffic Breakdown. Los recursos que se han configurado localmente se muestran como Configured Local en la columna Configuration.
Administración de la configuración de Ingestion Control del Datadog Agent
Haga clic en Configure Datadog Agent Ingestion para administrar las tasas de muestreo basadas en encabezados predeterminadas, el muestreo de errores y el muestreo de casos poco frecuentes.
Head-based Sampling: Cuando no se establecen reglas de muestreo para un servicio, el Datadog Agent calcula automáticamente las tasas de muestreo que se aplicarán a sus servicios, con el objetivo de 10 trazas por segundo por Agent. Cambie este número objetivo de trazas en Datadog, o establézcalo DD_APM_TARGET_TPS localmente a nivel de Agent.
Error Spans Sampling: Para las trazas que no captura el muestreo basado en encabezados, el Datadog Agent captura trazas de error locales hasta 10 trazas por segundo por Agent. Cambie este número objetivo de trazas en Datadog, o establézcalo DD_APM_ERROR_TPS localmente a nivel de Agent.
Rare Spans Sampling: Para las trazas que no captura el muestreo basado en encabezados, el Datadog Agent captura trazas raras locales hasta 5 trazas por segundo por Agent. Esta configuración está deshabilitada de forma predeterminada. Habilite la recopilación de trazas raras en Datadog, o establézcala DD_APM_ENABLE_RARE_SAMPLER localmente a nivel de Agent.
Con Remote Configuration, no tiene que reiniciar Agent para actualizar estos parámetros. Haga clic en Apply para guardar los cambios de configuración, y la nueva configuración entrará en vigor de inmediato. La Remote Configuration para los parámetros de muestreo de Agent está disponible si utiliza la versión de Agent 7.42.0 o superior.
Nota: La sección Other Ingestion Reasons (gris) del gráfico circular representa otros motivos de ingesta que no se pueden configurar a nivel de Datadog Agent.
Nota: Los parámetros configurados de forma remota tienen prioridad sobre las configuraciones locales, como las variables de entorno y la configuración datadog.yaml.
Precedencia de las reglas de muestreo
Si se establecen reglas de muestreo en varias ubicaciones, se aplican las siguientes reglas de precedencia en orden, donde las reglas que aparecen primero en la lista pueden anular las reglas de menor precedencia: