# 关于本说明文档

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

---

这是 **DNSServer.DebugLogParser** 的官方文档站点，这是一个 PowerShell 模块，用于将 Windows DNS 服务器调试日志文件转换为结构化、可分析的 CSV 数据。

## 关于该模块

DNSServer.DebugLogParser 源于一个现实需求：Windows DNS 服务器调试日志是人类可读的文本，但不适合用于分析或报告。该模块弥补了这一差距，将原始日志文件转换为结构化的 CSV 格式，可与 Excel、Power BI、SQL 数据库和 SIEM 系统等常用工具集成。

主要设计原则：

- **性能优先** — 针对 100MB 以上文件进行了流式 I/O 和字符串操作的优化
- **跨版本兼容** — 支持 PowerShell Desktop (5.1+) 和 Core (7.x)
- **生产就绪** — 包含头部验证、错误处理和可选压缩功能
- **管道友好** — 自然集成 PowerShell 的管道架构

## 这里有什么内容

| 章节 | 何时阅读 |
|---|---|
| [概述](01-overview/) | 你想了解模块的功能及其是否适合你的问题 |
| [输出格式](02-output-formats/) | 你需要了解 CSV 列的含义以设计管道 |
| [参数和选项](03-parameters-and-options/) | 你正在决定转换需要哪些开关 |
| [性能](04-performance/) | 你的日志很大或转换速度低于预期 |
| [集成](05-integration/) | 你要将结果加载到 Excel、Power BI、SQL、SIEM 或 Python 中 |
| [操作最佳实践](06-operational-best-practices/) | 你准备在生产环境中无人值守运行该模块 |
| [使用示例](examples/) | 你想要一个完整的端到端示例以供参考 |
| [故障排除](08-troubleshooting/) | 某些行为不符合预期 |
| [命令参考](commands/) | 你需要权威的参数列表 |

刚接触该模块？请从 [概述](01-overview/) 开始。

## 资源

- **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)
- **作者博客**: [https://andibellstedt.com](https://andibellstedt.com)

## 贡献

欢迎贡献。如果你发现问题、错误或有改进建议，请在 [GitHub 仓库](https://github.com/AndiBellstedt/DNSServer.DebugLogParser) 上提交 issue 或 pull request。

---

Section pages:

- [概述](/cn/docs/01-overview/): DNSServer.DebugLogParser 的功能，Windows DNS 调试日志的样子， 以及何时将其转换为 CSV 是值得的。
- [输出格式](/cn/docs/02-output-formats/): CSV 数据文件的列、两个可选的统计文件，以及在运行任何操作之前你可以打开的真实示例输出。
- [参数和选项](/cn/docs/03-parameters-and-options/): Convert-DNSDebugLogFile 的每个选项实际改变了什么，何时需要它，以及容易踩的坑。
- [性能](/cn/docs/04-performance/): 解析器如何处理 100 MB 的日志而不占用服务器内存，以及 你可以做些什么来保持转换速度。
- [与分析工具的集成](/cn/docs/05-integration/): 将转换后的 CSV 导入 Excel、Power BI、SQL Server、SIEM 或 Python 笔记本——包括让它首次尝试就能成功的分隔符和日期设置。
- [运营最佳实践](/cn/docs/06-operational-best-practices/): 在让 DNS 日志转换无人值守地运行于生产域控制器之前，需要搞定的事项。
- [故障排除](/cn/docs/08-troubleshooting/): 转换 DNS 调试日志时可能遇到的症状、原因及解决方法。
- [模块命令参考](/cn/docs/commands/)
- [使用示例](/cn/docs/examples/)