Muestreo

El muestreo decide cuántas trazas se guardan. Una traza es el recorrido completo de un pedido por tus sistemas, paso a paso, con cuánto tardó cada parte y si algo falló. Cada paso de ese recorrido se llama aquí "paso de traza".

Guardar todas las trazas ocupa mucho espacio. Con el muestreo guardás todas las importantes (las que fallan, las lentas, las de rutas que vos elegís) y solo una parte de las normales.

Lo que no cambia: las métricas, los gráficos y las alertas usan siempre el 100 % de los datos. El muestreo solo reduce cuántos registros detallados quedan para investigar. Por eso un gráfico de errores o de demoras sigue siendo exacto aunque guardes pocas trazas.

Cuándo usarlo#

• El espacio que ocupan las trazas crece más de lo que querés pagar o almacenar.
• Tus sistemas atienden muchos pedidos iguales y sanos, y mirar uno de cada cuatro te alcanza.
• Querés asegurarte de que nunca se pierda una traza de un pedido lento o de una ruta crítica (por ejemplo /api/pagos).

Si recién empezás, dejá el 100 %: guardás todo y ves cómo se comporta tu sistema. Bajás el porcentaje cuando el volumen lo justifique.

Qué se guarda siempre#

Sin importar el porcentaje elegido, se guardan siempre:

• Las trazas con error.
• Las trazas lentas: las que tardan más que el umbral que elegís.
• Las de las rutas que agregás a la lista de "se guardan siempre".
• Las que marca la propia aplicación como importantes (por ejemplo un error o un pago).
• Las trazas que crean un evento de negocio con una regla de captura.

Del resto (los pedidos normales y rápidos) se guarda el porcentaje que elijas. Basta con que una de estas reglas diga "guardar" para que la traza se guarde.

El porcentaje elige siempre las mismas trazas. Eso sirve para algo concreto: si una traza se guarda, sus logs se pueden abrir desde ella; si no se guarda, los logs normales de esa traza no quedan con un enlace roto a una traza que no existe.

La pantalla#

Arriba puede aparecer un aviso amarillo si el muestreo no está en marcha en tus servidores (ver Problemas comunes). Después hay cuatro bloques y, abajo, el botón Guardar cambios.

Cómo se configura, paso a paso#

1. Entrá a Muestreo. Solo el perfil administrador puede cambiar algo. Los demás perfiles ven la pantalla en modo lectura.
2. En Operaciones normales que se guardan elegí un porcentaje. A la derecha ves una estimación del espacio que ocuparía.
3. En Desde cuándo una operación es lenta elegí el umbral.
4. En Rutas que se guardan siempre escribí las rutas críticas y apretá Enter. Para quitar una, tocá la ×.
5. Tocá Guardar cambios. Queda guardado como una versión de la política, con tu nombre y la fecha.
6. Tocá Aplicar en el agente (en la barra de arriba). Hasta ese momento tus servidores siguen con el muestreo anterior.
7. Mirá el estado de la aplicación. Mientras se aplica, la pantalla se actualiza sola cada pocos segundos.

El agente consulta si hay una configuración nueva más o menos cada 30 segundos, así que puede tardar un momento en tomar el cambio.

Guardar y aplicar son dos pasos distintos a propósito: podés dejar preparado un cambio y aplicarlo cuando quieras.

Tabla de campos#

Cuánto se guarda hoy, por servicio#

La tabla muestra, con datos de la última hora:

Si todavía no llegaron trazas en la última hora, la pantalla lo avisa. Si no se pudo medir, muestra solo la configuración y un aviso.

Estimación de espacio#

Al lado del selector de porcentaje aparece, por ejemplo, "≈ 1,4 KB/s · ≈ 3,6 GB/mes", y debajo "Se guardarían ≈ X pasos de traza por segundo de los Y que llegan. Hoy se guardan Z".

Es una estimación, no una medición: se calcula con un tamaño promedio de 500 bytes por paso de traza guardado y con lo que midió Lymen en la última hora. Si tu tráfico cambia (más usuarios, un pico), el número real cambia. Sirve para comparar opciones entre sí y decidir.

Estados de la aplicación#

Después de guardar, la barra superior te dice en qué quedó:

• Pendiente: guardaste una política, pero todavía no la aplicaste ("Falta aplicarlo: tocá Aplicar en el agente").
• Aplicando: se mandó al agente y todavía no confirmó.
• Aplicada: el agente ya usa esa política.
• Fallida: el agente no pudo aplicarla. Revisá el motivo que muestra la barra.

Abajo, un texto aclara si lo que ves "es lo que usa hoy el agente de tu red" o si tenés cambios sin guardar.

Ejemplos#

Reducir el gasto sin perder nada importante.

1. Dejá el umbral en 1 s.
2. Agregá /api/pagos y /api/turnos a las rutas que se guardan siempre.
3. Elegí 25 %.
4. Mirá la estimación: comparala con la del 100 % para ver el ahorro.
5. Guardá y aplicá.

Una clínica con poco tráfico. Con pocos pedidos por segundo, el ahorro de bajar el porcentaje es chico. Puede convenir dejar el 100 %.

Investigar una demora puntual. Subir el umbral a 5 s deja de guardar demoras medianas. Para investigar demoras, mejor bajá el umbral a 0,5 s o 1 s.

Problemas comunes#

• "Todavía no hay un gateway que ejecute el muestreo." Tu política queda guardada, pero ningún componente de tu red la está aplicando todavía, así que tus servidores siguen guardando el 100 % de las trazas. El botón de aplicar queda sin efecto hasta que haya un gateway que muestree. Cuando lo haya, aplicá la política.
• No puedo cambiar nada. Solo el perfil administrador edita el muestreo. Los demás ven "Solo un administrador puede cambiar el muestreo".
• El agente de tu red todavía no se conectó. La pantalla muestra la configuración local. Cuando el agente se conecte, aplicá la política.
• Guardé pero no veo cambios en lo que se guarda. Falta Aplicar en el agente, o el agente todavía no confirmó (puede tardar unos 30 segundos).
• No pude guardar. Si el valor no está en la lista de opciones (por ejemplo, un porcentaje que no existe) o una ruta no empieza con /, la pantalla muestra el motivo. Las rutas no pueden repetirse ni pasar de 20.
• Faltan trazas de un pedido normal. Es esperable: con un porcentaje menor al 100 %, parte de los pedidos normales no se guarda. Si necesitás seguir siempre un tipo de pedido, agregá su ruta a las que se guardan siempre.
• El gráfico de pedidos no coincide con la cantidad de trazas guardadas. Es normal. Los gráficos y alertas cuentan el 100 % de los pedidos; las trazas guardadas son solo una parte.

Ver también#

• Procesamiento: el muestreo también se puede editar desde el editor de pasos, en la pestaña Trazas.
• Reglas de captura: las trazas que crean un evento de negocio se guardan siempre.
• Almacenamiento: cuánto tiempo se guardan las trazas.