Tietoa tästä dokumentaatiosta on PowerShell-moduuli DNSServer.DebugLogParser

Yleiskatsaus

Mon, 01 Jan 0001 00:00:00 +0000

Windows DNS Server voi kirjoittaa debug-lokin. Se on tavallinen tekstimuotoinen tiedosto, joka on tarkoitettu ihmisen luettavaksi, ja se kasvaa satoja megatavuja päivässä vilkkaalla toimialueen ohjaimella. Tämä yhdistelmä tekee siitä lähes käyttökelvottoman heti, kun haluat vastata kysymykseen kuten “mikä asiakas kysyi tätä domainia 40 000 kertaa viime yönä?”

DNSServer.DebugLogParser muuttaa tuon tekstimuotoisen tiedoston CSV-taulukoksi. Yksi lokirivi muuttuu yhdeksi riviksi nimetyillä sarakkeilla, joten voit avata sen Excelissä, ladata Power BI:hin, lisätä massana SQL Serveriin tai lähettää SIEM-järjestelmääsi.

Tulostusmuodot

Mon, 01 Jan 0001 00:00:00 +0000

Convert-DNSDebugLogFile tuottaa enintään kolme tiedostoa syöttölokia kohden:

Tiedosto	Sisältää	Luodaan kun
`<name>.csv`	Yksi rivi jäsentynyttä lokimerkintää kohden	`-OutputType CSV` tai `Both`
`<name>_Statistic.csv`	Päivittäinen merkintämäärä kontekstin mukaan	`-OutputType Statistic` tai `Both`
`<name>_PacketStatistic.csv`	Päivittäinen kyselymäärä asiakkaan, protokollan, suunnan ja merkintätyypin mukaan	`-OutputType Statistic` tai `Both`

Both on oletus. Tuloste sijoittuu syötetiedoston viereen, ellei -OutputFile ole asetettu.

Tällä sivulla linkitetyt esimerkkitiedostot ovat oikeita muunnostuloksia, eivät mallinnuksia. Lataa yksi ja avaa se Excelissä ennen kuin sitoudut putkisuunnitteluun.

Parametrit ja valinnat

Mon, 01 Jan 0001 00:00:00 +0000

Tällä sivulla selitetään valinnat selkokielellä ja siinä järjestyksessä, jossa niitä yleensä tarvitset. Tämä on opas, ei spesifikaatio — virallinen, aina ajan tasalla oleva parametrilista löytyy komentoviitteestä ja komennolla:

Get-Help Convert-DNSDebugLogFile -Full

Lyhyt versio

Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log"

Tuo yksittäinen rivi antaa jo järkevän toiminnan: sekä data- että tilastotiedostot, puolipiste erotinmerkkinä, koneesi päivämäärämuoto, otsikon tarkistus päällä, lähdeloki koskemattomana. Kaikki alla oleva on hienosäätöä.

Valinta	Oletus	Muuta kun
`-InputFile`	(pakollinen)	aina
`-OutputFile`	syötetiedoston polku `.csv`-päätteellä	haluat tulosteen muualle
`-Delimiter`	`;`	kuluttajasi odottaa pilkkua, tabulaattoria tai putkea
`-ComputerName`	tyhjä	yhdistät lokeja useammalta palvelimelta
`-OutputType`	`Both`	haluat vain datan tai vain yhteenvedot
`-ContextFilter`	`All`	kiinnostaa vain varsinainen DNS-liikenne
`-InputCulture`	nykyinen kulttuuri	loki on peräisin palvelimelta, jolla on eri alueasetus
`-OutputCulture`	nykyinen kulttuuri	kone lukee CSV:n
`-NoDetailsParsing`	pois päältä	läpimenolla on väliä enemmän kuin pakettien sisällöllä
`-CompressOutput`	pois päältä	arkistoit tai siirrät tulokset
`-RemoveSourceFile`	pois päältä	ajastettu siivous ja luotat tulokseen
`-SkipHeaderValidation`	pois päältä	tiedosto on validi mutta otsikko on epätavallinen

Syöte ja tuloste

-InputFile

Polku muunnettavaan lokiin. Ottaa taulukon ja putkisyötteen — siksi tämä toimii:

Suorituskyky

Mon, 01 Jan 0001 00:00:00 +0000

DNS-vianmäärityslokit vilkkaalla toimialueen ohjaimella ovat suuria. Convert-DNSDebugLogFile on suunniteltu tätä varten: sitä on testattu yli 100 Mt:n lokitiedostoilla, ja se käsittelee ne minuuteissa tavallisella palvelinlaitteistolla.

Miksi se on nopea

Et tarvitse tätä tietoa moduulin käyttämiseen, mutta se selittää havaitsemasi käyttäytymisen.

Tekniikka	Huomattava vaikutus
`StreamReader` / `StreamWriter` 64 kt puskureilla	Tiedosto luetaan ja kirjoitetaan paloissa yhden suuren `Get-Content`-kutsun sijaan
Virtaava, yksinkertainen läpikäynti	Muistin käyttö pysyy suunnilleen samana riippumatta lokin koosta
Merkkijono-operaatiot (`.Substring()`, `.IndexOf()`) säännöllisten lausekkeiden sijaan	Huomattavasti vähemmän CPU-käyttöä per rivi, ja rivejä on miljoonia
CSV kirjoitetaan käsin `Export-Csv`-komennon sijaan	Ei objektiputken ylikuormitusta per tietue
Tilastojen kokoaminen hashtablen avulla	Yhteenvedot maksavat lähes mitään saman läpikäynnin aikana

Tärkeä seuraus: koko lokia ei koskaan pidetä muistissa kerralla. 500 Mt:n loki ei tarvitse 500 Mt RAM-muistia. Tämä erottaa moduulin kotikutoisista skripteistä, jotka lukevat tiedoston, pilkkovat sen ja rakentavat objekteja — tuo lähestymistapa toimii hyvin 5 Mt:n näytteellä, mutta kaatuu oikealla DC:llä.

Integrointi analyysityökaluihin

Mon, 01 Jan 0001 00:00:00 +0000

DNS-vianmäärityslokin muuntamisen tarkoitus on se, mitä sen jälkeen tapahtuu. CSV valittiin, koska kaikki lukevat sitä — mutta “kaikki lukevat CSV:tä” kätkee kaksi asetusta, jotka ratkaisevat, onko tuonti vaivatonta vai koko iltapäivän säätämistä.

Kaksi asetusta, jotka ratkaisevat kaiken

Erotinmerkki. Oletus on ;. Pidä se Excelissä maissa, joissa pilkkua käytetään desimaalierottimena. Vaihda , useimpiin tietokantoihin ja data-analytiikan työkaluihin. Mikä tahansa valintasi on, kerro sama tuovalle osapuolelle.

Päivämäärämuoto. -OutputCulture ohjaa, miten aikaleimat kirjoitetaan. Koneen luettavaksi käytä sv-SE (tai invarianttikulttuuria), jotta DateTime tulee muodossa 2026-01-20 23:00:16:

Toiminnalliset parhaat käytännöt

Mon, 01 Jan 0001 00:00:00 +0000

Lokien käsin muuntaminen on helppoa. Sen ajaminen joka yö jokaisella toimialueen ohjaimella vuosikausia ilman, että kukaan katsoo tuloksia, vaatii hieman suunnittelua. Tässä ovat käytännössä tärkeimmät kohdat.

1. Muunna kiertävät lokit, älä aktiivista

Ota lokin kierto käyttöön DNS-palvelimella ja muunna vain suljetut tiedostot. Moduuli voi lukea lokia, johon DNS-palvelin parhaillaan kirjoittaa, mutta kyseinen tiedosto muuttuu muunnoksen aikana: uusimmat merkinnät voivat puuttua ja viimeinen rivi voi olla katkaistu. Kaksi ajoa tuottaa kaksi erilaista tulosta.

Vianmääritys

Mon, 01 Jan 0001 00:00:00 +0000

“Tiedosto ei ole kelvollinen DNS-vianmäärityslokitiedosto”

Otsikkotarkistus hylkäsi syötteen. Yleensä polku on yksinkertaisesti väärä — samaan kansioon tallennettu .log-tiedosto, joka ei ole DNS-vianmääritysloki, tai tiedosto, joka sisältää vain kierrätetyn otsikon.

Tarkista seuraavat asiat:

Avaa tiedosto. DNS-vianmääritysloki alkaa otsikkorivillä, kuten Message logging started at …, ja jatkuu aikaleimatuilla kyselymerkinnöillä.
Varmista, että DNS-vianmäärityslokin kirjaus on todella käytössä ja kirjoittaa odottamaasi polkuun:
```
Get-DnsServerDiagnostics | Select-Object Enable, LogFilePath, MaxMBFileSize
```
Jos tiedosto on aidosti DNS-loki, mutta otsikko on epätavallinen — käsin muokattu, esisuodatettu, mukautettu vienti — ohita tarkistus: