# À propos de cette documentation

LLMS index: [llms.txt](/llms.txt)

---

Ceci est le site officiel de documentation pour **DNSServer.DebugLogParser**, un module PowerShell qui transforme les fichiers de journal de débogage du serveur DNS Windows en données CSV structurées et analysables.

## À propos du module

DNSServer.DebugLogParser est né d’un besoin réel : les journaux de débogage du serveur DNS Windows sont des textes lisibles par l’humain, mais pas adaptés à l’analyse ou au reporting. Ce module comble cette lacune en convertissant les fichiers journaux bruts en format CSV structuré, compatible avec des outils courants comme Excel, Power BI, bases de données SQL et systèmes SIEM.

Principes clés de conception :

- **Performance avant tout** — optimisé pour des fichiers de plus de 100 Mo grâce à l’I/O en streaming et aux opérations sur chaînes
- **Compatibilité multi-édition** — supporte PowerShell Desktop (5.1+) et Core (7.x)
- **Prêt pour la production** — inclut validation des en-têtes, gestion des erreurs et compression optionnelle
- **Compatible pipeline** — s’intègre naturellement à l’architecture pipeline de PowerShell

## Ce que vous trouverez ici

| Section | À lire quand |
|---|---|
| [Présentation générale](01-overview/) | Vous voulez savoir ce que fait le module et s’il correspond à votre problème |
| [Formats de sortie](02-output-formats/) | Vous devez comprendre la signification des colonnes CSV avant de concevoir un pipeline |
| [Paramètres et options](03-parameters-and-options/) | Vous décidez quels commutateurs votre conversion nécessite |
| [Performance](04-performance/) | Vos journaux sont volumineux ou la conversion est plus lente que prévu |
| [Intégration](05-integration/) | Vous chargez les résultats dans Excel, Power BI, SQL, un SIEM ou Python |
| [Bonnes pratiques opérationnelles](06-operational-best-practices/) | Vous vous apprêtez à exécuter cela en production sans surveillance |
| [Exemples d’utilisation](examples/) | Vous voulez un scénario complet à adapter |
| [Dépannage](08-troubleshooting/) | Quelque chose ne fonctionne pas comme prévu |
| [Référence des commandes](commands/) | Vous avez besoin de la liste officielle des paramètres |

Nouveau dans le module ? Commencez par la [Présentation générale](01-overview/).

## Ressources

- **GitHub** : [https://github.com/AndiBellstedt/DNSServer.DebugLogParser](https://github.com/AndiBellstedt/DNSServer.DebugLogParser)
- **PowerShell Gallery** : [https://www.powershellgallery.com/packages/DNSServer.DebugLogParser](https://www.powershellgallery.com/packages/DNSServer.DebugLogParser)
- **Blog de l’auteur** : [https://andibellstedt.com](https://andibellstedt.com)

## Contribution

Les contributions sont les bienvenues. Si vous trouvez des problèmes, des erreurs ou avez des suggestions d’amélioration, veuillez ouvrir un ticket ou une pull request sur le [dépôt GitHub](https://github.com/AndiBellstedt/DNSServer.DebugLogParser).

---

Section pages:

- [Vue d'ensemble](/fr/docs/01-overview/): Ce que fait DNSServer.DebugLogParser, à quoi ressemble un journal de débogage DNS Windows, et quand il vaut la peine de le convertir en CSV.
- [Formats de sortie](/fr/docs/02-output-formats/): Les colonnes du fichier de données CSV, les deux fichiers statistiques optionnels, et des exemples réels de sorties que tu peux ouvrir avant de lancer quoi que ce soit.
- [Paramètres et options](/fr/docs/03-parameters-and-options/): Ce que chaque option de Convert-DNSDebugLogFile modifie réellement, quand vous en avez besoin, et les pièges faciles à éviter.
- [Performance](/fr/docs/04-performance/): Comment le parseur gère des journaux de 100 Mo sans saturer la mémoire de votre serveur, et ce que vous pouvez faire pour garder des conversions rapides.
- [Intégration avec les outils d’analyse](/fr/docs/05-integration/): Importer le CSV converti dans Excel, Power BI, SQL Server, un SIEM ou un notebook Python — y compris les paramètres de délimiteur et de date qui font que ça marche du premier coup.
- [Bonnes pratiques opérationnelles](/fr/docs/06-operational-best-practices/): Ce qu’il faut bien faire avant de laisser une conversion de journal DNS s’exécuter sans surveillance sur des contrôleurs de domaine en production.
- [Dépannage](/fr/docs/08-troubleshooting/): Symptômes que vous êtes susceptible de rencontrer lors de la conversion des journaux de débogage DNS, leurs causes et comment les résoudre.
- [Référence des commandes du module](/fr/docs/commands/)
- [Exemples d'utilisation](/fr/docs/examples/)
