Зараз ви перебуваєте в автономному режимі; очікується повторне підключення до Інтернету

Журналювання помилок в HTTP-інтерфейси (API)

ВАЖЛИВО! Ця стаття перекладена засобами машинного перекладу Microsoft. Статтю можна редагувати в середовищі Community Translation Framework (CTF). Щоб якомога швидше перекласти всі статті у своїй базі знань різними мовами, компанія Microsoft не лише звертається до професійних перекладачів, але й вдається до машинного перекладу, який потім редагується спільнотою. Такі статті можуть містити лексичні, синтаксичні та граматичні помилки. Microsoft не несе відповідальності за будь-які неточності, помилки або збитки, до яких може призвести неправильний переклад статей або їх використання. Докладніше про CTF див. на веб-сторінці http://support.microsoft.com/gp/machine-translation-corrections/uk-ua.

Клацніть тут, щоб переглянути цю статтю англійською мовою: 820729
Підсумки
У цій статті у цій статті описано можливості журналювання для помилок HTTP-інтерфейси API.

Замість того, щоб повертати назад у застосунки для обробки інтерфейс API HTTP автоматично обробляє помилок, які відбуваються в HTTP-застосунок. Це трапляється через те, що частотність появи таких помилок може в іншому разі переповнювали б запис А подій або обробник застосунку.

У розділах нижче, описано різні аспекти журналювання помилок в інтерфейсі прикладних програм HTTP.
  • Настроювання інтерфейсу API HTTP errorlogging
    Параметри реєстру керують інтерфейс API HTTP реєструє, помилки, themaximum, дозволений розмір файлів журналу а також розташування файлів журналу.
  • Формат HTTP-APIerror журналів.
    Інтерфейс API HTTP створює файли журналу, які відповідають, із theWorld Wide Web консорціум (W3C) щодо файлів журналу. Аналіз цих файлів журналу можна стандартних засобів. Однак, на відміну від W3C, файли журналу, інтерфейсу API HTTP робити notcontain імен стовпців.
  • Типи помилок інтерфейсу API HTTP реєструє.
    Інтерфейс API HTTP-реєструє багато поширених помилок.
Розв'язанн

Настроювання журналювання помилок в HTTP API

Три значення реєстру, з HTTP \Parameters ключі, керування ведення журналу помилок інтерфейсу API HTTP. Їх розташовано в такому розділі реєстру:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\HTTP\Parameters
Примітка. Розташування, так і форма значень конфігурації можуть змінюватися в пізніших версіях операційної системи Windows.

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

Відомості про конфігурацію, в значення реєстру читання під Вільний час запуску драйвера інтерфейсу API HTTP. Таким чином, якщо змінити настройки, необхідно зупинити й перезавантажте драйвера, щоб прочитати нові значення. Для цього, введіть такі команди в консолі:
net stop http.
net start http.
Використовуються такі іменування для імен файлів журналу:
httperr + Порядковий номер +. log
Наприклад:- httperr4.log
Файли журналу створюються, після того, як вони досягти максимального розміру, яке вказує на значення реєстру ErrorLogFileTruncateSize . Це значення не може бути не менше за 1 мегабайт (МБ).

Якщо це неприпустима конфігурація журналювання помилок або будь-які помилки, виникає під Вільний час записування файлів журналу інтерфейсу API HTTP, інтерфейс API HTTP використає журналювання подій оповіщення адміністраторів, журналювання помилок не відбувається.

У наведеній нижче таблиці описано значення конфігурації реєстру.
Параметр реєструОпис
EnableErrorLoggingДо типу DWORD , можна встановити TRUE, щоб активувати журналювання помилок, або FALSE, щоб вимкнути його. TRUE – це значення за промовчанням.
ErrorLogFileTruncateSizeДо типу DWORD , що визначає максимальний розмір файлу журналу помилок в байтах. значення за промовчанням – на 1 Мб (0x100000 – це).

Примітка. Указане значення не може бути не менше за значення за промовчанням.
ErrorLoggingDirРядок , який визначає каталог вхідних повідомлень, в якій, інтерфейс API HTTP записує свої файли журналювання.

Інтерфейс API HTTP, створює вкладену каталог вхідних повідомлень HTTPERR у вказаній папці а потім зберігає файли журналу в папці. Ця вкладена папка й файли журналу, отримують однакові параметри дозволів. Адміністратора та в локальних системних облікових записів, мають повний доступ. Інші користувачі не мають доступу.

Нижче наведено каталог вхідних повідомлень за промовчанням під Вільний час папки не вказано в реєстрі:
%SystemRoot%\System32\LogFiles

Примітка. Значення рядка " ErrorLoggingDir ", має бути повним іменем локальний шлях. Проте може містити % SystemRoot %. Не можна використовувати мережний дублювання диска або мережну каталог вхідних повідомлень.

на початок

Формат журналів помилок інтерфейсу API HTTP

Як правило, файли журналу інтерфейсу API HTTP-помилки мають формат журналів помилок W3C за винятком того, що файли журналу інтерфейсу API HTTP-помилки, не містять заголовків стовпців. Кожен рядок журналу помилок інтерфейсу API HTTP, записується одна помилка. Поля, що відображаються в певному порядку. Символом пробілу (0x0020) відокремлює в кожному полі від. У кожному полі знаки знаки-плюс (0x002B) замінює символи пробілів, табуляції та недрукованих керуючих символів.

У наведеній нижче таблиці визначено, що поля та порядок їх розташування в записі журналу помилок.
ПолеОпис
ДатаПоле "Дата", відповідає формату W3C. Це поле базується на всесвітній координований Вільний час (UTC). Поле "Дата" – це завжди містить десять символів у вигляді РРРР-ММ-ДД. Наприклад, 1 травня 2003 р. відображено як 2003-05-01.
Вільний часПоле "час", відповідає формату W3C. Це поле на основі UTC. Поле "час"-це завжди містить вісім символів у формі: ХХ: СС. Наприклад, 17:30:00 (UTC) відображено як 17:30:00.
IP-адреса клієнтаIP-адреса постраждалого клієнта. Значення цього поля, може бути адреса IPv4 "або" адреса IPv6. Якщо IP-адреса клієнта адреси IPv6, поле означає також включено до адреси.
Порт клієнтаНомер порту постраждалого клієнта.
IP-адресаIP-адреса постраждалого сервера. Значення цього поля, може бути адреса IPv4 "або" адреса IPv6. Якщо IP-адресу сервера адреси IPv6, поле означає також включено до адреси.
Порт сервераНомер порту постраждалого сервера.
Версія протоколуВерсія протоколу, який використовується.

Якщо це підключення має не було проаналізувати достатньо todetermine версію протоколу, дефіс (0x002D), що використовується як на placeholderfor пустого поля.

Якщо номер проміжної версії, або номер основної версії isgreater, ніж виконання аналізу, або дорівнює 10, то версія реєструватиметься як HTTP /?.?.
КомандаДо останнього запит на змінення стан команди після виконання аналізу. Невідомі команди також включено, але команди, довші за 255 байтів, скорочуються до цієї довжини. Якщо команда недоступна, дефіс (0x002D) використовується як покажчик місця заповнення для пустого поля.
CookedURL + QueryURL-адресу і будь-який запит, пов'язаного з помилками реєструються як одне поле, в якому їх розділено знаком питання (0x3F). Це поле, скорочується до максимальної довжини 4096 байт.

Якщо цю URL-адресу було виконання аналізу ("приготовані"), вона реєструється з локальну кодову сторінку перетворення і обробляється як поле в кодуванні Юнікод.

Якщо в цю URL-адресу має не Вільний час виконання аналізу ("приготовані") на thetime, журналювання, вона копіюється без перетворення в Юнікод.

Якщо це інтерфейс API HTTP, не вдалося проаналізувати цю URL-адресу, у hyphen(0x002D) використовується як покажчик місця заповнення для пустого поля.
Стан протоколуСтан протоколу не може перевищувати 999.

Якщо стан протоколу відповіді requestis, доступний, він реєструється в цьому полі.

Якщо стан протоколу недоступний, до hyphen(0x002D) використовується як покажчик місця заповнення для пустого поля.
Ідентифікатор сайтуНе використовується в цій версії інтерфейсу API HTTP. Покажчик місця заповнення дефіс (0x002D), завжди відображається в цьому полі.
Вираз причиниЦе поле містить, рядок, який визначає тип помилки, які записуються. Це поле завжди заповнено.
Назва чергиЦе назва черги запит на змінення.
Нижче наведено зразки рядків, які з журнал помилок інтерфейсу API HTTP:
2002-07-05 18:45:09 172.31.77.6 2094 172.31.77.6 80 HTTP/1.1 GET /qos/1kbfile.txt 503 – ConnLimit 2002-07-05 19:51:59 127.0.0.1 2780 127.0.0.1 80 HTTP/1.1 GET /ThisIsMyUrl.htm 400 – Hostname 2002-07-05 19:53:00 127.0.0.1 2894 127.0.0.1 80 HTTP/2.0 GET / 505 - Version_N/S 2002-07-05 20:06:01 172.31.77.6 64388 127.0.0.1 80--Timer_MinBytesPerSecond
на початок

Типи помилок, які інтерфейс API HTTP реєструє.

Інтерфейс API HTTP реєструє, помилка відповіді клієнтам, вичерпання часу очікування на підключення, загублені запити й роз'єднані підключення, оброблені неналежним чином.

У наведеному нижче списку, визначає типи помилок, які буде зареєстровано інтерфейс API HTTP:
  • Відповіді клієнтам Інтерфейс API HTTP, надсилає клієнту, наприклад помилку 400, яку спричиняє помилка виконання аналізу останнього отриманого запит на змінення, у відповідь про помилку. Після того, як інтерфейс API HTTP, надсилає відповідь про помилку, буде закрито підключення.
  • Часи очікування підключення Інтерфейс API HTTP, часу очікування на підключення. Якщо запит перебуває у стані очікування, Вільний час очікування відповіді whenthe підключення, запит, що використовується для забезпечення, дізнатися більше про theconnection, в журналі помилок.
  • Orphaned запити. Будь-який процес режиму користувача припиняє роботу, а запити досі очікують у черзі маршрутизація. Інтерфейс API HTTP реєструє загублені запити, в журналі помилок.
Тип помилки зазначено в рядках Вираз причини рядків, які завжди відображаються як останні поля кожного рядка, помилка. Нижче наведено список за допомогою вирази причин інтерфейсу API HTTP.
Вираз причиниОпис

AppOfflineСлужба недоступна помилка (помилка HTTP 503). Служба недоступна, тому, що помилки застосунку спричинили його перехід в автономний режим.
AppPoolTimerСлужба недоступна помилка (помилка HTTP 503). Служба недоступна, тому, що процес пул застосунків перевантажено обробити запит.
AppShutdownСлужба недоступна помилка (помилка HTTP 503). Служба недоступна, тому, що застосунок було автоматично вимкнуто в політикою адміністратора.
BadRequestПід Вільний час обробки запит на змінення сталася помилка аналізу.
Client_ResetЗ'єднання між клієнтом і сервером було закрито, перш ніж призначенням запит на змінення робочому процесу. Найчастіше причиною такої поведінки є, клієнт бути передчасне закриття його підключення до сервера.
Connection_Abandoned_By_AppPoolРобочий процес із пул застосунків неочікувано завершив роботу або загублені у черзі запит, закривши його обробника.
Connection_Abandoned_By_ReqQueueРобочий процес із пул застосунків неочікувано завершив роботу або загублені у черзі запит, закривши його обробника. Конкретні ОС Windows Vista та пізніших версій, так і для Windows Server 2008 і пізніших версій.
Connection_DroppedЗ'єднання між клієнтом і сервером було закрито, перш ніж сервер може надіслати надіслав останній пакет відповіді. Найчастіше причиною такої поведінки є, клієнт бути передчасне закриття його підключення до сервера.
Connection_Dropped_List_FullСписок роз'єднаних підключень між клієнтами й сервером заповнено. Конкретні ОС Windows Vista та пізніших версій, так і для Windows Server 2008 і пізніших версій.
ConnLimitУ Служба недоступна помилка (помилка HTTP 503). Служба недоступна, тому обмеження підключень на рівні сайту досягнуто або перевищено.
Connections_RefusedNonPagedPool пам'ять ядра зменшився до 20 МБ, і HTTP. sys, припинив приймати нові підключення
ВимкнутоСлужба недоступна помилка (помилка HTTP 503). Служба недоступна, тому що адміністратор перевів застосунок в автономному режимі.
EntityTooLargeСутність, перевищила максимально дозволений розмір.
FieldLengthПеревищено обмеження довжину поля.
Заборонено.Під час виконання аналізу було виявлено заборонений елемент або послідовність.
ЗаголовокУ заголовку сталася помилка аналізу.
Ім'я хостаПід час обробки імені хоста сталася помилка аналізу.
ВнутрішнійЄ внутрішня помилка сервера (помилка HTTP 500).
Invalid_CR/LFСталася на неприпустиме повернення каретки або переведення рядка.
LengthRequiredНеобхідне значення довжини відсутня.
Н/ДСлужба недоступна помилка (помилка HTTP 503). Служба недоступна, тому, що Сталася внутрішня помилка (наприклад, помилка розподілення пам'яті або URL-адресу резервування список конфлікт).
N-ЯУ невпроваджена помилка (помилка HTTP 501) або до служби недоступний помилка (помилка HTTP 503) через невідоме кодування передавання.
НомерПід час обробки номера сталася помилка аналізу.
ПередумоваТакож відсутня необхідна передумова.
QueueFullСлужба недоступна помилка (помилка HTTP 503). Служба недоступна, тому що чергу запитів застосунку заповнено.
RequestLengthПеревищено обмеження довжини запит.
Timer_AppPoolТермін підключення минув, оскільки запит задовго очікував у черзі пулу застосунку на застосунок-сервер, де-черги та обробить його. Цей час очікування, тривалість, є ConnectionTimeout. За промовчанням цей параметр встановлено дві хвилини.
Timer_ConnectionIdleПідключення минув і тепер воно недіюче. Тривалість ConnectionTimeout за промовчанням – це дві хвилини.
Timer_EntityBodyТермін підключення минув до тіла сутності запиту. Коли запит чітко тіло сутності, інтерфейс API HTTP вмикає таймер Timer_EntityBody . По-перше обмеження таймера встановлено значення ConnectionTimeout (як правило, дві хвилини). Кожного разу, що інший отримання даних за цим запитом, інтерфейс API HTTP скидає таймер, щоб продовжити підключення дві хвилини (або, визначений параметром ConnectionTimeout).
Timer_HeaderWaitТермін підключення минув, оскільки запит на виконання аналізу заголовка перевищило більше за промовчанням становить дві хвилини.
Timer_MinBytesPerSecondТермін підключення минув, оскільки клієнт не отримав відповіді з очікуваною швидкістю. Швидкість надсилання відповіді була нижчою за за промовчанням 240 байт/с. Її можна змінювати MinFileBytesPerSec властивість метабази.
Timer_ReqQueueТермін підключення минув, оскільки запит задовго очікував у черзі пулу застосунку на застосунок-сервер, де-черги. Цей час очікування, тривалість, є ConnectionTimeout. За промовчанням цей параметр встановлено дві хвилини. Конкретні ОС Windows Vista та пізніших версій, так і для Windows Server 2008 і пізніших версій.
Timer_ResponseЗарезервовано. Наразі не використовується.
Timer_SslRenegotiationТермін підключення минув, оскільки повторне узгодження SSL між клієнтом і сервером тривало довше, ніж становить дві хвилини, очікування за промовчанням.
URL-АДРЕСАПід час обробки URL-адреса – сталася помилка аналізу.
URL_LengthURL-адреса, перевищила максимально дозволений розмір.
КомандаПід час обробки команди сталася помилка аналізу.
Version_N/SУ версії не підтримується помилка (помилка HTTP 505).

на початок
Посилання
Щоб отримати додаткові відомості про додавання додаткових полів для журналювання помилок IIS HTTP клацніть номер статті в базі знань Microsoft Knowledge Base:
832975 Додаткові властивості тепер доступні для входу у файлі Httperr # .log у службах IIS 6.0 та IIS 7.0

Попередження. Цю статтю переведено автоматично

Властивості

Ідентифікатор статті: 820729 – останній перегляд: 08/06/2016 01:26:00 – виправлення: 5.0

Windows Server 2008 R2 Standard, Windows Server 2008 R2 Enterprise, Windows Server 2008 Enterprise, Windows Server 2012 R2 Standard, Windows Server 2012 R2 Datacenter, Windows Server 2012 R2 Essentials, Windows Server 2012 R2 for Embedded Systems, Windows Server 2012 R2 Foundation, Windows Server 2012 Standard, Windows Server 2012 Datacenter, Windows Server 2012 Essentials, Windows 10, Windows 10 Enterprise, released in July 2015, Windows 10 Pro, released in July 2015, Windows 10 Version 1511, Windows 8.1, Windows 8.1 Enterprise, Windows 8.1 Pro, Windows 8, Windows 8 Pro, Windows 8 Enterprise, Windows 7 Professional, Windows 7 Enterprise

  • kbhttphandlers kbhttp kbapi kberrmsg kbinfo kbmt KB820729 KbMtuk
Зворотний зв’язок