Optimiser les Logs Simplicité

Cette skill fournit la capacité à analyser les logs Simplicité à partir d'un fichier brut .txt, filtrer les champs pour réduire le bruit, et restituer le résultat sous forme de JSON structuré. Ceci est crucial pour optimiser la taille du contexte IA (économisant ~56 % des tokens) et fournissant des données structurées et prévisibles pour le dépannage.

Quand utiliser cette skill

Utilisez cette skill quand vous devez :

• Analyser des fichiers log Simplicité fournis par l'utilisateur au format .txt.
• Éviter d'ingérer des fichiers log bruts massifs dans votre fenêtre de contexte.
• Extraire des champs structurés (comme timestamp, level, body) à partir d'une sortie log verbeuse multi-lignes.

IMPORTANT : Au lieu de lire directement un fichier log brut .txt fourni par l'utilisateur à l'aide d'outils de lecture de fichiers, vous devez utiliser l'un des scripts de conversion de logs (PowerShell ou Python) pour d'abord analyser le fichier dans un format JSON, en extrayant optionnellement uniquement les champs nécessaires.

Prérequis

• Accès soit au script PowerShell (/scripts/SimpliciteLog2Json.ps1), soit au script Python (/scripts/simplicite-log2json.py).

Capacités principales

1. Optimisation du contexte

Réduit les tokens consommés par les grands logs Simplicité en extrayant uniquement les champs log pertinents (par ex. body, timestamp, level) et en écartant les données log structurelles non pertinentes (comme app, endpoint, contextPath).

2. Support multi-lignes

Capture correctement les stack traces et les erreurs multi-lignes à l'intérieur du champ body de la structure JSON, ce qu'une simple recherche textuelle pourrait manquer.

3. Support Stdout

Si aucun chemin de sortie n'est fourni pour le fichier JSON (par ex. en omettant --output ou -Output), le JSON analysé sera imprimé directement vers stdout, vous permettant de rediriger la sortie vers d'autres outils.

Résumé de sortie

Après le traitement, l'outil imprime un résumé vers stderr (ou console) :

Processed: 123 entries, Skipped: 2 entries

Exemples d'utilisation

Exemple 1 : Version Python (Recommandée)

Convertir un fichier log en JSON, en conservant uniquement les champs les plus importants :

python /absolute/path/to/skills/optimize-simplicite-logs/scripts/simplicite-log2json.py <input.txt> --include timestamp,level,body --output <output.json>

Exemple 2 : Version PowerShell

/python /absolute/path/to/skills/optimize-simplicite-logs/scripts/SimpliciteLog2Json.ps1 -InputPath "<input.txt>" -Output "<output.json>" -Include "body,timestamp,level"

Après avoir généré le <output.json>, vous pouvez lire le fichier résultant en toute sécurité pour effectuer votre analyse.

Recommandations

1. Toujours convertir en premier : Ne lisez jamais directement les fichiers log .txt de Simplicité à l'aide d'outils de lecture textuelle standard. Convertissez-les toujours en JSON en utilisant les scripts disponibles.
2. Filtrer les champs : Utilisez --include (Python) ou -Include (PowerShell) pour limiter les champs à ce qui est absolument nécessaire pour diagnostiquer le problème (généralement timestamp,level,body).
3. Champs disponibles : Les champs que vous pouvez filtrer incluent : timestamp, app, level, endpoint, contextPath, event, user, class, function, rowId, body.

Modèles courants

Modèle : Dépannage contextuel rapide

# 1. Exécuter le script pour générer une sortie JSON minifiée dans le répertoire courant
python /absolute/path/to/skills/optimize-simplicite-logs/scripts/simplicite-log2json.py logs.txt --include timestamp,level,body --output logs_minified.json

# 2. Ensuite, lire logs_minified.json pour comprendre le contexte.

Limitations

• L'analyseur dépend d'un modèle regex fixe qui correspond à la sortie log Simplicité standard. Si le format du log a été fortement personnalisé, l'analyse peut échouer ou se dégrader.