# Acerca de esta documentación

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

---

Este es el sitio oficial de documentación para **DNSServer.DebugLogParser**, un módulo de PowerShell que transforma los archivos de registro de depuración del servidor DNS de Windows en datos CSV estructurados y analizables.

## Acerca del módulo

DNSServer.DebugLogParser nació de una necesidad real: los registros de depuración del servidor DNS de Windows son texto legible para humanos, pero no aptos para análisis o informes. Este módulo cierra esa brecha convirtiendo los archivos de registro en bruto en un formato CSV estructurado que se integra con herramientas comunes como Excel, Power BI, bases de datos SQL y sistemas SIEM.

Principios clave de diseño:

- **Rendimiento primero** — optimizado para archivos de más de 100MB usando E/S por streaming y operaciones con cadenas
- **Compatibilidad entre ediciones** — soporta PowerShell Desktop (5.1+) y Core (7.x)
- **Listo para producción** — incluye validación de encabezados, manejo de errores y compresión opcional
- **Compatible con pipeline** — se integra naturalmente con la arquitectura de pipeline de PowerShell

## Qué hay aquí

| Sección | Léelo cuando |
|---|---|
| [Resumen](01-overview/) | Quieras saber qué hace el módulo y si se ajusta a tu problema |
| [Formatos de salida](02-output-formats/) | Necesites entender qué significan las columnas CSV antes de diseñar un pipeline |
| [Parámetros y opciones](03-parameters-and-options/) | Estés decidiendo qué interruptores necesita tu conversión |
| [Rendimiento](04-performance/) | Tus registros sean grandes o la conversión sea más lenta de lo esperado |
| [Integración](05-integration/) | Estés cargando los resultados en Excel, Power BI, SQL, un SIEM o Python |
| [Mejores prácticas operativas](06-operational-best-practices/) | Vayas a ejecutar esto sin supervisión en producción |
| [Ejemplos de uso](examples/) | Quieras un escenario completo para adaptar |
| [Solución de problemas](08-troubleshooting/) | Algo no se comporte como esperas |
| [Referencia de comandos](commands/) | Necesites la lista autorizada de parámetros |

¿Nuevo en el módulo? Comienza con el [Resumen](01-overview/).

## Recursos

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

## Contribuciones

Las contribuciones son bienvenidas. Si encuentras problemas, errores o tienes sugerencias para mejoras, por favor abre un issue o pull request en el [repositorio de GitHub](https://github.com/AndiBellstedt/DNSServer.DebugLogParser).

---

Section pages:

- [Descripción general](/es/docs/01-overview/): Qué hace DNSServer.DebugLogParser, cómo es un registro de depuración de DNS en Windows, y cuándo vale la pena convertirlo a CSV.
- [Formatos de salida](/es/docs/02-output-formats/): Las columnas del archivo de datos CSV, los dos archivos opcionales de estadísticas y ejemplos reales de salida que puedes abrir antes de ejecutar cualquier cosa.
- [Parámetros y Opciones](/es/docs/03-parameters-and-options/): Qué cambia realmente cada opción de Convert-DNSDebugLogFile, cuándo la necesitas y las trampas en las que es fácil caer.
- [Rendimiento](/es/docs/04-performance/): Cómo el analizador maneja logs de 100 MB sin consumir la memoria de tu servidor, y qué puedes hacer para mantener las conversiones rápidas.
- [Integración con Herramientas de Análisis](/es/docs/05-integration/): Llevar el CSV convertido a Excel, Power BI, SQL Server, un SIEM o un cuaderno de Python — incluyendo la configuración del delimitador y la fecha que hacen que funcione a la primera.
- [Mejores prácticas operativas](/es/docs/06-operational-best-practices/): Qué hacer bien antes de dejar que una conversión de registros DNS se ejecute sin supervisión en controladores de dominio en producción.
- [Solución de problemas](/es/docs/08-troubleshooting/): Síntomas que probablemente encontrarás al convertir registros de depuración DNS, qué los causa y cómo solucionarlos.
- [Referencia de comandos del módulo](/es/docs/commands/)
- [Ejemplos de Uso](/es/docs/examples/)