Skip to content

Commit a049d94

Browse files
Docs: Mise à jour de la documentation (#51)
- Mise à jour de l'index de la documentation pour les nouvelles fonctionnalités de la version 0.2.0
1 parent 67e7871 commit a049d94

1 file changed

Lines changed: 40 additions & 1 deletion

File tree

docs/source/index.rst

Lines changed: 40 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,17 +23,56 @@ Grâce à LogBuster, vous pouvez extraire des informations essentielles, gérer
2323

2424
- **Extraire des statistiques clés** : Obtenez des données précieuses sur vos fichiers de logs.
2525
- **Exporter les données en JSON** : Accédez à un format structuré pour vos analyses.
26+
- **Exporter des graphiques** : Générez des graphiques de vos fichiers de logs.
27+
- **Filtrer les analyses** : Filtrez les analyses en toute simplicité.
2628
- **Gérer les erreurs de format avec précision** : Identifiez rapidement les anomalies et les erreurs de vos fichiers log.
2729

2830
**d(■᎑■⌐) Utilisation**
2931
---------------------------
3032

3133
```
32-
python app/main.py chemin_log [-s SORTIE]
34+
python app/main.py chemin_log [-s SORTIE] [-i IP] [-c CODE_STATUT_HTTP] [--camembert CAMEMBERT]
3335
```
3436

3537
- `chemin_log` : Le chemin vers le fichier de log Apache à analyser.
3638
- `-s SORTIE` (optionnel) : Le chemin où sauvegarder les résultats de l'analyse. Si non spécifié, les résultats seront sauvegardés dans un fichier `analyse-log-apache.json`.
39+
- `-i IP` (optionnel) : Le filtre à appliquer sur les adresses IP des entrées du fichier de log. Uniquement les entrées avec cette adresse IP seront analysées.
40+
- `-c CODE_STATUT_HTTP` (optionnel) : Le filtre à appliquer sur les code de statut http des entrées du fichier de log. Uniquement les entrées avec ce code de statut http seront analysées.
41+
- `--camembert CAMEMBERT` : (optionnel) : Active la génération de graphiques camemberts dans lors de l'analyse pour les statistiques compatibles. Les statistiques comptatibles.
42+
43+
**(ò_ó)⊃ Format de l'analyse**
44+
--------------------------------
45+
46+
Lors de l'analyse des fichiers de logs, LogBuster fait en sorte de regrouper les statistiques clés par catégories.
47+
48+
Voici ci-dessous le format de l'analyse en JSON:
49+
50+
- chemin: chemin absolu du fichier
51+
- total_entrees: nombre total d'entrées dans le fichier
52+
- filtre: filtres appliqués à l'analyse
53+
- adresse_ip: filtre sur l'adresse IP (None si désactivé)
54+
- code_statut_http: filtre sur le code de statut http (None si désactivé)
55+
- statistiques:
56+
- total_entrees_filtre: nombre total d'entrées analysées
57+
- requetes:
58+
- top_urls: top 3 des urls
59+
- dictionnaires contenant:
60+
- url: ressource demandée
61+
- total: nombre d'entrée avec cette ressource demandée
62+
- taux: pourcentage d'entrée avec cette ressource demandée
63+
- reponses:
64+
- repartition_code_statut_http: répartition des codes de statut http
65+
- dictionnaires contenant:
66+
- code: code de statut http retourné
67+
- total: nombre d'entrée avec ce code de statut http retourné
68+
- taux: pourcentage d'entrée avec ce code de statut http retourné
69+
70+
Pour les graphiques camemberts, un fichier HTML est généré avec ce graphique.
71+
Néanmoins, toutes les statistiques ne sont pas compatibles avec ce type d'affichage.
72+
73+
Voici la liste des statistiques comptatibles avec les graphiques:
74+
75+
- `repartition_code_statut_http` : Répartition des codes de statut HTTP. (nom: camembert-code_statut_http)
3776

3877
**(ง'̀᎑'́)ง Format des fichier de log Apache**
3978
------------------------------------------------

0 commit comments

Comments
 (0)