Te ofrecemos esta traducción automática para facilitar la lectura.
En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.
Los muestreadores del agente APM controlan qué transacciones dentro de un servicio determinado el agente envía a New Relic. Esta página cubre los tipos de muestreadores, como los adaptativos y los basados en la proporción de ID de traza, los objetivos de muestreo adaptativo y cómo configurar el muestreo en función de las decisiones de muestreo ascendentes.
Los ejemplos de configuración de esta guía utilizan el formato YAML (agente de Java). Para obtener la sintaxis específica del agente y la referencia completa del parámetro, consulte:
El agente comprueba el contexto de muestreo: ¿se trata de una transacción raíz o un servicio ascendente ya tomó una decisión de muestreo?
El agente aplica el muestreador adecuado según el contexto y la configuración.
El agente toma una decisión de muestreo: muestrear o no muestrear.
El agente propaga la decisión a los servicios descendentes mediante los encabezados de contexto de traza de rastreo distribuido.
Contextos del muestreador
Los agentes APM utilizan tres contextos de muestreo para manejar diferentes escenarios de trazas. Cada contexto puede tener su propia configuración de muestreador.
Un servicio ascendente decidió no muestrear esta traza
Controle el muestreo de las trazas que rechazó el servicio upstream
When it applies: el rastreo distribuido se origina en el servicio actual (este es el primer servicio en el rastreo distribuido).
Example scenario: la gateway de API es el punto de entrada para los requests de los clientes. Configure el muestreo raíz para capturar el 20 % de estas trazas iniciadas por los clientes.
distributed_tracing:
sampler:
root:
trace_id_ratio_based:
ratio:0.2# 20% of traces originating here
When it applies: un servicio ascendente decidió muestrear este rastreo distribuido (el servicio ascendente envió una decisión de muestreo de "sampled" en el contexto de rastreo distribuido).
Common pattern: si el servicio ascendente muestreó el rastreo distribuido, muéstreelo siempre en el servicio actual también:
distributed_tracing:
sampler:
remote_parent_sampled:
always_on # Always capture traces sampled by upstream
Alternative pattern: muestrear un porcentaje de las trazas ya muestreadas por el servicio ascendente:
distributed_tracing:
sampler:
remote_parent_sampled:
trace_id_ratio_based:
ratio:0.6# Sample 60% of traces sampled by upstream
Advertencia
Anular las decisiones de "sampled" ascendentes puede crear trazas fragmentadas donde solo están presentes algunos servicios. Utilice este patrón solo cuando tenga una necesidad específica de descartar las trazas que se muestrearon en el servicio ascendente.
When it applies: un servicio ascendente decidió no muestrear este rastreo distribuido (el servicio ascendente envió una decisión de muestreo de “no muestreado” en el contexto de traza).
Common pattern: si el servicio ascendente no muestreó el rastreo distribuido, nunca lo muestree en el servicio actual:
distributed_tracing:
sampler:
remote_parent_not_sampled:
always_off # Don't sample traces that upstream rejected
Alternative pattern: muestree parte del rastreo distribuido incluso si el servicio upstream decidió no muestrearlo (úselo con precaución):
distributed_tracing:
sampler:
remote_parent_not_sampled:
trace_id_ratio_based:
ratio:0.05# Sample 5% even if upstream said not to
Advertencia
Anular las decisiones ascendentes de "no muestreado" puede crear trazas fragmentadas en las que solo están presentes algunos servicios. Utilice este patrón solo cuando tenga una necesidad específica de ver la actividad en un servicio descendente incluso cuando el ascendente no la haya muestreado.
Tipos de muestreadores
Los agentes APM proporcionan cuatro tipos de muestreadores, cada uno adecuado para diferentes escenarios.
Desactivación total del muestreo para un contexto específico
How it works: se adapta dinámicamente al rendimiento del servicio para muestrear un número objetivo de trazas raíz por minuto, independientemente del volumen de tráfico. Siempre muestrea las transacciones que fueron muestreadas por un servicio ascendente y no las cuenta para el objetivo de muestreo adaptativo.
Default behavior: los agentes APM utilizan el muestreador adaptativo de forma predeterminada. La mayoría de los agentes APM tienen un objetivo de muestreo adaptativo predeterminado de 10 transacciones por minuto. Consulte la documentación de configuración de cada agente APM para obtener más detalles.
When to use:
Desea un número constante de transacciones muestreadas por minuto —independientemente de los cambios de tráfico— en lugar de un porcentaje constante de tráfico.
Desea un ajuste dinámico para espaciar el muestreo a lo largo de cada minuto.
Desea muestrear todas las transacciones que fueron muestreadas por el servicio ascendente y que estas no cuenten para el objetivo de muestreo adaptativo.
Configuration:
distributed_tracing:
sampler:
root: adaptive
How it adapts:
Tráfico bajo (10 requests/min): muestrea cada request para alcanzar el objetivo
Tráfico medio (100 requests/min): muestrea aproximadamente cada 5.º request para alcanzar el objetivo
Tráfico alto (1000 requests/min): muestrea aproximadamente cada 50.º request para alcanzar el objetivo
Sugerencia
El muestreador adaptativo siempre muestrea las trazas que fueron muestreadas por un servicio upstream. Estas trazas no cuentan para el objetivo de muestreo adaptativo configurado.
Objetivos de muestreo adaptativo
Los objetivos de muestreo adaptativo controlan cuántas trazas por minuto intenta capturar el agente. Comprender los objetivos globales frente a los por contexto es fundamental para lograr un comportamiento predecible.
El adaptive_sampling_target es compartido por todos los contextos y es el objetivo de muestreo predeterminado. Un contexto puede anular el adaptive_sampling_target global con su propio sampling_target específico del contexto.
El adaptive_sampling_target se puede establecer en cualquier número entero entre 1 y 120, ambos inclusive.
Configuration:
distributed_tracing:
sampler:
adaptive_sampling_target:10# Applied to all contexts without explicit override
root: adaptive
Result: el agente intenta capturar aproximadamente 10 transacciones por minuto que se originan en el servicio actual.
Cada contexto de muestreo puede reemplazar el objetivo global con su propio sampling_target.
El sampling_target se puede establecer en cualquier número entero entre 1 y 120, ambos inclusive.
Configuration:
distributed_tracing:
sampler:
adaptive_sampling_target:10# Global default
root:
adaptive:
sampling_target:5# Overrides global default to capture 5 traces/min
Result: el agente intenta capturar 5 transacciones por minuto que se originan en el servicio actual, anulando el valor predeterminado global de 10.
Razones para aumentar los objetivos de muestreo adaptativo
El valor predeterminado de 10 trazas/minuto se diseñó para el rastreo de transacciones, no para el rastreo distribuido. Para el rastreo distribuido, a menudo se desea un muestreo mayor para:
Fill service map gaps: es posible que los extremos poco frecuentes nunca se muestreen a 10/min
Improve trace diversity: consulte más tipos de transacciones y rutas de código
How it works: muestrea un porcentaje fijo de trazas según el ID de la traza. Debido a que la decisión de muestreo se basa en el ID de la traza, la misma traza obtendrá la misma decisión en todos los servicios que utilicen el mismo muestreador de proporción y agente de lenguaje de APM.
When to use:
Necesita un porcentaje constante de tráfico muestreado.
Desea un muestreo determinista (se muestrean los mismos rastreos distribuidos en todos los servicios con el mismo agente de lenguaje de APM).
Desea evitar el comportamiento del muestreador adaptativo en el que las transacciones que fueron muestreadas por el servicio ascendente siempre se muestrean y no cuentan para el objetivo de muestreo adaptativo.
Cada muestreador trace_id_ratio_baseddebe proporcionar un decimal ratio entre 0.0 (exclusivo) y 1.0 (inclusivo). El ratio especifica el porcentaje de trazas que se capturarán.
Importante
La propiedad ratio es obligatoria cuando se utiliza el muestreador trace_id_ratio_based. Si no se establece una proporción, se utilizará el muestreador adaptativo predeterminado en su lugar.
Configuration:
distributed_tracing:
sampler:
root:
trace_id_ratio_based:
ratio:0.1# 10% of traces
Important characteristic: el ID de la traza determina si se muestrea una traza. Si varios servicios usan la misma proporción y agente de lenguaje, tomarán decisiones consistentes para la misma traza.
Example: muestrear el 10 % del rastreo distribuido raíz y el 50 % del rastreo distribuido muestreado de forma ascendente:
distributed_tracing:
sampler:
root:
trace_id_ratio_based:
ratio:0.1
remote_parent_sampled:
trace_id_ratio_based:
ratio:0.5
How it works: muestrea todas las transacciones que coinciden con este contexto.
When to use:
Necesita una cobertura completa de trazas para un contexto específico (root, remote_parent_sampled, remote_parent_not_sampled)
Desea seguir o anular la decisión de muestreo del servicio upstream
Configuration:
distributed_tracing:
sampler:
remote_parent_sampled:
always_on # Capture all upstream-sampled traces
Advertencia
El uso de always_on capturará cada transacción para el contexto dado, lo que puede generar un volumen de datos significativo para los servicios de alto tráfico.
How it works: no muestrea ninguna de las transacciones para un contexto determinado.
When to use:
Desea aceptar la decisión del servicio upstream de no muestrear
Desea desactivar el muestreo para un contexto específico
Configuration:
distributed_tracing:
sampler:
remote_parent_not_sampled:
always_off # Don't sample if upstream did NOT sample
Configuración sugerida
Con tantos muestreadores para elegir, puede resultar difícil encontrar la configuración adecuada para el servicio. La mejor manera de encontrar la configuración que le funcione es observar la distribución de trazas que tiene el servicio hoy y hacer pequeños ajustes para avanzar hacia la distribución de trazas que desea.
Recomendamos esta configuración como punto de partida:
distributed_tracing:
sampler:
root:
trace_id_ratio_based:
ratio:0.1
remote_parent_sampled:
always_on
remote_parent_not_sampled:
always_off
Esta configuración muestrea el 10 % de las trazas del contexto root, todas las trazas del contexto remote_parent_sampled y ninguna traza del contexto remote_parent_not_sampled.
Para algunas aplicaciones, esta configuración es un punto de partida razonable para una distribución equilibrada de trazas. Para otras —por ejemplo, aquellas en las que la mayoría de las trazas se originan en un servicio ascendente— esta configuración puede dar demasiada prioridad a las trazas remote_parent_sampled y muy poca a las trazas root. En ese caso, intente modificar la configuración de remote_parent_sampled para capturar solo un porcentaje de las trazas muestreadas de forma ascendente:
distributed_tracing:
sampler:
root:
trace_id_ratio_based:
ratio:0.1
remote_parent_sampled:
trace_id_ratio_based:
ratio:0.2# Sample 20% of sampled traces originating upstream, instead of all of them
remote_parent_not_sampled:
always_off
Que sigue
Ahora que comprende el muestreo:
Consulte la referencia completa de configuración del muestreador para el agente: Java, Node.js, Python, Ruby
La configuración de muestreo puede ser compleja. Comience con un solo patrón e itere según el volumen de trazas real y las necesidades. Utilice métricas de capacidad de soporte y consultas de trazas para verificar que la configuración funcione como se espera.