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

HTTP Server API 错误日志记录由位于以下位置的 HTTPParameters\ 密钥下的三个注册表值控制:

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Services
            HTTP
               Parameters

注意

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

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

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

net stop http

net start http

日志文件使用以下约定进行命名:

httperr +SequenceNumber+ .log

例如:“httperr4.log”。

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

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

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

注册表值 描述
EnableErrorLogging
可以设置为 TRUE 以启用错误日志记录的 DWORD,或 FALSE 将其禁用。 默认值为 TRUE
ErrorLogFileTruncateSize
一个 DWORD ,指定错误日志文件的最大大小(以字节为单位)。 默认值为一 MB (0x100000) 。
[!注意]
指定的值不能小于默认值。

ErrorLoggingDir
一个 字符串 ,指定 HTTP 服务器 API 在其下放置其日志记录文件的文件夹。
HTTP 服务器 API 会在放置日志文件的指定文件夹下创建名为“HTTPERR”的子文件夹。 此子文件夹和日志文件接收相同的权限设置,这意味着管理员和本地系统帐户具有完全访问权限,而其他用户则无权访问。
如果未在注册表中指定文件夹,则默认文件夹如下所示:
“%SystemRoot%\System32\LogFiles”
[!注意]
ErrorLoggingDir 字符串值必须是完全限定的路径,但它可以包含“%SystemRoot%”。