适用于Windows (ETW) 的事件跟踪是 Active Directory 域服务 (AD DS) 有用的故障排除工具。 你可以使用 ETW 来跟踪轻型目录访问协议 (ldap) Windows 客户端与 ldap 服务器之间的通信,包括 AD DS 域控制器。
如何打开 ETW 并启动跟踪
启用 ETW
-
打开注册表编辑器,并创建以下注册表子项:
HKEY _ 本地 _ 计算机 \ 系统 \ CurrentControlSet \ Services \ ldap \ 跟踪 \ * ProcessName*
在此子项中, ProcessName是要跟踪的进程的完整名称,包括其扩展 (例如,"Svchost.exe" ) 。
-
(可选) 在此子项下,创建一个名为PID的新项。 若要使用此项,请将进程 ID 指定为 DWORD 值。
如果指定进程 ID,则 ETW 只跟踪具有此进程 ID 的应用程序的实例。
启动跟踪会话
-
打开 "命令提示符" 窗口,并运行以下命令:
tracelog.exe -start <SessionName> -guid \#099614a5-5dd7-4788-8bc9-e29f43db28fc -f <FileName> -flag <TraceFlags>此命令中的占位符表示以下值。
- <SessionName>是用于标记跟踪会话的任意标识符。
NOTE 稍后停止跟踪会话时,必须引用此会话名称。
- <FileName>指定将向其写入事件的日志文件。
- <TraceFlags>应为跟踪标志表中列出的一个或多个值。
如何结束跟踪会话并关闭事件跟踪
停止跟踪
-
在命令提示符处运行以下命令:
tracelog.exe -stop <SessionName>在此命令中,与在 <SessionName> tracelog.exe 开始命令中使用的名称相同。
禁用 ETW
- 在注册表编辑器中,删除HKEY _ LOCAL _ MACHINE \ System \ CurrentControlSet \ Services \ ldap \ 跟踪 \ * ProcessName* 子项。
跟踪标志的值
若要使用标志,请用tracelog.exe-start命令的参数中的 <跟踪标志> 占位符替换标志值。
Note: 您可以使用相应的标志值的总和指定多个标志。 例如,若要指定调试 _ 搜索 (0X00000001) 并调试 _ 缓存 (0x00000010) 标志,则适当的 <TraceFlags> 值为0x00000011。
| 标记名称 | 标志值 | 标志说明 |
|---|---|---|
| DEBUG_SEARCH | 0x00000001 | 记录搜索请求和传递到这些请求的参数。 不会在此处记录响应。 仅记录搜索请求。 (使用DEBUG_SPEWSEARCH记录搜索请求的响应。 ) |
| DEBUG_WRITE | 0x00000002 | 记录写入请求和传递到这些请求的参数。 写入请求包括 "添加"、"删除"、"修改" 和 "扩展" 操作。 |
| DEBUG_REFCNT | 0x00000004 | 日志引用用于连接和请求的计数数据和操作。 |
| DEBUG_HEAP | 0x00000008 | 记录所有内存分配和内存释放。 |
| DEBUG_CACHE | 0x00000010 | 记录缓存活动。 此活动包括添加、删除、命中、未命中等。 |
| DEBUG_SSL | 0x00000020 | 记录 SSL 信息和错误。 |
| DEBUG_SPEWSEARCH | 0x00000040 | 将所有服务器响应记录到搜索请求。 这些响应包括请求的属性,以及接收的所有数据。 |
| DEBUG_SERVERDOWN | 0x00000080 | 记录服务器停机和连接错误。 |
| DEBUG_CONNECT | 0x00000100 | 记录与建立连接相关的数据。使用DEBUG_CONNECTION可记录与连接相关的其他数据。 |
| DEBUG_RECONNECT | 0x00000200 | 记录自动重新连接活动。 此活动包括重新连接尝试、失败和相关错误。 |
| DEBUG_RECEIVEDATA | 0x00000400 | 与从服务器接收消息相关的日志活动。 此活动包括诸如 "等待服务器响应" 之类的事件和从服务器接收的响应。 |
| DEBUG_BYTES_SENT | 0x00000800 | 将 LDAP 客户端发送的所有数据记录到服务器。 此函数实质上是数据包日志记录,但它总是记录未加密的数据。 (如果通过 SSL 发送数据包,此函数将记录未加密的数据包。 ) 此日志记录可能是详细的。 此标志最适用于其自己的或与DEBUG_BYTES_RECEIVED结合使用。 |
| DEBUG_EOM | 0x00001000 | 记录与到达邮件列表末尾相关的事件。 这些事件包括 "清除消息列表" 等信息。 |
| DEBUG_BER | 0x00002000 | 记录与基本编码规则相关的操作和错误 (BER) 。 这些操作和错误包括编码问题、缓冲区大小问题,等等。 |
| DEBUG_OUTMEMORY | 0x00004000 | 记录分配内存失败。 同时记录任何计算所需内存的失败 (例如,将所需的缓冲区大小计算) 时出现的溢出。 |
| DEBUG_CONTROLS | 0x00008000 | 记录与控件相关的数据。 此数据包括插入的控件、影响控件的问题、连接上的强制控件等。 |
| DEBUG_BYTES_RECEIVED | 0x00010000 | 记录 LDAP 客户端收到的所有数据。 此行为实质上是数据包日志记录,但它总是记录未加密的数据。 (如果通过 SSL 发送数据包,此选项将记录未加密的数据包。 ) 此类日志记录可能是详细的。 此标志最适用于其自己的或与DEBUG_BYTES_SENT结合使用。 |
| DEBUG_CLDAP | 0x00020000 | 记录特定于 UDP 和无连接 LDAP 的事件。 |
| DEBUG_FILTER | 0x00040000 | 记录构造搜索筛选器时遇到的事件和错误。注意此选项仅在筛选器构造期间记录客户端事件。 它不记录来自服务器的有关筛选器的任何响应。 |
| DEBUG_BIND | 0x00080000 | 记录绑定事件和错误。 此数据包括协商信息、绑定成功、绑定失败等。 |
| DEBUG_NETWORK_ERRORS | 0x00100000 | 记录一般网络错误。 此数据包括发送和接收错误。注意如果连接丢失或无法访问服务器, DEBUG_SERVERDOWN是首选标记。 |
| DEBUG_VERBOSE | 0x00200000 | 记录常规消息。 对于往往会生成大量输出的消息,请使用此选项。 例如,它记录消息,如 "已到达消息结束"、"服务器尚未响应" 等。 对于一般消息,此选项也很有用。 |
| DEBUG_PARSE | 0x00400000 | 记录常规消息事件和错误以及数据包分析和编码事件和错误。 |
| DEBUG_REFERRALS | 0x00800000 | 记录有关引用和追踪引用的数据。 |
| DEBUG_REQUEST | 0x01000000 | 记录请求的跟踪。 |
| DEBUG_CONNECTION | 0x02000000 | 记录常规连接数据和错误。 |
| DEBUG_INIT_TERM | 0x04000000 | 记录模块初始化和清理 (DLL Main 等) 。 |
| DEBUG_API_ERRORS | 0x08000000 | 支持记录不正确地使用 API。 例如,如果在同一连接上调用绑定操作两次,则此选项会记录数据。 |
| DEBUG_ERRORS | 0x10000000 | 记录常规错误。 其中的大多数错误可以归类为模块初始化错误、SSL 错误或溢出或下溢错误。 |
| DEBUG_PERFORMANCE | 0x20000000 | 接收 LDAP 请求的服务器响应后,记录有关进程的全局 LDAP 活动统计信息的数据。 |
示例
假设有一个应用程序 App1.exe,该应用程序设置用户帐户的密码。 假设 App1.exe 产生意外错误。 若要使用 ETW 来帮助诊断此问题,请执行以下步骤:
-
在注册表编辑器中,创建以下注册表项:
HKEY _ 本地 _ 计算机 \ 系统 \ CurrentControlSet \ Services \ ldap \ 跟踪 \App1.exe
-
若要启动跟踪会话,请打开命令提示符窗口,并运行以下命令:
tracelog.exe -start ldaptrace -guid \#099614a5-5dd7-4788-8bc9-e29f43db28fc -f .\ldap.etl -flag 0x80000此命令启动后,调试 _ 绑定可确保 ETW 将跟踪消息写入。 \ldap .etl。
-
开始 App1.exe,并重现意外错误。
-
若要停止跟踪会话,请在命令提示符下运行以下命令:
tracelog.exe -stop ldaptrace -
若要防止其他用户跟踪应用程序,请删除HKEY _ LOCAL _ MACHINE \ System \ CurrentControlSet \ Services \ ldap \ 跟踪 \ App1.exe注册表项。
-
若要查看跟踪日志中的信息,请在命令提示符下运行以下命令:
tracerpt.exe .\ldap.etl -o -reportNOTE 在此命令中, tracerpt.exe是跟踪使用者工具。
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 Teresa-Motiv)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
