# O dokumentacji

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

---

To jest oficjalna strona dokumentacji **DNSServer.DebugLogParser**, modułu PowerShell, który przekształca pliki dziennika debugowania serwera DNS Windows w ustrukturyzowane, analizowalne dane CSV.

## O module

DNSServer.DebugLogParser powstał z realnej potrzeby: dzienniki debugowania serwera DNS Windows to czytelny dla człowieka tekst, ale nie nadają się do analityki czy raportowania. Ten moduł wypełnia tę lukę, konwertując surowe pliki dziennika do ustrukturyzowanego formatu CSV, który integruje się z popularnymi narzędziami jak Excel, Power BI, bazy danych SQL czy systemy SIEM.

Kluczowe zasady projektowe:

- **Wydajność przede wszystkim** — zoptymalizowany pod kątem plików 100MB+ z użyciem strumieniowego I/O i operacji na łańcuchach znaków
- **Kompatybilność międzyedycyjną** — wspiera PowerShell Desktop (5.1+) oraz Core (7.x)
- **Gotowy do produkcji** — zawiera walidację nagłówków, obsługę błędów i opcjonalną kompresję
- **Przyjazny dla potoków** — naturalnie integruje się z architekturą potoków PowerShell

## Co tu znajdziesz

| Sekcja | Czytaj, gdy |
|---|---|
| [Przegląd](01-overview/) | Chcesz wiedzieć, co robi moduł i czy pasuje do twojego problemu |
| [Formaty wyjściowe](02-output-formats/) | Musisz znać znaczenie kolumn CSV przed zaprojektowaniem potoku |
| [Parametry i opcje](03-parameters-and-options/) | Zastanawiasz się, które przełączniki są potrzebne do konwersji |
| [Wydajność](04-performance/) | Twoje dzienniki są duże lub konwersja jest wolniejsza niż oczekiwano |
| [Integracja](05-integration/) | Ładujesz wyniki do Excela, Power BI, SQL, SIEM lub Pythona |
| [Najlepsze praktyki operacyjne](06-operational-best-practices/) | Zamierzasz uruchomić to bez nadzoru w środowisku produkcyjnym |
| [Przykłady użycia](examples/) | Chcesz gotowy scenariusz end-to-end do adaptacji |
| [Rozwiązywanie problemów](08-troubleshooting/) | Coś nie działa zgodnie z oczekiwaniami |
| [Referencja poleceń](commands/) | Potrzebujesz autorytatywnej listy parametrów |

Nowy w module? Zacznij od [Przeglądu](01-overview/).

## Zasoby

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

## Współtworzenie

Wkład jest mile widziany. Jeśli znajdziesz błędy, problemy lub masz sugestie ulepszeń, otwórz zgłoszenie lub pull request w [repozytorium GitHub](https://github.com/AndiBellstedt/DNSServer.DebugLogParser).

---

Section pages:

- [Przegląd](/pl/docs/01-overview/): Co robi DNSServer.DebugLogParser, jak wygląda debug log DNS w Windows, i kiedy warto go konwertować do CSV.
- [Formaty wyjściowe](/pl/docs/02-output-formats/): Kolumny pliku danych CSV, dwa opcjonalne pliki statystyk oraz rzeczywiste przykładowe wyniki, które możesz otworzyć przed uruchomieniem czegokolwiek.
- [Parametry i opcje](/pl/docs/03-parameters-and-options/): Co faktycznie zmienia każda opcja Convert-DNSDebugLogFile, kiedy jej potrzebujesz i na jakie pułapki łatwo się natknąć.
- [Wydajność](/pl/docs/04-performance/): Jak parser radzi sobie z logami o rozmiarze 100 MB bez obciążania pamięci serwera oraz co możesz zrobić, aby utrzymać szybkie konwersje.
- [Integracja z narzędziami analitycznymi](/pl/docs/05-integration/): Jak załadować przekonwertowany plik CSV do Excela, Power BI, SQL Server, SIEM lub notatnika Pythona — wraz z ustawieniami separatora i formatu daty, które sprawiają, że działa to od pierwszego uruchomienia.
- [Najlepsze praktyki operacyjne](/pl/docs/06-operational-best-practices/): Co zrobić dobrze, zanim pozwolisz na automatyczne uruchamianie konwersji dzienników DNS na produkcyjnych kontrolerach domeny.
- [Rozwiązywanie problemów](/pl/docs/08-troubleshooting/): Objawy, na które najprawdopodobniej natkniesz się podczas konwersji dzienników debugowania DNS, co je powoduje i jak je naprawić.
- [Referencja poleceń modułu](/pl/docs/commands/)
- [Przykłady użycia](/pl/docs/examples/)