Acerca de esta documentación on Módulo PowerShell DNSServer.DebugLogParser

Descripción general

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

Windows DNS Server puede escribir un registro de depuración. Es un archivo de texto plano, está pensado para ser leído por un humano, y crece cientos de megabytes al día en un controlador de dominio ocupado. Esa combinación lo hace casi inútil en el momento en que quieres responder una pregunta como "¿qué cliente pidió este dominio 40.000 veces anoche?"

DNSServer.DebugLogParser convierte ese archivo de texto en una tabla CSV. Una línea del registro se convierte en una fila con columnas nombradas, para que puedas abrirlo en Excel, cargarlo en Power BI, insertarlo masivamente en SQL Server o enviarlo a tu SIEM.

Formatos de salida

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

Convert-DNSDebugLogFile genera hasta tres archivos por cada registro de entrada:

Archivo	Contiene	Se crea cuando
`<name>.csv`	Una fila por cada entrada de registro analizada	`-OutputType CSV` o `Both`
`<name>_Statistic.csv`	Conteo diario de registros por contexto	`-OutputType Statistic` o `Both`
`<name>_PacketStatistic.csv`	Conteo diario de consultas por cliente, protocolo, dirección y tipo de registro	`-OutputType Statistic` o `Both`

Both es el valor predeterminado. La salida se guarda junto al archivo de entrada a menos que configures -OutputFile.

Parámetros y Opciones

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

Esta página explica las opciones en lenguaje sencillo y en el orden en que normalmente las necesitarás. Es una guía, no una especificación: la lista autoritativa y siempre actualizada de parámetros está en la referencia del comando y en:

Get-Help Convert-DNSDebugLogFile -Full

La versión corta

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

Esa sola línea ya te da un comportamiento sensato: archivos de datos y estadísticas, delimitador punto y coma, formato de fecha de tu máquina, validación de encabezado activada, registro fuente sin tocar. Todo lo que sigue es ajuste fino.

Rendimiento

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

Los logs de depuración DNS en un controlador de dominio ocupado son grandes. Convert-DNSDebugLogFile está diseñado para ese caso: ha sido probado con logs de 100 MB y más, y los procesa en minutos en hardware de servidor común.

Por qué es rápido

No necesitas saber esto para usar el módulo, pero explica el comportamiento que observarás.

Técnica	Efecto que notarás
`StreamReader` / `StreamWriter` con buffers de 64 KB	El archivo se lee y escribe en fragmentos en lugar de un gran `Get-Content`
Transmisión, pasada única	El uso de memoria se mantiene aproximadamente constante sin importar el tamaño del log
Operaciones con cadenas (`.Substring()`, `.IndexOf()`) en lugar de expresiones regulares	Mucho menos CPU por línea, y hay millones de líneas
CSV escrito a mano en lugar de `Export-Csv`	Sin sobrecarga de pipeline de objetos por registro
Agregación basada en tabla hash para estadísticas	Los resúmenes cuestan casi nada extra durante la misma pasada

La consecuencia importante: el log completo nunca se mantiene en memoria. Un log de 500 MB no necesita 500 MB de RAM. Esta es la diferencia entre el módulo y el enfoque de “leer el archivo, dividirlo, construir objetos” que la mayoría de los scripts caseros usan — ese enfoque funciona bien con una muestra de 5 MB y falla en un DC real.

Integración con Herramientas de Análisis

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

El objetivo de convertir un registro de depuración DNS es lo que sucede después. Se eligió CSV porque todo lo lee — pero “todo lee CSV” oculta dos configuraciones que deciden si una importación es sencilla o una tarde de ajustes.

Dos configuraciones que lo deciden todo

Delimitador. El valor predeterminado es ;. Mantenlo para Excel en configuraciones regionales que usan la coma como separador decimal. Cambia a , para la mayoría de bases de datos y herramientas de ciencia de datos. Sea cual sea tu elección, informa lo mismo al lado que importa.

Mejores prácticas operativas

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

Convertir un registro manualmente es fácil. Ejecutarlo cada noche en cada controlador de dominio, durante años, sin que nadie lo revise, es la parte que requiere un poco de diseño. Estos son los puntos que importan en la práctica.

1. Convierte los registros rotados, no el activo

Habilita la rotación de registros en el servidor DNS y convierte solo los archivos cerrados. El módulo puede leer el registro que el servidor DNS está escribiendo actualmente, pero ese archivo cambia durante la conversión: las entradas más recientes pueden faltar y el último registro puede estar truncado. Dos ejecuciones producen dos resultados diferentes.

Solución de problemas

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

“El archivo no es un archivo válido de registro de depuración DNS”

La verificación del encabezado rechazó la entrada. Normalmente la ruta está simplemente equivocada: un archivo .log en la misma carpeta que no es el registro de depuración DNS, o un archivo que solo contiene un encabezado rotado.

Sigue estos pasos:

Abre el archivo. Un registro de depuración DNS comienza con una línea de encabezado como Message logging started at … y continúa con entradas de consultas con marcas de tiempo.