À propos de cette documentation on Module PowerShell DNSServer.DebugLogParser

Vue d'ensemble

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

Le serveur DNS Windows peut écrire un journal de débogage. C’est un fichier texte brut, destiné à être lu par un humain, et qui peut grossir de plusieurs centaines de mégaoctets par jour sur un contrôleur de domaine très sollicité. Cette combinaison le rend presque inutilisable dès que vous voulez répondre à une question comme « quel client a demandé ce domaine 40 000 fois la nuit dernière ? »

Formats de sortie

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

Convert-DNSDebugLogFile produit jusqu’à trois fichiers par fichier journal d’entrée :

Fichier	Contenu	Créé quand
`<name>.csv`	Une ligne par entrée de journal analysée	`-OutputType CSV` ou `Both`
`<name>_Statistic.csv`	Nombre d’enregistrements quotidiens par contexte	`-OutputType Statistic` ou `Both`
`<name>_PacketStatistic.csv`	Nombre quotidien de requêtes par client, protocole, direction et type d’enregistrement	`-OutputType Statistic` ou `Both`

Both est la valeur par défaut. La sortie est placée à côté du fichier d’entrée sauf si tu définis -OutputFile.

Paramètres et options

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

Cette page explique les options en langage clair et dans l’ordre où vous en aurez généralement besoin. C’est un guide, pas une spécification — la liste autoritaire et toujours à jour des paramètres se trouve dans la référence de commande et dans :

Get-Help Convert-DNSDebugLogFile -Full

La version courte

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

Cette seule ligne vous donne déjà un comportement sensé : fichiers de données et de statistiques, délimiteur point-virgule, format de date de votre machine, validation de l’en-tête activée, journal source intact. Tout ce qui suit est du réglage fin.

Performance

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

Les journaux de débogage DNS sur un contrôleur de domaine très actif sont volumineux. Convert-DNSDebugLogFile est conçu pour ce cas : il a été testé avec des journaux de 100 Mo et plus, et les traite en quelques minutes sur du matériel serveur ordinaire.

Pourquoi c’est rapide

Vous n’avez pas besoin de connaître tout cela pour utiliser le module, mais cela explique le comportement que vous observerez.

Technique	Effet que vous remarquez
`StreamReader` / `StreamWriter` avec des tampons de 64 Ko	Le fichier est lu et écrit par morceaux au lieu d’un gros `Get-Content`
Streaming, passage unique	L’utilisation mémoire reste à peu près constante, quelle que soit la taille du journal
Opérations sur chaînes (`.Substring()`, `.IndexOf()`) au lieu d’expressions régulières	Beaucoup moins de CPU par ligne, et il y a des millions de lignes
CSV écrit à la main au lieu de `Export-Csv`	Pas de surcharge de pipeline d’objets par enregistrement
Agrégation basée sur des tables de hachage pour les statistiques	Les regroupements coûtent presque rien en plus pendant le même passage

La conséquence importante : le journal complet n’est jamais chargé en mémoire. Un journal de 500 Mo ne nécessite pas 500 Mo de RAM. C’est la différence entre le module et l’approche « lire le fichier, le découper, construire des objets » que la plupart des scripts maison utilisent — cette approche fonctionne bien sur un échantillon de 5 Mo mais plante sur un vrai DC.

Intégration avec les outils d’analyse

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

Le but de la conversion d’un journal de débogage DNS est ce qui se passe ensuite. Le CSV a été choisi parce que tout le monde le lit — mais « tout le monde lit le CSV » cache deux réglages qui décident si l’import est simple ou une après-midi de bidouillage.

Deux réglages qui décident de tout

Délimiteur. Par défaut ;. Gardez-le pour Excel dans les locales qui utilisent la virgule comme séparateur décimal. Passez à , pour la plupart des bases de données et outils de data science. Quel que soit votre choix, indiquez-le à la partie qui importe.

Bonnes pratiques opérationnelles

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

Convertir un journal à la main est facile. Le faire tourner chaque nuit sur chaque contrôleur de domaine, pendant des années, sans que personne ne le regarde, c’est la partie qui demande un peu de conception. Voici les points qui comptent en pratique.

1. Convertir les journaux archivés, pas celui en cours

Activez la rotation des journaux sur le serveur DNS et ne convertissez que les fichiers fermés. Le module peut lire le journal sur lequel le serveur DNS écrit actuellement, mais ce fichier change pendant la conversion : les entrées les plus récentes peuvent manquer et le dernier enregistrement peut être tronqué. Deux exécutions produisent deux résultats différents.

Dépannage

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

« Le fichier n’est pas un fichier de journal de débogage DNS valide »

La vérification de l’en-tête a rejeté l’entrée. En général, le chemin est simplement incorrect — un fichier .log dans le même dossier qui n’est pas un journal de débogage DNS, ou un fichier qui ne contient qu’un en-tête tourné.

Procédez ainsi :

Ouvrez le fichier. Un journal de débogage DNS commence par une ligne d’en-tête telle que Message logging started at … et continue avec des entrées de requêtes horodatées.