Logga in

Select the product you need help with

Felloggning i HTTP API

Artikel-id: 820729

I artikeln beskrivs funktionerna f�r felloggning i HTTP-API (Hypertext Transfer Protocol).

Vissa fel som uppst�r i ett HTTP-baserat program hanteras automatiskt av HTTP-API:t i st�llet f�r att skickas tillbaka till programmet f�r hantering. Det g�rs f�r att frekvensen hos s�dana fel i annat fall kanske g�r att h�ndelseloggen eller programhanteraren sv�mmar �ver.

I f�ljande �mnen beskrivs de olika aspekterna av felloggning i HTTP-API:

Konfigurera felloggning i HTTP-API
Registerinst�llningar styr loggfelen i HTTP-API, den h�gsta till�tna storleken p� loggfilerna och platsen f�r loggfilerna.
Format f�r felloggarna i HTTP-API
I HTTP-API:t skapas loggfiler som uppfyller W3C-loggfilskonventionerna (World Wide Web Consortium). Du kan anv�nda standardverktyg f�r att tolka loggfilerna. Till skillnad fr�n W3C-loggfilerna inneh�ller loggfilerna i HTTP-API:t dock inte kolumnnamn.
Typer av fel som loggas i HTTP-API
I HTTP-API:t loggas en m�ngd vanliga fel.

Tillbaka till b�rjan | Ge feedback

Mer Information

Konfigurera felloggning i HTTP-API

Om du vill att vi ska konfigurera felloggning i HTTP-API g�r du till avsnittet L�s det �t mig. Om du hellre vill konfigurera felloggningen i HTTP-API sj�lv g�r du till avsnittet Jag l�ser det sj�lv.

L�s det �t mig

Om du vill att problemet ska �tg�rdas automatiskt klickar du p� knappen eller l�nken Fix it. Klicka sedan p� K�r i dialogrutan Filh�mtning och f�lj anvisningarna i Fix it-guiden.

Disable HTTP API error logging
Microsoft Fix it 50635

Enable HTTP API error logging
Microsoft Fix it 50634

Obs!

Den h�r guiden finns eventuellt bara p� engelska. Den automatiska korrigeringsfilen fungerar dock �ven f�r andra spr�kversioner av Windows.
Om du inte sitter vid datorn d�r problemet finns kan du spara Fix it-l�sningen p� ett flashminne eller en cd och sedan k�ra den p� r�tt dator.

Jag l�ser det sj�lv

Tre registerv�rden under nyckeln HTTP \Parameters styr felloggningen i HTTP-API. Nycklarna finns i f�ljande registernyckel:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\HTTP\Parameters

Obs! Platsen och formen f�r konfigurationsv�rdena kan �ndras i senare versioner av operativsystemet Microsoft Windows.

Du m�ste ha autentiseringsuppgifter f�r administrat�r/det lokala systemet f�r att �ndra registerv�rdena och f�r att visa eller �ndra loggfilerna och mappen som inneh�ller loggfilerna.

Konfigurationsinformation i registerv�rdena l�ses in n�r drivrutinen f�r HTTP-API startar. D�rf�r m�ste du, om du �ndrar inst�llningarna, avbryta och sedan starta om drivrutinen f�r att de nya v�rdena ska l�sas in. Skriv i s� fall f�ljande konsolkommandon:

net stop http

net start http

F�ljande namnkonvention anv�nds f�r att d�pa loggfilerna:

httperr + sekvensnummer + .log
Ett exempel: httperr4.log

Loggfilerna roteras n�r de n�r den h�gsta till�tna storleken som anges av registerv�rdet ErrorLogFileTruncateSize. V�rdet kan inte vara mindre �n 1 megabyte (MB).

Om felloggningskonfigurationen inte �r giltig eller om n�gon annan typ av fel intr�ffar medan HTTP-API:t skriver i loggfilerna anv�nder HTTP-API:t h�ndelseloggning f�r att meddela administrat�rerna att felloggning inte sker.

I f�ljande tabell beskrivs registerkonfigurationsv�rdena.

D�lj tabellenVisa tabellen

Registerv�rde	Beskrivning
EnableErrorLogging	Ett DWORD-v�rde som du kan st�lla in p� TRUE f�r att aktivera felloggning eller FALSE f�r att inaktivera det. Standardv�rdet �r TRUE.
ErrorLogFileTruncateSize	Ett DWORD-v�rde som anger h�gsta till�tna storlek p� en felloggfil, anges i byte. Standardv�rdet �r 1 MB (0x100000). Obs! Det angivna v�rdet kan inte vara mindre �n standardv�rdet.
ErrorLoggingDir	En str�ng som anger mappen d�r HTTP-API placerar sina loggfiler. HTTP-API skapar undermappen HTTPERR i den angivna mappen och sparar sedan loggfilerna i undermappen. Undermappen och loggfilerna f�r samma beh�righetsinst�llningar. Administrat�rskontot och kontot f�r det lokala systemet f�r fullst�ndig �tkomst. Andra anv�ndare f�r inte �tkomst. F�ljande �r standardmappen n�r mapp inte anges i registret: %SystemRoot%\System32\LogFiles Obs! Str�ngv�rdet ErrorLoggingDir m�ste vara en fullt giltig lokal s�kv�g. Det kan dock inneh�lla %SystemRoot%. En n�tverksenhet eller n�tverksresurs f�r inte anv�ndas.

Format f�r felloggarna i HTTP-API

I allm�nhet har felloggarna i HTTP-API samma format som W3C-felloggarna, f�rutom att felloggarna i HTTP-API inte inneh�ller kolumnrubriker. Varje rad i en HTTP-API-fellogg inneh�ller ett fel. F�lten visas i en viss ordning. Ett enkelt blanksteg (0x0020) skiljer ett f�lt fr�n f�reg�ende f�lt. I varje f�lt ers�tter plustecknen (0x002B) blanksteg, tabbar och icke-utskrivbara kontrolltecken.

I f�ljande tabell anges f�lten och ordningen f�r f�lten i en felloggspost.

D�lj tabellenVisa tabellen

F�lt	Beskrivning
Datum	Datumf�ltet f�ljer W3C-formatet. F�ltet baseras p� UTC-tid (Coordinated Universal Time). Datumf�ltet inneh�ller alltid 10 tecken enligt formatet ��-MM-DD. Exempel: 1 maj 2003 skrivs 2003-05-01.
Tid	Tidsf�ltet f�ljer W3C-formatet. F�ltet baseras p� UTC-tid. Tidsf�ltet inneh�ller alltid 8 tecken enligt formatet MM:HH:SS. Exempel: 5:30 PM (UTC) skrivs 17:30:00.
Klientens IP-adress	Den ber�rda klientens IP-adress. V�rdet i f�ltet kan vara antingen en IPv4-adress eller en IPv6-adress. Om klientens IP-adress �r en IPv6-adress ing�r f�ltet Scopeld ocks� i adressen.
Klientport	Den ber�rda klientens portnummer.
Serverns IP-adress	Den ber�rda serverns IP-adress. V�rdet i f�ltet kan vara antingen en IPv4-adress eller en IPv6-adress. Om serverns IP-adress �r en IPv6-adress ing�r f�ltet Scopeld ocks� i adressen.
Serverport	Den ber�rda serverns portnummer.
Protokollversion	Protokollversionen som anv�nds. Om anslutningen inte har tolkats tillr�ckligt f�r att kunna fastst�lla protokollversionen anv�nds ett bindestreck (0x002D) som platsh�llare f�r det tomma f�ltet. Om antingen det h�gre versionsnumret eller det l�gre versionsnumret tolkas som st�rre �n eller lika med 10 loggas versionen som HTTP/?.?.
Verb	Verb inneb�r att den senaste beg�ran som tolkades godk�nns. Ok�nda verb tas med, men verb som �r mer �n 255 byte trunkeras till denna l�ngd. Om ett verb inte �r tillg�ngligt anv�nds ett bindestreck (0x002D) som platsh�llare f�r det tomma f�ltet.
CookedURL + fr�ga	URL och fr�gor som associeras med detta loggas som ett f�lt som �tskiljs med ett fr�getecken (0x3F). F�ltet trunkeras med en l�ngdbegr�nsning p� 4�096 byte. Om URL-adressen har tolkats ("cooked") loggas den med konverteringen i den lokala teckentabellen och hanteras som ett Unicode-f�lt. Om URL-adressen inte har tolkats ("cooked") vid tidpunkten f�r loggningen kopieras den exakt, utan n�gon Unicode-konvertering. Om HTTP-API inte kan tolka URL-adressen anv�nds ett bindestreck (0x002D) som platsh�llare f�r det tomma f�ltet.
Protokollstatus	Protokollstatus kan inte vara st�rre �n 999. Om protokollstatus f�r svar p� en beg�ran �r tillg�ngligt loggas det i det h�r f�ltet. Om protokollstatus inte �r tillg�ngligt anv�nds ett bindestreck (0x002D) som platsh�llare f�r det tomma f�ltet.
SiteId	Anv�nds inte i den h�r versionen av HTTP-API. Ett platsh�llarbindestreck (0x002D) visas alltid i det h�r f�ltet.
Orsaksfras	F�ltet inneh�ller en str�ng som anger vilken typ av fel som loggas. F�ltet l�mnas aldrig tomt.
K�namn	Detta �r k�namn f�r beg�ran.

F�ljande exempelrader �r h�mtade fr�n en fellogg i HTTP-API:

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

Typer av fel som loggas i HTTP-API

I HTTP-API loggas felsvar till klienter, timeout f�r anslutningar, �vergivna beg�randen och avbrutna anslutningar som hanteras felaktigt.

I f�ljande lista anges vilka typer av fel som loggas i HTTP-API:

Svar till klienter HTTP-API skickar ett felsvar till en klient, till exempel ett 400-fel som orsakas av ett tolkningsfel i den senast mottagna beg�ran. N�r HTTP-API har skickat felsvaret avslutas anslutningen.
Timeout f�r anslutningar HTTP-API avbryter en anslutning p� grund av timeout. Om en beg�ran v�ntar n�r anslutningen avbryts p� grund av timeout anv�nds beg�ran f�r att f� mer information om anslutningen i felloggen.
�vergivna beg�randen En process i anv�ndarl�ge avbryts ov�ntat n�r det fortfarande finns andra beg�randen i k� som dirigeras till den processen. HTTP-API loggar de �vergivna beg�randena i felloggen.

S�rskilda feltyper betecknas som str�ngen Orsaksfras och visas alltid som sista f�lt i varje felrad. I f�ljande tabell anges orsaksfraserna i HTTP-API.

D�lj tabellenVisa tabellen

Orsaksfras	Beskrivning
AppOffline	Felet tj�nsten �r inte tillg�nglig intr�ffade (HTTP-fel 503). Tj�nsten �r inte tillg�nglig eftersom programfel gjorde s� att programmet kopplades fr�n.
AppPoolTimer	Felet tj�nsten �r inte tillg�nglig intr�ffade (HTTP-fel 503). Tj�nsten �r inte tillg�nglig eftersom programmets poolprocess �r f�r upptagen f�r att hantera beg�ran.
AppShutdown	Felet tj�nsten �r inte tillg�nglig intr�ffade (HTTP-fel 503). Tj�nsten �r inte tillg�nglig eftersom programmet automatiskt stoppats som svar p� en administrat�rsprincip.
BadRequest	Ett tolkningsfel intr�ffade n�r beg�ran bearbetades.
Client_Reset	Anslutningen mellan klienten och servern har st�ngts innan beg�ran kunde tilldelas en jobbprocess. Den vanligaste orsaken till detta �r att klienten stoppar sin anslutning till servern f�r tidigt.
Connection_Abandoned_By_AppPool	En jobbprocess fr�n programpoolen har avbrutits ov�ntat eller �vergett en v�ntande beg�ran genom att st�nga referensen.
Connection_Abandoned_By_ReqQueue	En jobbprocess fr�n programpoolen har avbrutits ov�ntat eller �vergett en v�ntande beg�ran genom att st�nga referensen. Speciellt f�r Windows Vista och Windows Server 2008.
Connection_Dropped	Anslutningen mellan klient och server har st�ngts innan servern hann skicka det slutliga svarspaketet. Den vanligaste orsaken till detta �r att klienten stoppar sin anslutning till servern f�r tidigt.
Connection_Dropped_List_Full	Listan med avbrutna anslutningar mellan klient och server �r full. Speciellt f�r Windows Vista och Windows Server 2008.
ConnLimit	Felet tj�nsten �r inte tillg�nglig intr�ffade (HTTP-fel 503). Tj�nsten �r inte tillg�nglig eftersom anslutningsgr�nsen f�r webbplatsniv�n har uppn�tts eller �verskridits.
Connections_Refused	Kernel-minnet NonPagedPool har fallit under 20 MB och http.sys har slutat att ta emot nya anslutningar
Inaktiverad	Felet tj�nsten �r inte tillg�nglig intr�ffade (HTTP-fel 503). Tj�nsten �r inte tillg�nglig eftersom en administrat�r har kopplat fr�n programmet.
EntityTooLarge	En enhet har �verskridit den h�gsta till�tna storleken.
FieldLength	Gr�nsen f�r f�ltl�ngd har �verskridits.
F�rbjuden	Ett f�rbjudet element eller en f�rbjuden sekvens uppt�cktes vid tolkningen.
Huvud	Ett tolkningsfel uppstod i ett huvud.
V�rdnamn	Ett tolkningsfel uppstod n�r V�rdnamn bearbetades.
Intern	Det uppstod ett internt serverfel (HTTP-fel 500).
Invalid_CR/LF	En ogiltig vagnretur eller radmatning har intr�ffat.
LengthRequired	Ett obligatoriskt v�rde f�r l�ngd saknas.
Saknas	Felet tj�nsten �r inte tillg�nglig intr�ffade (HTTP-fel 503). Tj�nsten �r inte tillg�nglig p� grund av ett internt serverfel (till exempel fel i minnesallokeringen).
Ej implementerat	Felet ej implementerat uppstod (HTTP-fel 501), eller felet tj�nsten �r inte tillg�nglig uppstod (HTTP-fel 503) p� grund av en ok�nd �verf�ringskodning.
Nummer	Ett tolkningsfel uppstod n�r ett nummer bearbetades.
F�rhandsvillkor	Ett obligatoriskt f�rhandsvillkor saknas.
QueueFull	Felet tj�nsten �r inte tillg�nglig intr�ffade (HTTP-fel 503). Tj�nsten �r inte tillg�nglig eftersom k�n f�r programbeg�randen �r full.
RequestLength	Gr�nsen f�r beg�randel�ngd har �verskridits.
Timer_AppPool	Anslutningen har upph�rt eftersom en beg�ran v�ntat f�r l�nge i en programpoolsk� p� att ett serverprogram skulle ta beg�ran ur k�n och bearbeta den. Varaktigheten f�r timeout �r ConnectionTimeout. Standardv�rdet f�r det h�r v�rdet �r 2 minuter.
Timer_ConnectionIdle	Anslutningen har upph�rt och �r i vilol�ge. Standardvaraktigheten f�r ConnectionTimeout �r 2 minuter.
Timer_EntityBody	Anslutningen har upph�rt innan beg�rans enhetstext kommit fram. N�r det st�r klart att en beg�ran inneh�ller enhetstext aktiverar HTTP-API timern Timer_EntityBody. Inledningsvis �r gr�nsen f�r timern inst�lld p� v�rdet ConnectionTimeout (vanligtvis 2 minuter). Varje g�ng en till dataindikering tas emot i beg�ran st�ller HTTP-API tillbaka timern s� att anslutningen f�r ytterligare 2 minuter (eller det v�rde som anges i ConnectionTimeout).
Timer_HeaderWait	Anslutningen har upph�rt eftersom huvudet som tolkar beg�ran dr�jde l�ngre �n standardgr�nsen p� 2 minuter.
Timer_MinBytesPerSecond	Anslutningen har upph�rt eftersom klienten inte tagit emot ett svar i en rimlig hastighet. Svarshastigheten f�r att skicka var l�ngsammare �n standardhastigheten p� 240 byte/s. Det kan kontrolleras med metabasegenskapen MinFileBytesPerSec.
Timer_ReqQueue	Anslutningen har upph�rt eftersom en beg�ran v�ntat f�r l�nge i en programpoolsk� p� att ett serverprogram skulle ta beg�ran ur k�n. Varaktigheten f�r timeout �r ConnectionTimeout. Standardv�rdet f�r det h�r v�rdet �r 2 minuter. Speciellt f�r Windows Vista och Windows Server 2008.
Timer_Response	F�rbeh�ll. Anv�nds inte f�r n�rvarande.
Timer_SslRenegotiation	Anslutningen har upph�rt eftersom SSL-omf�rhandlingen mellan klient och server dr�jde l�ngre �n standardtimeouten p� 2 minuter.
URL	Ett tolkningsfel uppstod n�r URL bearbetades.
URL_Length	En URL-adress har �verskridit den h�gsta till�tna storleken.
Verb	Ett tolkningsfel uppstod n�r ett verb bearbetades.
Version_N/S	Felet versionen st�ds inte intr�ffade (HTTP-fel 505).

Tillbaka till b�rjan | Ge feedback

Referenser

Om du vill veta mer om att l�gga till ytterligare loggningsf�lt f�r IIS HTTP-felloggning klickar du p� f�ljande artikelnummer och l�ser artikeln i Microsoft Knowledge Base:

832975

(http://support.microsoft.com/kb/832975/ )

Ytterligare egenskaper �r nu tillg�ngliga f�r loggning i filen Httperr#.log i IIS 6.0 och IIS 7.0 (Detta kan vara p� engelska)

Tillbaka till b�rjan | Ge feedback

Obs! Det h�r �r en "FAST PUBLISH?-artikel som skapats direkt inom Microsofts supportorganisation. Informationen i artikeln tillhandah�lls i befintligt skick f�r att besvara framtida fr�gor. P� grund av den snabba framtagningen kan materialet inneh�lla typografiska fel och kan utan f�rvarning n�r som helst komma att omarbetas. Se anv�ndarvillkoren

(http://go.microsoft.com/fwlink/?LinkId=151500)

f�r andra h�nsynstaganden.

Tillbaka till b�rjan | Ge feedback