Procesamiento
Decidí qué se descarta, qué se cambia y qué se protege en tus datos antes de guardarlos, probalo con datos reales y aplicalo por versiones.
En esta página
Procesamiento es la pantalla donde armás qué le pasa a tus datos entre que salen de tus sistemas y se guardan. Ahí podés descartar ruido, tapar datos personales, renombrar campos, leer logs en JSON o juntar mensajes repetidos.
Al conjunto de pasos se lo llama pipeline (la "cañería" por donde pasan los datos). Cada paso hace una sola cosa, y los pasos corren de arriba hacia abajo.
Todo se configura con formularios guiados. No hay que escribir código.
Cuándo usarlo#
- Tus logs vienen llenos de mensajes de nivel
debugque no mirás nunca y querés dejar de ocupar espacio con ellos. - Un sistema escribe datos personales en los logs (un DNI, un mail) y querés taparlos antes de que salgan de tu red. Para esto también tenés la pantalla Privacidad.
- Un campo se llama distinto en cada aplicación (
msg,mensaje) y querés unificarlo. - Un servicio escribe el mismo error cientos de veces por minuto y querés guardarlo una sola vez, con la cantidad.
- Querés decidir cuántas trazas normales se guardan (ver Muestreo).
Algunas palabras que vas a ver:
- Log: una línea de texto que escribe un sistema ("turno reservado", "no se pudo conectar").
- Evento de negocio: un dato importante para tu operación (un pago, una reserva). Lo manda tu sistema o lo crea una regla de captura.
- Traza: el recorrido completo de un pedido por tus sistemas, paso a paso, con cuánto tardó y si falló.
- Métrica: un número que se mide cada tanto (uso del servidor, pedidos por minuto, errores).
- Agente: el programa que corre en tu red, recibe los datos y les aplica estos pasos antes de mandarlos a Lymen.
Cómo es la pantalla#
La pantalla tiene tres columnas y, arriba, una barra de estado.
- Lo que llega (izquierda). Los últimos registros reales del tipo de dato que elijas en las pestañas: Logs, Trazas, Métricas o Eventos.
- Lo que hacemos (centro). La lista de pasos, en orden. Ahí agregás, apagás, ordenás, editás y quitás pasos.
- Lo que se guarda (derecha). Cómo queda el registro que elegiste después del paso que tengas seleccionado, a qué lugar de guardado va y cuánto ahorrás.
Los pasos que pone Lymen por su cuenta (por ejemplo, marcar que los datos son tuyos o cuidar que el agente no se quede sin memoria) aparecen como "automáticos". No hace falta tocarlos y no se editan desde el portal.
Quién puede qué#
- Ver la pantalla: todos los perfiles.
- Cambiar pasos, guardar versiones y aplicarlas: perfiles admin e IT.
- Usar la vista previa con datos reales: también admin e IT. Los demás ven un aviso en lugar de los registros.
Paso a paso: armar un cambio#
- Elegí la pestaña del tipo de dato (Logs, Trazas, Métricas o Eventos).
- En la columna del medio tocá Agregar paso y elegí un tipo (se explican abajo). Las opciones dependen de la pestaña.
- Completá el formulario del paso: nombre, Cuándo se aplica y Qué hacer. Tocá Agregar (o Listo si lo estás editando).
- En la columna de la izquierda elegí un registro. Vas a ver cómo queda en la columna de la derecha, y en la lista aparecen las marcas se descarta, se junta o cambia en los registros afectados. Arriba aparece un resumen, por ejemplo "Este cambio descarta 340 de 1.000".
- Ajustá el orden si hace falta: arrastrá el paso, usá las flechas, o
Alt+ flecha arriba/abajo. - Tocá Guardar versión. Podés dejar un comentario (hasta 200 caracteres), por ejemplo "dejamos de guardar DEBUG".
- En el diálogo Aplicar elegís a qué agentes va y cómo (ver Aplicar una versión a los agentes).
Tus cambios se guardan solos como borrador unos instantes después de tocar algo (la barra dice "Borrador guardado"). Un borrador no cambia nada en tus datos hasta que lo guardes como versión y lo apliques.
Si te arrepentís, Descartar borrador tira los cambios que no guardaste como versión. Lo que ya está aplicado no se toca.
Tipos de paso#
Se pueden agregar estos tipos. El tope es de 20 pasos propios.
| Tipo de paso | Para qué sirve | Se puede agregar en |
|---|---|---|
| Proteger datos | Ocultar, borrar o reemplazar datos personales antes de que salgan de tu red | Logs, Eventos, Trazas |
| Descartar logs | No guardar los logs que cumplan una condición | Logs |
| Renombrar, agregar o borrar campos | Cambiar el nombre de un campo, sumar un dato fijo o sacar uno | Logs |
| Reemplazar texto | Buscar un pedazo de texto y cambiarlo | Logs |
| Leer JSON | Si el mensaje es un JSON, traer sus datos como campos | Logs |
| Juntar logs repetidos | Guardar uno solo cuando el mismo mensaje se repite, con la cantidad | Logs |
| Ajustar eventos de negocio | Renombrar, agregar, reemplazar o borrar campos de los eventos | Eventos |
| Muestreo de trazas | Elegir qué parte de las trazas normales se guarda | Trazas |
"Proteger datos" y "Muestreo de trazas" no son pasos nuevos: abren las reglas de Privacidad y la política de Muestreo para editarlas sin salir de esta pantalla.
Cada paso propio tiene un interruptor para apagarlo sin borrarlo. Un paso apagado no corre, pero queda guardado. Si no estás seguro de un paso, apagalo en vez de quitarlo.
Campos comunes a todos los pasos#
Estos campos aparecen en el formulario de cualquier paso propio.
| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto de cambiarlo |
|---|---|---|---|---|
| Nombre del paso | Cómo lo ves en la lista | El del tipo ("Cambiar campos", "Descartar DEBUG"...). Si se repite, se le suma un número | Hasta 60 caracteres, sin comillas, sin \ y sin $. No puede repetirse con otro paso |
Ninguno en los datos; solo ayuda a ordenarte |
| Se aplica a | A qué tipo de dato corre el paso | Logs (en el paso de eventos, Eventos de negocio) | Logs o Eventos de negocio | Un paso de logs nunca toca eventos y uno de eventos nunca toca logs. Si cambiás de uno a otro, se sacan solas las condiciones y acciones que no sirven y la pantalla te avisa cuántas fueron |
| Solo cuando / y además (condiciones) | Limita el paso a ciertos datos. Se tienen que cumplir todas | Ninguna: se aplica a todos | Hasta 10 condiciones | Sin condiciones, el paso toca todos los logs (o eventos). Cuantas más condiciones, más acotado queda. Un descarte sin condiciones no se permite |
| Acciones, en orden | Lo que hace el paso | Depende del tipo | Hasta 20 acciones por paso | Se aplican de arriba hacia abajo: el orden importa (por ejemplo, leer un JSON antes de renombrar uno de sus campos) |
Condiciones#
Cada condición tiene tres partes: qué mirar, cómo y un valor.
| Qué mirar | Cómo (operadores) | Valor | Disponible en |
|---|---|---|---|
| El servicio | es · no es | Nombre del servicio (ej. web-turnos). La pantalla sugiere los que mandan logs |
Logs y Eventos |
| El nivel | es menor a · es igual o más grave que · es | trace, debug, info, advertencia, error, fatal |
Solo Logs |
| El mensaje | contiene · no contiene | Texto. No distingue mayúsculas de minúsculas | Solo Logs |
| Un campo | es · no es · contiene · viene | Hay que escribir el nombre del campo (ej. pago.medio) y el valor. "viene" solo pregunta si el campo existe y no lleva valor |
Logs y Eventos |
| El evento | es · no es · empieza con | Nombre del evento (ej. pago. con "empieza con") |
Solo Eventos |
Límites: el valor tiene hasta 120 caracteres y no admite comillas, \, $ ni llaves. El nombre del campo, hasta 80 caracteres y solo letras, números, _, . y -.
Impacto: la condición decide a cuántos datos les pasa el paso. Una condición mal escrita puede hacer que el paso no toque nada (no pasa nada malo) o que toque más de lo que querías (en un descarte, perdés datos). Por eso conviene probar siempre con la vista previa.
Acciones de un paso de ajustes#
Estas son las acciones que se pueden elegir en "Qué hacer".
Renombrar el campo#
Le cambia el nombre a un campo. Si el campo no viene en el registro, no pasa nada.
| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Campo actual | Nombre que viene hoy (ej. msg) |
Vacío | Hasta 80 caracteres: letras, números, _, ., - |
Las búsquedas y gráficos que usen el nombre viejo dejan de encontrarlo en los datos nuevos |
| Nombre nuevo (a) | Nombre con el que se guarda (ej. mensaje) |
Vacío | Igual que arriba. Tiene que ser distinto al actual | Los datos ya guardados conservan el nombre viejo: solo cambia lo que llega desde que se aplica |
Agregar el campo#
Guarda un dato más: un valor fijo o la copia de otro campo.
| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Campo nuevo | Nombre del dato que se suma (ej. canal) |
Vacío | Hasta 80 caracteres | Cada registro afectado guarda un dato más (suma un poco de espacio) |
| De dónde sale | con el valor (un texto fijo) o copiado de (otro campo) | Con el valor | Una de las dos | Copiar un campo duplica su contenido: si ese campo tenía un dato personal, la copia también lo tiene |
| Valor / campo de donde se copia | El texto fijo, o el campo a copiar (ej. http.request.header.x-canal) |
Vacío | Hasta 120 caracteres. El texto fijo no admite comillas, \, $ ni llaves. Un campo no puede copiarse a sí mismo |
Con "copiado de", si el campo origen no viene, no se agrega nada |
Reemplazar texto#
Busca un pedazo de texto y lo cambia. Sirve, por ejemplo, para taparle los últimos dígitos a un número de tarjeta que aparece en un mensaje.
| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| En (el mensaje / un campo) | Dónde buscar | El mensaje | El mensaje, o el nombre de un campo | Si elegís un campo que no viene, no pasa nada |
| Buscar | Qué texto buscar, como patrón (expresión regular) | Vacío | 1 a 120 caracteres. Tiene que ser un patrón válido; la pantalla avisa si hay paréntesis o corchetes mal cerrados | Un patrón muy amplio cambia más de lo que querés. Probalo con la vista previa |
| Y poner | Con qué se reemplaza | *** |
Hasta 60 caracteres: letras, números, espacios y * # _ . : / @ = , -. Sin comillas, \ ni llaves. $1 a $9 conservan una parte del texto original |
El texto original no se guarda: no se puede recuperar |
| Conservar | Botones "+ parte 1", "+ parte 2"... que agregan $1, $2 al reemplazo |
Ninguno | Las partes son lo que va entre paréntesis en "Buscar" | Sirve para dejar visible solo una parte (ej. los primeros 4 dígitos). El reemplazo no puede usar una parte que el patrón no tiene |
Borrar el campo#
Saca el campo antes de guardar.
| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Campo | Cuál se borra (ej. stacktrace) |
Vacío | Hasta 80 caracteres | El dato no se guarda: no hay forma de recuperarlo. Baja el espacio usado |
| Siempre / Salvo en errores (solo en logs) | Cuándo se borra | Siempre | Una de las dos | "Salvo en errores" deja el campo en los logs de nivel error o más grave, útil para conservar el detalle justo cuando lo necesitás para investigar |
Leer como JSON (solo logs)#
Si el texto es un JSON, trae sus datos como campos sueltos. Después podés buscarlos y filtrarlos individualmente.
| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| De (el mensaje / un campo) | De dónde sale el JSON | El mensaje | El mensaje, o un campo (ej. payload) |
Si el texto no es un JSON, el log queda igual |
| Con el prefijo | Palabra que se antepone a los campos nuevos (ej. json da json.pedido.id) |
json |
Vacío (sin prefijo) o una palabra en minúsculas, hasta 30 caracteres, sin puntos ni espacios. No puede ser una palabra que use Lymen (obs, event, ev, lymen, trace, span) |
Sin prefijo, los campos nuevos pueden chocar con los que ya tenías (nunca los pisa, pero ese campo no se suma). Con muchos campos, aumenta el tamaño de cada log |
Topes: lee textos de hasta 8 KB y suma hasta 100 campos por log; si el JSON tiene más, no suma ninguno. Nunca pisa un campo que ya existe, no crea campos que usa Lymen, y descarta los campos que tengas protegidos en Privacidad (así un JSON no puede "colar" un dato que habías tapado).
Descartar el log (solo logs)#
No guarda los logs que cumplen las condiciones.
| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| (sin campos propios) | Decide por las condiciones del paso | Al agregar "Descartar logs", viene con la condición "el nivel es debug" | Necesita al menos una condición. Va sola: no se combina con otras acciones en el mismo paso | Los datos descartados se pierden. Es la forma más fuerte de bajar costo y ruido, pero también la más riesgosa: una condición demasiado amplia puede sacarte justo lo que necesitás en un incidente |
Los eventos de negocio no se descartan: esta acción no está disponible para ellos.
Juntar logs repetidos#
Si el mismo log se repite dentro de un tiempo, se guarda uno solo con la cantidad de veces que apareció (en un campo llamado repeticiones). Es solo para logs y va sola en su paso.
| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Dentro de | La ventana de tiempo en la que se juntan los repetidos | 1 min | 10 s, 30 s, 1 min, 2 min o 5 min | Una ventana larga junta más y ahorra más espacio, pero perdés el detalle de cuándo pasó cada repetición. Una ventana corta junta menos |
| Qué tiene que coincidir: El mensaje | Que el texto sea igual | Marcado | Marcado o no | Si lo desmarcás, se juntan logs con mensajes distintos y se pierde esa diferencia |
| Qué tiene que coincidir: El servicio | Los logs de cada servicio se juntan por separado | Marcado y fijo | No se puede desmarcar | Un servicio nunca se mezcla con otro |
| Qué tiene que coincidir: El nivel | Que el nivel sea el mismo | Marcado | Marcado o no | Desmarcarlo puede juntar un error con un aviso, y mezclar gravedades |
| Otros campos | Campos extra que también tienen que coincidir | Ninguno | Hasta 5 campos extra, sin repetir. Solo letras, números, _, . y - |
Cuantos más campos pidas, menos logs se juntan |
Siempre hace falta el servicio y al menos un campo más.
Impacto: baja mucho el volumen cuando un error se repite en bucle. A cambio, no ves cada ocurrencia con su hora exacta, solo una y la cantidad.
Ajustar eventos de negocio#
Es el mismo formulario de ajustes, aplicado a Eventos de negocio. Solo permite renombrar, agregar, reemplazar y borrar campos. Dos protecciones importantes:
- No se puede tocar el nombre del evento.
- No se pueden cambiar los campos con significado en tu perfil de negocio: monto, moneda, canal y sesión. Tampoco los campos que Lymen usa por dentro.
Impacto: cambiar o borrar campos de un evento afecta a los paneles, alertas y reportes que dependen de ese campo. No hay descarte para eventos.
Proteger datos (privacidad)#
Desde "Agregar paso" > "Proteger datos" abrís las mismas reglas de la pantalla Privacidad. Cada regla protege un dato antes de que salga de tu red.
| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Acción | Qué hacerle al dato | Borrar el campo | Hashear el campo (lo reemplaza por un código que no se puede revertir), Borrar el campo, Enmascarar texto (oculta solo lo que coincide) | Hashear deja seguir buscando y contando por ese dato sin que nadie lo lea. Borrar lo saca del todo. Enmascarar tapa un pedazo de un texto más largo |
| Campo | Cuál es (ej. paciente.dni) |
Vacío | Hasta 80 caracteres. * solo sirve para borrar por patrón |
Un campo mal escrito no protege nada: el dato sale tal cual |
| Buscar | Qué texto ocultar, como patrón | Vacío | Hasta 120 caracteres. Obligatorio al enmascarar | Un patrón demasiado preciso deja pasar variantes del dato |
| Qué es | Nombre para reconocer la regla (ej. "DNI del paciente") | Vacío | Hasta 80 caracteres | Ninguno en los datos |
| En | A qué tipos de dato se aplica | Logs y Eventos de negocio | Logs, Eventos de negocio, Trazas | Si no marcás Trazas, un dato que viaja en las trazas sale sin proteger |
Hasta 50 reglas. Mientras no haya reglas, "los datos personales salen tal cual".
Impacto en seguridad y privacidad: es el paso más importante para cuidar datos de pacientes o socios. Los datos se tapan en tu red, antes de salir, así que Lymen no llega a recibirlos sin proteger. Lo que ya se guardó antes de crear la regla no se modifica.
Muestreo de trazas#
Abre la política de Muestreo. En el editor aparece como cinco reglas: guardar siempre las trazas con error, guardar las lentas (con un umbral), guardar siempre ciertas rutas, guardar las que marca la aplicación y, del resto, guardar un porcentaje. Los valores válidos y su impacto están en esa página.
Vista previa con datos reales#
La columna de la izquierda trae hasta 100 registros reales de los últimos 15 minutos (logs y eventos), ya procesados con la versión aplicada. El editor simula encima lo que haría tu borrador, sin tocar nada de verdad.
- Encontrá el registro: un buscador con la misma sintaxis de las consultas de Lymen (por ejemplo
nivel = "ERROR", ver LQL), más atajos con los servicios vistos. Si pedís registros muy seguido, la pantalla te pide esperar un minuto. - Así llega / se guarda: al elegir un registro ves sus campos de entrada y, a la derecha, cómo queda. Los cambios se marcan: agregado (verde), borrado (rojo, tachado), cambiado, enmascarado o protegido con hash.
- Ver en vivo: mientras está prendido, la lista muestra lo que mandan los servidores en este momento.
- Métricas y Trazas: no se simulan. Se ven las últimas recibidas y se actualizan solas cada 10 segundos.
- Ahorro: al pie de la tercera columna se estima cuánto menos se guarda por el cambio.
Importante: la simulación usa una muestra, no todos tus datos. Si un paso descarta 30 de 100, es una buena pista de lo que va a pasar, pero no una garantía exacta.
En el editor individual de algunos pasos también hay Probar con los últimos 100: muestra cuántos coinciden, cuántos cambian, cuántos se descartarían y cuántos dan error al transformarse, con ejemplos "Así llega" y "Así se guarda".
Versiones#
Cada vez que tocás Guardar versión, el borrador pasa a ser la versión siguiente (v1, v2, v3...). Queda en un historial con tu nombre, la fecha, el comentario y una lista legible de qué cambió.
En Versiones y agentes (enlace arriba a la derecha) ves:
- El historial de versiones, con los botones Aplicar... y Volver a la vN.
- Los agentes de tu red, con su estado (Al día, Pendiente, Aplicando..., Falló o Sin conexión) y qué versión tiene cada uno.
Volver a la vN aplica esa versión vieja a todos los agentes, de forma directa. Es la salida rápida si un cambio salió mal.
Aplicar una versión a los agentes#
Una versión guardada todavía no corre. Hay que aplicarla. Al tocar Aplicar... elegís:
| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| A qué agentes | A quiénes se aplica | Todos los agentes | Todos los agentes, o Los que tengan... una o más etiquetas del servidor (ej. entorno:produccion; hasta 10). Un agente tiene que tener todas las etiquetas pedidas |
Aplicar a todos cambia todo de una vez. Con etiquetas podés probar primero en pruebas y después en producción. La pantalla te dice cuántos agentes la reciben. Ver Etiquetas |
| Cómo | Forma de aplicarla | Directo | Directo (todos a la vez, en menos de un minuto) o Primero unos de prueba | Directo es rápido pero, si hay un error, lo recibe toda la flota. "De prueba" es más lento y más seguro |
| Agentes de prueba | Cuántos la reciben primero | 1 | 1 a 20 | Más agentes de prueba da más confianza, pero expone a más servidores |
| Espera | Cuánto se espera a que los de prueba confirmen | 5 min | 1 a 60 min | Si los de prueba quedan aplicados dentro de ese tiempo, sigue con el resto. Si no, se frena |
Si un agente no puede aplicar la versión, ese agente vuelve solo a la versión que tenía y el despliegue se frena con un aviso: los agentes que todavía no la recibieron no la reciben. Mientras se aplica, ves el estado de cada agente (Esperando, Enviada, Aplicando, Aplicada, Falló). Si no hay agentes conectados, la versión se aplica cuando se conecten. Lo mismo vale si el agente de tu red está desconectado: el cambio se aplica cuando vuelva.
Orden: qué corre antes#
Importa en qué orden pasa cada cosa:
- Privacidad corre primero: lo que sigue ya recibe los datos protegidos.
- Tus pasos propios corren después, en el orden de la lista.
- Al final, los datos se reparten a su lugar de guardado según las reglas de Almacenamiento, que ven los campos ya ajustados por tus pasos.
Por eso, si renombrás un campo, las reglas de almacenamiento que miren ese campo tienen que usar el nombre nuevo.
Ejemplos#
Dejar de guardar los logs de depuración.
- Pestaña Logs > Agregar paso > Descartar logs.
- Viene con la condición "El nivel es debug". Dejala así.
- Elegí un log de nivel debug en la vista previa: tiene que aparecer "se descarta".
- Guardar versión, comentario "sin DEBUG", Aplicar a todos.
Tapar los últimos dígitos de una tarjeta en el mensaje.
- Agregar paso > Reemplazar texto.
- En: el mensaje. Buscar:
([0-9]{4})[0-9]{8}. Tocá "+ parte 1" para conservar los primeros 4 dígitos. Y poner:$1********. - Verificá en la vista previa que el número aparece tapado.
Unificar el nombre de un campo.
- Agregar paso > Renombrar, agregar o borrar campos.
- Renombrar el campo
msgamensaje.
Juntar un error que se repite en bucle. Agregar paso > Juntar logs repetidos. Dejá 1 min y mensaje, servicio y nivel marcados. Ese error pasa a guardarse una vez por ventana con su cantidad.
Problemas comunes#
- "Hice un cambio y no pasó nada." Guardar el borrador no alcanza: hay que Guardar versión y luego Aplicar. Revisá también que el paso no esté apagado.
- No puedo guardar el paso. La pantalla muestra el primer problema en rojo: falta un nombre, un campo o un valor; el nombre ya existe; el patrón no es válido; o el reemplazo usa una parte (
$2) que el patrón no tiene. - "Descartar el log va sola." Esa acción no se combina con otras en el mismo paso. Creá un paso aparte.
- "Para descartar logs hace falta al menos una condición." Es una protección: sin condición descartarías todos los logs.
- "Este campo está protegido en Privacidad" o "lo usa Lymen". Hay campos que no se pueden crear, renombrar ni cambiar desde acá: los protegidos por una regla de privacidad, los del sistema y, en eventos, monto, moneda, canal y sesión.
- No veo registros en la vista previa. Puede que no hayan llegado datos en los últimos 15 minutos, que la consulta sea muy estricta, o que tu perfil no sea admin ni IT.
- Cambié un campo y mis gráficos dejaron de mostrarlo. Los cambios valen para lo que llega desde que se aplica. Lo guardado antes conserva sus nombres. Para volver atrás, usá Volver a la vN.
- El despliegue se frenó. Revisá el aviso y el estado de cada agente en "Versiones y agentes". El agente que falló ya volvió a su versión anterior.
- Un paso no toca un log que esperaba. Revisá las condiciones: se tienen que cumplir todas, no alguna.