# Über diese Dokumentation

LLMS index: [llms.txt](/llms.txt)

---

Dies ist die offizielle Dokumentationsseite für **DNSServer.DebugLogParser**, ein PowerShell-Modul, das Windows DNS Server-Debug-Logdateien in strukturierte, analysierbare CSV-Daten umwandelt.

## Über das Modul

DNSServer.DebugLogParser entstand aus einem realen Bedarf: Windows DNS Server-Debug-Logs sind menschenlesbarer Text, aber nicht für Analysen oder Berichte geeignet. Dieses Modul schließt diese Lücke, indem es rohe Logdateien in ein strukturiertes CSV-Format konvertiert, das sich in gängige Tools wie Excel, Power BI, SQL-Datenbanken und SIEM-Systeme integrieren lässt.

Wichtige Designprinzipien:

- **Performance zuerst** — optimiert für Dateien über 100MB mit Streaming-I/O und String-Operationen
- **Editionenübergreifende Kompatibilität** — unterstützt PowerShell Desktop (5.1+) und Core (7.x)
- **Produktionsreif** — beinhaltet Header-Validierung, Fehlerbehandlung und optionale Komprimierung
- **Pipeline-freundlich** — fügt sich nahtlos in die PowerShell-Pipeline-Architektur ein

## Was hier zu finden ist

| Abschnitt | Lies es, wenn |
|---|---|
| [Überblick](01-overview/) | Du wissen möchtest, was das Modul macht und ob es zu deinem Problem passt |
| [Ausgabeformate](02-output-formats/) | Du wissen musst, was die CSV-Spalten bedeuten, bevor du eine Pipeline entwirfst |
| [Parameter und Optionen](03-parameters-and-options/) | Du entscheidest, welche Schalter deine Konvertierung benötigt |
| [Performance](04-performance/) | Deine Logs sind groß oder die Konvertierung ist langsamer als erwartet |
| [Integration](05-integration/) | Du die Ergebnisse in Excel, Power BI, SQL, ein SIEM oder Python laden willst |
| [Betriebliche Best Practices](06-operational-best-practices/) | Du das Modul unbeaufsichtigt in der Produktion einsetzen möchtest |
| [Anwendungsbeispiele](examples/) | Du ein durchgängiges Beispiel suchst, das du anpassen kannst |
| [Fehlerbehebung](08-troubleshooting/) | Etwas sich nicht wie erwartet verhält |
| [Befehlsreferenz](commands/) | Du die autoritative Parameterliste brauchst |

Neu beim Modul? Starte mit dem [Überblick](01-overview/).

## Ressourcen

- **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)
- **Autor-Blog**: [https://andibellstedt.com](https://andibellstedt.com)

## Mitwirken

Beiträge sind willkommen. Wenn du Probleme, Fehler findest oder Verbesserungsvorschläge hast, öffne bitte ein Issue oder einen Pull Request im [GitHub-Repository](https://github.com/AndiBellstedt/DNSServer.DebugLogParser).

---

Section pages:

- [Übersicht](/de/docs/01-overview/): Was DNSServer.DebugLogParser macht, wie ein Windows DNS-Debug-Log aussieht und wann sich die Umwandlung in CSV lohnt.
- [Ausgabeformate](/de/docs/02-output-formats/): Die Spalten der CSV-Datendatei, die zwei optionalen Statistikdateien und echte Beispielausgaben, die du öffnen kannst, bevor du irgendetwas ausführst.
- [Parameter und Optionen](/de/docs/03-parameters-and-options/): Was jede Option von Convert-DNSDebugLogFile tatsächlich ändert, wann du sie brauchst und welche Fallen leicht passieren können.
- [Performance](/de/docs/04-performance/): Wie der Parser 100 MB große Logs verarbeitet, ohne den Speicher deines Servers zu fressen, und was du tun kannst, um die Konvertierung schnell zu halten.
- [Integration mit Analysetools](/de/docs/05-integration/): Die konvertierte CSV in Excel, Power BI, SQL Server, ein SIEM oder ein Python-Notebook bekommen – inklusive der Trennzeichen- und Datumsformateinstellungen, die es beim ersten Versuch funktionieren lassen.
- [Operative Best Practices](/de/docs/06-operational-best-practices/): Was du beachten solltest, bevor du eine DNS-Protokollkonvertierung unbeaufsichtigt auf produktiven Domänencontrollern laufen lässt.
- [Fehlerbehebung](/de/docs/08-troubleshooting/): Symptome, auf die du beim Konvertieren von DNS-Debug-Logs wahrscheinlich stößt, was sie verursacht und wie du sie behebst.
- [Modulbefehle Referenz](/de/docs/commands/)
- [Anwendungsbeispiele](/de/docs/examples/)