Datos clave
- Categoría
- Desarrollo y Web
- Tipos de entrada
- textarea, file, select, checkbox, number
- Tipo de salida
- text
- Cobertura de muestras
- 4
- API disponible
- Yes
Resumen
El Convertidor de logs a diagramas de secuencia es una herramienta diseñada para transformar logs estructurados y trazas de servicios en diagramas visuales de Mermaid o PlantUML. Al procesar logs en formato JSON Lines o texto estilo trace, la herramienta identifica automáticamente las interacciones entre microservicios y genera el código del diagrama. Incluye opciones para añadir anotaciones de latencia y resaltar errores, facilitando la depuración, el análisis de rendimiento y la documentación de sistemas distribuidos.
Cuándo usarlo
- •Cuando necesitas visualizar el flujo de peticiones entre múltiples microservicios a partir de logs de producción.
- •Para documentar incidentes o cuellos de botella analizando las latencias y errores registrados en las trazas.
- •Al auditar o explicar la arquitectura de un sistema basándose en el comportamiento real capturado en los archivos de log.
Cómo funciona
- •Pega tus logs estructurados (JSON Lines o texto con formato de flechas) en el área de texto o sube un archivo .log o .jsonl.
- •Selecciona el formato de salida deseado (Mermaid o PlantUML) y ajusta las opciones para incluir notas de latencia o resaltar errores.
- •Define el número máximo de pasos para mantener el diagrama legible y procesa los datos.
- •Copia el código generado y el resumen de interacciones para renderizar tu diagrama de secuencia en tu visor o wiki preferido.
Casos de uso
Ejemplos
1. Visualización de un flujo de login fallido
Ingeniero Backend- Contexto
- Un usuario reporta problemas al iniciar sesión y el ingeniero extrae las trazas de los servicios involucrados.
- Problema
- Leer múltiples líneas de texto plano dificulta entender dónde ocurre el fallo y cuánto tarda cada servicio.
- Cómo usarlo
- Pega las líneas de log 'api -> auth POST /login | status=401 | latency=82ms' en la entrada, selecciona 'Mermaid' y activa 'Resaltar errores' e 'Incluir latencia'.
- Configuración de ejemplo
-
Formato: Mermaid, Incluir latencia: true, Resaltar errores: true - Resultado
- Se genera un código Mermaid que dibuja la secuencia exacta, marcando visualmente el error 401 en el servicio de autenticación y mostrando los 82ms de latencia.
2. Mapeo de interacciones desde JSON Lines
Arquitecto de Software- Contexto
- Se necesita documentar cómo interactúan los servicios de pago y auditoría tras una compra, usando logs estructurados.
- Problema
- Convertir manualmente cientos de eventos JSON en un diagrama de secuencia es tedioso y propenso a errores.
- Cómo usarlo
- Sube el archivo 'payments_trace.jsonl' que contiene campos source, target y action, y establece el límite de pasos máximos en 15.
- Configuración de ejemplo
-
Archivo: payments_trace.jsonl, Formato: PlantUML, Pasos máximos: 15 - Resultado
- La herramienta extrae los eventos clave y genera un diagrama PlantUML resumido con las 15 interacciones principales, listo para adjuntar en la wiki de arquitectura.
Probar con muestras
json, text, fileHubs relacionados
Preguntas frecuentes
¿Qué formatos de log soporta la herramienta?
Soporta JSON Lines con campos como source, target y action, así como logs de texto estilo trace con flechas (por ejemplo, api -> auth).
¿Puedo subir archivos de log grandes?
Sí, puedes subir archivos de hasta 20 MB en formatos como .log, .txt, .json o .jsonl.
¿Para qué sirve el límite de pasos máximos?
Es una configuración que comprime la salida a un número específico de interacciones (entre 3 y 40) para evitar que el diagrama generado sea demasiado largo y difícil de leer.
¿Cómo se visualizan los errores en el diagrama?
Si activas la opción 'Resaltar errores', los pasos que contengan códigos de estado de error o mensajes de fallo se anotarán visualmente en el código Mermaid o PlantUML generado.
¿Necesito instalar Mermaid o PlantUML para usar esto?
No para generar el código. Esta herramienta genera el código fuente del diagrama, el cual puedes copiar y pegar en cualquier visor compatible, como GitHub, Notion o visores web.