配置 HTTP 服务器 API 错误日志记录

  • 项目

HTTP 服务器 API 错误日志记录由位于 的 HTTP\参数 项下的三个注册表值控制：

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Services
            HTTP
               Parameters

注意

配置值的位置和形式在 Windows 操作系统的未来版本中可能会更改。

用户必须具有管理员/本地系统权限才能修改注册表值，以及查看或修改日志文件以及包含它们的文件夹。

启动 HTTP 服务器 API 驱动程序时，将读取注册表值中的配置信息。 因此，如果更改了设置，则必须停止并重启驱动程序才能读取新值。 这可以通过使用以下控制台命令来实现：

net stop http

net start http

使用以下约定命名日志文件：

httperr +SequenceNumber+ .log

例如：“httperr4.log”。

日志文件在达到 ErrorLogFileTruncateSize 注册表值指定的最大大小时循环，并且该值不能小于 1 MB (MB) 。

如果错误日志记录的配置无效，或者在写入日志文件时发生任何类型的故障，HTTP 服务器 API 将使用事件日志记录来通知管理员错误日志记录未发生。

下表描述了注册表配置值。

注册表值 说明
EnableErrorLogging
 可设置为 TRUE 以启用错误日志记录的 DWORD，或设置为 FALSE 以禁用它。 默认值为 TRUE。
ErrorLogFileTruncateSize
 一个 DWORD ，指定错误日志文件的最大大小（以字节为单位）。 默认值为 1 MB (0x100000) 。
注意： 指定的值不能小于默认值。
ErrorLoggingDir
 一个字符串，指定 HTTP 服务器 API 在其下放置其日志记录文件的文件夹。
HTTP 服务器 API 在日志文件所在的指定文件夹下创建名为“HTTPERR”的子文件夹。 此子文件夹和日志文件接收相同的权限设置，这意味着管理员和本地系统帐户具有完全访问权限，而其他用户没有访问权限。
如果未在注册表中指定文件夹，则默认文件夹如下所示：
“%SystemRoot%\System32\LogFiles”
注意： ErrorLoggingDir 字符串值必须是完全限定的路径，但它可以包含“%SystemRoot%”。