Points clés
- Catégorie
- Développement et Web
- Types d’entrée
- textarea, file, select, checkbox, number
- Type de sortie
- text
- Couverture des échantillons
- 4
- API disponible
- Yes
Vue d’ensemble
Ce convertisseur transforme vos logs de services structurés en diagrammes de séquence Mermaid ou PlantUML. En collant des logs au format JSON Lines ou texte (de type trace), l'outil détecte automatiquement les interactions entre vos microservices. Il génère ensuite le code du diagramme en y intégrant des annotations de latence et d'erreur, facilitant ainsi le débogage et la visualisation des appels réseau.
Quand l’utiliser
- •Pour visualiser rapidement les appels entre microservices lors d'un incident de production.
- •Pour documenter l'architecture d'un système à partir de traces réelles d'exécution.
- •Pour analyser les goulots d'étranglement de performance en affichant les latences sur un diagramme de séquence.
Comment ça marche
- •Collez vos logs dans le champ texte ou téléchargez un fichier contenant des traces (JSON Lines, .log, .txt).
- •Sélectionnez le format de sortie souhaité (Mermaid ou PlantUML) et ajustez les options comme l'inclusion des latences ou la mise en évidence des erreurs.
- •L'outil analyse les lignes pour identifier les sources, cibles et actions (ex: api -> auth).
- •Récupérez un résumé des interactions et le code source du diagramme prêt à être intégré dans votre documentation.
Cas d’usage
Exemples
1. Analyse d'une erreur d'authentification
Ingénieur DevOps- Contexte
- Un utilisateur signale une impossibilité de se connecter, générant plusieurs lignes de logs réparties entre l'API, le service d'authentification et la base de données.
- Problème
- Identifier rapidement quel service renvoie l'erreur et comprendre la séquence d'appels.
- Comment l’utiliser
- Collez les logs de la requête dans le champ texte, sélectionnez 'Mermaid', et cochez 'Mettre en avant les erreurs'.
- Configuration d’exemple
-
{ "diagramFormat": "mermaid", "includeLatencyNotes": true, "highlightErrors": true } - Résultat
- Un diagramme Mermaid est généré, montrant clairement l'appel `api -> auth` échouant avec un statut 401 et l'erreur 'invalid token'.
2. Visualisation des latences d'une transaction
Développeur Backend- Contexte
- Une route d'API de paiement est anormalement lente. Les logs JSON Lines contiennent les temps de réponse de chaque sous-service.
- Problème
- Trouver le microservice responsable du ralentissement global de la transaction.
- Comment l’utiliser
- Chargez le fichier `.jsonl` contenant les traces de la transaction, choisissez 'PlantUML' et activez 'Inclure la latence'.
- Configuration d’exemple
-
{ "diagramFormat": "plantuml", "includeLatencyNotes": true, "maxSteps": 20 } - Résultat
- Le code PlantUML produit affiche la séquence complète avec les temps de réponse annotés sur chaque flèche, révélant un appel à la base de données prenant un temps excessif.
Tester avec des échantillons
json, text, fileHubs associés
FAQ
Quels formats de logs sont supportés ?
L'outil accepte les logs au format JSON Lines contenant des champs comme source, target et action, ainsi que les logs textuels utilisant des flèches (ex: api -> auth).
Puis-je limiter la taille du diagramme généré ?
Oui, vous pouvez définir un nombre maximum d'étapes (entre 3 et 40) pour garder le diagramme lisible et éviter de le surcharger.
Comment les erreurs sont-elles affichées ?
Si l'option 'Mettre en avant les erreurs' est activée, les étapes échouées sont annotées avec les détails de l'erreur directement sur le diagramme.
Les temps de réponse sont-ils inclus ?
Oui, en cochant 'Inclure la latence', l'outil extrait les valeurs de latence de vos logs et les ajoute comme notes sur les flèches du diagramme.
Que se passe-t-il si mes logs sont très volumineux ?
Vous pouvez télécharger un fichier jusqu'à 20 Mo. L'outil compressera les interactions en utilisant une synthèse IA ou une méthode heuristique pour générer un diagramme concis.