DNSServer.DebugLogParser on Module PowerShell DNSServer.DebugLogParser

Aperçu

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

DNSServer.DebugLogParser est un module PowerShell qui transforme les fichiers de journal de débogage du serveur DNS Windows en données CSV structurées et analysables pour l’analyse de sécurité, la surveillance des performances, le dépannage et les rapports de conformité.

Qu’est-ce qu’un journal de débogage DNS ?

La journalisation de débogage DNS est une fonctionnalité du serveur DNS Windows qui enregistre des informations détaillées sur les opérations DNS. Lorsqu’elle est activée, le serveur DNS écrit des entrées de journal dans un fichier texte (généralement dns.log) dans le répertoire du serveur DNS.

Formats de sortie

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

DNSServer.DebugLogParser peut générer deux types de sortie :

Un fichier de données CSV contenant toutes les entrées analysées
Des fichiers de statistiques optionnels pour une agrégation quotidienne

Pour voir des exemples concrets de chaque type de sortie, consulte l’exemple dans cet article.

Fichier de données CSV

Exemples de fichiers de sortie :

en-US (sans détails) : WithComputerName, NoComputerName
de-DE (sans détails) : WithComputerName, NoComputerName
de-DE (avec détails / JSON Details rempli pour les blocs de détails Packet) : WithComputerName, NoComputerName

Le fichier de données CSV contient toutes les entrées de journal analysées avec les colonnes suivantes :

Bonnes pratiques opérationnelles

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

Lors de l’utilisation de DNSServer.DebugLogParser en production :

Planifie un traitement régulier
- Utilise le Planificateur de tâches pour convertir automatiquement les nouveaux fichiers journaux quotidiennement ou hebdomadairement.
Fais une rotation appropriée des journaux
- Les journaux de débogage DNS peuvent rapidement grossir ; configure une rotation à une taille gérable (par exemple 100 Mo).
Valide la sortie
- Vérifie les premiers fichiers convertis avant d’automatiser complètement.
Planifie les besoins en stockage
- Même avec compression, prévois le stockage en fonction du volume DNS et de la durée de conservation.
Sécurise les données sensibles

Dépannage

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

Problèmes courants et solutions

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

Assure-toi de convertir un vrai journal de débogage du serveur DNS.
Le fichier doit commencer par Message logging started at ou contenir des entrées de requêtes DNS.
Si tu es certain que le fichier est valide mais que l’en-tête diffère, utilise -SkipHeaderValidation.

Le fichier de sortie est vide ou incomplet

Vérifie que le fichier d’entrée contient des entrées de journal valides.
Certains journaux peuvent ne contenir que des informations d’en-tête s’il n’y a pas eu de requêtes.
Assure-toi que le fichier journal n’est pas corrompu et contient des données de requêtes réelles.

Le traitement est très lent

Vérifie que la mémoire est suffisante et que le disque n’est pas fortement sollicité.
Envisage de traiter des fichiers journaux plus petits.
Envisage d’utiliser -CompressOutput avec un traitement planifié pour gérer des lots plus petits.

Erreurs « Accès refusé »

Lance PowerShell avec les permissions appropriées pour lire les fichiers journaux source et écrire dans le répertoire de destination.
Les fichiers journaux DNS peuvent nécessiter un accès administrateur.

La sortie compressée est plus volumineuse que prévu

Les journaux avec beaucoup de valeurs uniques se compressent moins efficacement ; cela peut être normal.
La compression ZIP permet néanmoins généralement une réduction substantielle.

Le fichier de statistiques ne correspond pas aux attentes

Vérifie que tu utilises -OutputType Both ou -OutputType Statistic.
Les statistiques sont des totaux agrégés (groupements quotidiens), donc les valeurs représentent des totaux.

Signaler des problèmes

Si tu rencontres des problèmes non couverts ici :

Convert-DNSDebugLogFile

Mon, 25 May 2026 00:00:00 +0000

SYNOPSIS

Transforme les journaux de débogage du serveur DNS Windows en un format CSV structuré pour analyse et rapports.

SYNTAX

__AllParameterSets

Convert-DNSDebugLogFile [-InputFile] <string[]> [[-OutputFile] <string>] [[-Delimiter] <string>]
 [[-ComputerName] <string>] [[-OutputType] <string>] [[-ContextFilter] <string[]>]
 [[-InputCulture] <cultureinfo>] [[-OutputCulture] <cultureinfo>] [-SkipHeaderValidation]
 [-RemoveSourceFile] [-CompressOutput] [-NoDetailsParsing] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Cette cmdlet possède les alias suivants,

Notes de version v1.2.0.0 (2026-01-25)

Sun, 25 Jan 2026 00:00:00 +0000

Ajouté

NOUVEAU : Traitement multi-lignes des enregistrements pour les blocs de détails PACKET DNS
- Les entrées de contexte PACKET peuvent désormais inclure des informations détaillées sur la connexion TCP/UDP et la structure du message DNS
- Les blocs de détails sont analysés en format JSON structuré dans la nouvelle colonne Details
- Comprend : infos socket, adresse/port distant, données temporelles, structure du message (XID, Flags, QCOUNT, etc.)
- Les sections DNS (QUESTION, ANSWER, AUTHORITY, ADDITIONAL) sont capturées avec tous les détails des enregistrements
- Les noms de domaine encodés dans les blocs de détails sont automatiquement convertis au format FQDN
NOUVEAU : Colonne Details dans la sortie CSV
- Contient les données JSON structurées pour les entrées PACKET avec blocs de détails
- Vide pour les entrées PACKET sans détails et tous les contextes non-PACKET
- Permet une analyse approfondie des paquets et une investigation forensique des requêtes/réponses DNS
NOUVEAU : Paramètre switch NoDetailsParsing pour optimisation des performances
- Ignore l’analyse JSON coûteuse des blocs de détails PACKET
- Peut améliorer la vitesse de traitement de 30 à 50 % pour les logs avec de nombreux blocs de détails
- À utiliser pour traiter des fichiers très volumineux (100 Mo+) lorsque la structure détaillée des paquets n’est pas nécessaire
- Les blocs de détails sont toujours collectés dans la colonne Information, mais la colonne Details reste vide
NOUVEAU : Support de continuation multi-lignes pour les contextes non-PACKET
- Les contextes EVENT, Note, DSPoll et autres peuvent maintenant s’étendre sur plusieurs lignes
- Les lignes de continuation indentées sont automatiquement jointes au champ Information de l’enregistrement principal
- Préserve les messages d’erreur complets, mises à jour de zone et sorties de diagnostic
NOUVEAU : ContextFilter reconnaît des types de contexte supplémentaires : DSPoll, Init, Lookup, Recurse, Remote, Tombstone
- Effet : Convert-DNSDebugLogFile peut maintenant inclure/exclure ces entrées de diagnostic et cycle de vie via -ContextFilter
NOUVEAU : La sortie des statistiques inclut désormais deux fichiers dédiés
- _Statistic.csv : Comptage quotidien des enregistrements par type de contexte (Date, Context, Count, ComputerName)
- _PacketStatistic.csv : Comptage quotidien des PACKET par client/protocole/direction/type (Date, ClientIP, Protocol, Direction, QuestionType, Count, ComputerName)
- Avantage : Rapports plus ciblés (volume opérationnel par contexte vs répartition du trafic DNS)
La génération JSON pour les blocs de détails PACKET est optimisée pour la performance (analyse manuelle au lieu de regex)

Modifié

BREAKING : La sortie CSV comprend maintenant 18 colonnes (ajout de la colonne Details avant ComputerName)
- Nouvel ordre des colonnes : DateTime, ThreadId, Context, PacketId, Protocol, Direction, ClientIP, Xid, Type, Opcode, FlagsHex, FlagsChar, ResponseCode, QuestionType, QuestionName, Information, Details, ComputerName
- Impact : Les scripts qui dépendent des positions des colonnes doivent être mis à jour
- Avantage : Capacités d’analyse riche des paquets sans modifier le comportement existant de la colonne Information
Le traitement des lignes de données a été refactoré pour lire toutes les lignes en mémoire afin de détecter efficacement les enregistrements multi-lignes
- Performance : Impact minimal grâce à l’utilisation optimisée de List
- Avantage : Permet une anticipation précise des blocs de détails et des lignes de continuation
Les noms de question manquants ou encodés comme vides sont maintenant gérés sans erreur de parsing ; la sortie CSV contiendra un champ QuestionName vide lorsqu’absent

Amélioré

Le parsing de Convert-DNSDebugLogFile est plus résilient : validation plus stricte des lignes et extraction améliorée réduisent les lignes erronées ou invalides issues de logs mal formés tout en préservant le format CSV/statistiques
La détection du contexte PACKET distingue les requêtes simples des requêtes avec blocs de détails
Les lignes vides après les entrées PACKET sans détails sont correctement ignorées
Le décodage des noms de domaine dans les blocs de détails utilise la fonction existante ConvertTo-Fqdn pour plus de cohérence

Performances

Vitesse de traitement maintenue pour les logs sans blocs de détails
Le switch NoDetailsParsing offre une amélioration de vitesse de 30 à 50 % lorsque l’analyse JSON n’est pas nécessaire
Gestion efficace de l’état lors du traitement des enregistrements multi-lignes
Opérations sur chaînes optimisées (TrimStart, Join) au lieu de regex pour la gestion des lignes de continuation

Notes

Ces changements sont conçus pour être rétrocompatibles en usage normal. Si tu relies sur un ensemble exact de noms de contexte ou un comportement de parsing strict antérieur, merci de valider les scripts en aval
La nouvelle colonne Details est toujours présente dans la sortie CSV ; utilise NoDetailsParsing pour la garder vide pour les performances
Les scripts existants qui analysent le CSV par position de colonne doivent prendre en compte la nouvelle colonne Details (position 17, avant ComputerName)

Notes de version v1.1.0 (2026-01-23)

Fri, 23 Jan 2026 00:00:00 +0000

Ajouté

NOUVEAU : Paramètre ContextFilter pour un parsing sélectif des logs
- Filtre les entrées de log par type de contexte : PACKET (requêtes/réponses DNS), EVENT (événements serveur) ou Note (informations de diagnostic)
- Permet une analyse ciblée sur des types spécifiques d’entrées de log
- Par défaut : Tous (inclut tous les types de contexte)
- Cas d’usage : Se concentrer uniquement sur le trafic DNS, surveiller les événements serveur, dépanner des problèmes de diagnostic
NOUVEAU : Champ Information dans la sortie CSV
- Capture des informations détaillées pour les entrées de contexte EVENT et Note
- Exemples : « Le serveur DNS a démarré. », « Chargement de la zone terminé », erreurs de socket, messages d’état interne
- Améliore la visibilité sur les événements opérationnels et diagnostics du serveur DNS
- Champ rempli lorsque le contexte est EVENT ou Note ; vide pour les entrées PACKET

Modifié

INCOMPATIBILITÉ : La colonne ComputerName est désormais toujours incluse à la fin de tous les enregistrements de sortie
- Avant : ComputerName était incluse conditionnellement au début quand le paramètre était spécifié
- Maintenant : ComputerName toujours présente en dernière colonne ; vide si le paramètre n’est pas spécifié
- Avantage : Structure de sortie cohérente facilitant la consolidation des logs multi-serveurs et le traitement automatisé
- Impact : Les scripts existants qui analysent la position des colonnes ou attendent une présence conditionnelle doivent être mis à jour

Ajouté

Filtrage par contexte pour se concentrer sur des types spécifiques d’entrées de log (PACKET, EVENT, NOTE) via le paramètre ContextFilter

Amélioré

Refactorisation de l’aide basée sur les commentaires pour Convert-DNSDebugLogFile pour plus de clarté et concision
Descriptions des paramètres mises à jour pour être plus informatives et exploitables
Documentation des exemples améliorée avec des cas d’usage plus ciblés et pratiques
Fichier d’aide about_DNSServer.DebugLogParser enrichi pour refléter la fonctionnalité actuelle
Journalisation détaillée améliorée pour fournir plus d’informations sur la progression pendant le traitement

v1.0.0 (2026-01-23)

Fri, 23 Jan 2026 00:00:00 +0000

Ajouté

Version initiale
Convert-DNSDebugLogFile - Analyseur haute performance pour les fichiers de journalisation de débogage du serveur DNS Windows
Analyse les 15 champs standard des journaux de débogage DNS en un format CSV structuré
Prise en charge des délimiteurs CSV personnalisables (par défaut : point-virgule)
Colonne ComputerName optionnelle pour la consolidation des journaux multi-serveurs
Trois modes de sortie : données CSV uniquement, statistiques uniquement, ou les deux
Résumés statistiques regroupant l’activité par IP client, protocole et type de requête
Support du pipeline pour le traitement par lots de plusieurs fichiers journaux
Validation de l’en-tête pour garantir l’intégrité des données (peut être contournée si nécessaire)
Compression automatique optionnelle des fichiers de sortie (format ZIP)
Suppression optionnelle des fichiers sources après traitement réussi
Analyse et formatage des dates sensibles à la culture pour les serveurs DNS internationaux
Optimisé pour les gros fichiers (100 Mo +) grâce à une entrée/sortie en flux et des opérations sur chaînes efficaces
Compatible avec PowerShell 5.1+ (éditions Desktop et Core)
Prise en charge des formats de journaux Windows Server 2016+ et DNS Server 2012 R2 jusqu’en 2025

Mentions légales

Sun, 18 Jan 2026 00:00:00 +0000

Informations conformément à l’article 5 de la loi allemande sur les télémédias (TMG)

Mentions légales

Andreas Bellstedt
Brunnenstr. 38
75387 Neubulach
Allemagne

Contact

Email : blog@andibellstedt.com

Forme juridique / statut de l’entreprise

Ce site web est exploité par un particulier / entrepreneur individuel.

Responsable du contenu conformément à l’article 55(2) du traité interétatique allemand sur la radiodiffusion (RStV)

Andreas Bellstedt
(Adresse ci-dessus)

Responsabilité du contenu

En tant que fournisseur de services, nous sommes responsables de notre propre contenu sur ces pages conformément à l’article 7(1) TMG selon le droit général. Conformément aux articles 8 à 10 TMG, nous ne sommes cependant pas tenus de surveiller les informations de tiers transmises ou stockées, ni d’enquêter sur des circonstances indiquant une activité illégale.

Politique de confidentialité

Sun, 18 Jan 2026 00:00:00 +0000

Politique de confidentialité

1. Confidentialité en un coup d’œil

Remarques générales

Les notes suivantes fournissent un aperçu simple de ce qui arrive à vos données personnelles lorsque vous visitez ce site web. Les données personnelles sont toutes les données permettant de vous identifier personnellement. Des informations détaillées sur le sujet de la protection des données peuvent être trouvées dans notre politique de confidentialité énoncée ci-dessous ce texte.

Flux de travail d'analyse de sécurité avec SQL Server

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

Cet exemple montre un flux de travail pratique pour l’analyse de sécurité : analyser un journal de débogage DNS avec Convert-DNSDebugLogFile, importer le CSV généré dans SQL Server, et exécuter une requête qui met en évidence des volumes anormalement élevés de requêtes sur les enregistrements TXT.

Pour une meilleure interopérabilité, cet exemple écrit les horodatages dans un format proche de l’ISO en utilisant -OutputCulture 'sv-SE'.

Modules requis

Cet exemple utilise les modules PowerShell suivants :

À propos de l'auteur

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

Bonjour le Monde !

Je suis Andreas Bellstedt — un professionnel de l’informatique avec plus de 20 ans d’expérience dans des environnements d’entreprise. On m’appelle généralement Andi.
Je suis passionné par la technologie, mais encore plus par son application pour améliorer la fiabilité, la sécurité et l’efficacité opérationnelle.

Utilisation pratique dans un environnement de domaine (collecte et conversion pilotées par GPO)

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

Ce document présente un exemple pratique et complet d’exécution de DNSServer.DebugLogParser dans un environnement de domaine Active Directory, axé sur la conversion des journaux de débogage du serveur DNS Windows sur les contrôleurs de domaine.

Cet exemple est accompagné d’une archive ZIP, qui fournit les artefacts de stratégie utilisés pour mettre en œuvre le flux de travail décrit ici.
Les artefacts les plus pertinents sont le manifest de sauvegarde, le rapport GPO, le Files.xml, le Set-DNSServerDebugLogging.ps1, et le ScheduledTasks.xml.

Exemple de tâche planifiée

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

Ce script crée une tâche planifiée Windows qui s’exécute tous les jours à 2h00 du matin. Il importe le module et traite tous les fichiers journaux dans le dossier où le script est exécuté (dans cet exemple “C:\Administration\Logs\DNS”). Le processus compresse la sortie dans des fichiers ZIP et supprime les originaux pour maintenir la propreté.

$actionParams = @{
 Execute = "powershell.exe"
 Argument = '-ExecutionPolicy RemoteSigned -Command "Import-Module DNSServer.DebugLogParser; Get-ChildItem .\*.log | Sort-Object lastwritetime, Name -Descending | Convert-DNSDebugLogFile -ComputerName $env:COMPUTERNAME -Delimiter \";\" -OutputType Both -ContextFilter Packet -OutputCulture sv-SE -CompressOutput"'
 WorkingDirectory = "C:\Administration\Logs\DNS"
}
$Action = New-ScheduledTaskAction @actionParams

$Trigger = New-ScheduledTaskTrigger -Daily -At "2:00AM"

Register-ScheduledTask -TaskName "Process DNS Logs" -Action $Action -Trigger $Trigger -Description "Convert DNS debug logs to CSV daily"

Informations sur le site

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

Informations de construction

Site construit avec le thème [Docsy] pour Hugo.

Résultats de recherche

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