Fatos principais
- Categoria
- Desenvolvimento e Web
- Tipos de entrada
- textarea, file, select, checkbox, number
- Tipo de saída
- text
- Cobertura de amostras
- 4
- API disponível
- Yes
Visão geral
O Conversor de Logs para Diagramas de Sequência transforma logs estruturados e rastreamentos de serviços em diagramas visuais Mermaid ou PlantUML. Ideal para desenvolvedores e engenheiros de confiabilidade (SRE), a ferramenta analisa formatos como JSON Lines ou textos no estilo trace, gerando automaticamente o código do diagrama com anotações de latência e destaque de erros para facilitar a depuração de arquiteturas de microsserviços.
Quando usar
- •Quando precisar visualizar o fluxo de chamadas entre múltiplos microsserviços a partir de logs brutos.
- •Para identificar gargalos de desempenho analisando a latência de cada etapa em um rastreamento (trace).
- •Durante a investigação de incidentes, para mapear rapidamente onde um erro ou falha de comunicação ocorreu.
Como funciona
- •Cole seus logs estruturados (JSON Lines ou texto com setas) na área de texto ou faça o upload de um arquivo .log ou .jsonl.
- •Selecione o formato de saída desejado (Mermaid ou PlantUML) e ajuste as opções para incluir notas de latência ou destacar erros.
- •Defina o limite máximo de passos para manter o diagrama legível e focado nas interações principais.
- •A ferramenta processa os eventos, identifica origens e destinos, e gera o código do diagrama pronto para ser copiado e renderizado.
Casos de uso
Exemplos
1. Mapeamento de fluxo de login com erro
Engenheiro de Backend- Contexto
- Um usuário relatou falha intermitente ao tentar fazer login, e a equipe extraiu os logs do gateway.
- Problema
- Entender em qual microsserviço a requisição de login está falhando e quanto tempo cada salto demorou.
- Como usar
- Cole os logs de trace na entrada de texto, selecione 'Mermaid', ative 'Incluir latência' e 'Destacar erros'.
- Configuração de exemplo
-
diagramFormat: mermaid, includeLatencyNotes: true, highlightErrors: true - Resultado
- Um diagrama Mermaid é gerado mostrando a chamada da API para o serviço de Auth, destacando o erro 'invalid token' e a latência de 82ms.
2. Visualização de processamento de pagamentos
Arquiteto de Software- Contexto
- O fluxo de checkout envolve 5 microsserviços diferentes e gera logs em formato JSON Lines.
- Problema
- Criar uma documentação visual atualizada do fluxo de pagamento para apresentar à equipe.
- Como usar
- Faça o upload do arquivo checkout_trace.jsonl, escolha 'PlantUML' e defina os passos máximos para 20.
- Configuração de exemplo
-
diagramFormat: plantuml, maxSteps: 20 - Resultado
- O código PlantUML é gerado estruturando perfeitamente a sequência de chamadas entre o carrinho, gateway de pagamento, inventário e serviço de notificação.
Testar com amostras
json, text, fileHubs relacionados
FAQ
Quais formatos de log são suportados?
A ferramenta suporta JSON Lines com campos de origem/destino e logs de texto no estilo trace (ex: api -> auth).
Posso exportar o diagrama como imagem?
A ferramenta gera o código-fonte em Mermaid ou PlantUML. Você pode colar esse código em visualizadores compatíveis para exportar como imagem.
Como a latência é exibida no diagrama?
Se a opção 'Incluir latência' estiver ativa e os logs contiverem essa informação (ex: latency=82ms), o tempo será adicionado como uma nota ao lado da respectiva chamada.
O que acontece se meu log for muito grande?
Você pode usar a opção 'Passos máximos' para limitar a quantidade de interações geradas, garantindo que o diagrama final permaneça compreensível.
A ferramenta identifica erros automaticamente?
Sim, ao ativar 'Destacar erros', passos que contenham status de falha ou mensagens de erro nos logs receberão anotações visuais no diagrama.