Поделиться через


Настройка ведения журнала ошибок API HTTP-сервера

Ведение журнала ошибок API HTTP-сервера управляется тремя значениями реестра в разделе параметров HTTP\, расположенном по адресу:

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Services
            HTTP
               Parameters

Примечание.

Расположение и форма значений конфигурации могут измениться в будущих версиях операционной системы Windows.

Пользователь должен иметь права администратора или локальной системы, чтобы изменить значения реестра, а также просмотреть или изменить файлы журнала и папку, содержащую их.

Сведения о конфигурации в значениях реестра считываются при запуске драйвера API HTTP Server. В результате, если параметры изменяются, драйвер должен быть остановлен и перезапущен для чтения новых значений. Это можно сделать с помощью следующих команд консоли:

net stop http

net start http

Файлы журнала именуются с помощью следующего соглашения:

httperr + SequenceNumber + .log

Например: "httperr4.log".

Файлы журналов циклируются, когда они достигают максимального размера, указанного значением реестра ErrorLogFileTruncateSize , и значение не может быть меньше одного мегабайта (МБ).

Если конфигурация ведения журнала ошибок недопустима или при записи в файлы журнала возникает ошибка, API HTTP-сервера использует ведение журнала событий для уведомления администраторов о том, что ведение журнала ошибок не произошло.

Значения конфигурации реестра описаны в следующей таблице.

Значение реестра Description
EnableErrorLogging DWORD, который может иметь значение 1 (означает True), чтобы включить ведение журнала ошибок или 0 (означает false), чтобы отключить его. Значение по умолчанию — 1.
ErrorLogFileTruncateSize DWORD, указывающий максимальный размер файла журнала ошибок в байтах. Значение по умолчанию — один МБ (0x100000).
Примечание. Указанное значение не может быть меньше значения по умолчанию.
ErrorLoggingDir Строка, указывающая папку, в которой API HTTP-сервера помещает файлы ведения журнала.
API HTTP-сервера создает вложенную папку с именем HTTPERR в указанной папке, в которую помещаются файлы журнала. Эта вложенная папка и файлы журналов получают те же параметры разрешений, что означает, что у администраторов и локальных системных учетных записей есть полный доступ, а другие пользователи не имеют доступа.
Если папка не указана в реестре, по умолчанию используется следующая папка:
"%SystemRoot%\System32\LogFiles"
Примечание. Строковое значение ErrorLoggingDir должно быть полным путем, но оно может содержать "%SystemRoot%".