Dela via


W3C-loggning

W3C utökad loggning är en typ av loggning på serversidan som kan aktiveras på serversessionen eller URL-gruppen. När W3C-loggning är aktiverad i en URL-grupp utförs loggning endast på begäranden som dirigeras till URL-gruppen. En separat loggfil skapas för varje URL-grupp som konfigurerats för att aktivera W3C-loggning.

När W3C-loggning är aktiverad på serversessionen fungerar den som centraliserad form av loggning för alla URL-grupper under serversessionen. En enda loggfil underhålls för alla URL-grupper i serversessionen.

I följande tabell visas de fält som kan loggas av HTTP Server-API:et. Tabellen innehåller en delmängd av HTTP_LOG_FIELD konstanter. Vissa av fälten som anges nedan genereras automatiskt av HTTP Server API internt och finns därför inte i HTTP_LOG_FIELDS_DATA struktur. Kolumnen "Visas som" innehåller texten som visas i loggfilen. Data i tabellen är i händelseordning i loggfilsposten.

Fält som inte har markerats som "HTTP Server API genereras" måste skickas i HTTP_LOG_FIELDS_DATA struktur efter program. Programmet kan generera dessa fält från den HTTP_REQUEST struktur som skickas till det.

Fält Visas som Beskrivning HTTP_LOG_FIELDS_DATA medlem HTTP_LOG_FIELDS konstanter
Datum datum Det datum då aktiviteten inträffade. HTTP Server-API:et har genererats. HTTP_LOG_FIELD_DATE
Tid Tid Tiden, i samordnad universell tid (UTC), då aktiviteten inträffade. HTTP Server-API:et har genererats. HTTP_LOG_FIELD_TIME
Tjänstnamn och instansnummer s-sitename Internettjänstens namn och instansnummer som kördes på klienten. ServiceName HTTP_LOG_FIELD_SITE_NAME
Servernamn s-computername Namnet på den server där loggfilsposten genererades. ServerName HTTP_LOG_FIELD_COMPUTER_NAME
Serverns IP-adress s-ip IP-adressen för servern där loggfilsposten genererades. Serverip HTTP_LOG_FIELD_SERVER_IP
Metod cs-method Det begärda verbet, till exempel en GET-metod. Metod HTTP_LOG_FIELD_METHOD
URI-stam cs-uri-stem Verbets mål, till exempel Default.htm. UriStem HTTP_LOG_FIELD_URI_STEM
URI-fråga cs-uri-query Den fråga, om någon, som klienten försökte utföra. En URI-fråga (Universal Resource Identifier) krävs endast för dynamiska sidor. UriQuery HTTP_LOG_FIELD_URI_QUERY
Serverport s-port Det serverportnummer som har konfigurerats för tjänsten. ServerPort HTTP_LOG_FIELD_SERVER_PORT
Användarnamn cs-username Namnet på den autentiserade användare som har åtkomst till servern. Anonyma användare anges med ett bindestreck. Användarnamn HTTP_LOG_FIELD_USER_NAME
Klientens IP-adress c-ip IP-adressen för klienten som gjorde begäran. ClientIp HTTP_LOG_FIELD_CLIENT_IP
Protokollversion cs-version DEN HTTP-protokollversion som klienten använde. HTTP Server-API:et har genererats. HTTP_LOG_FIELD_VERSION
Användaragent cs(User-Agent) Webbläsartypen som klienten använde. UserAgent HTTP_LOG_FIELD_USER_AGENT
Småkaka cs(Cookie) Innehållet i cookien som skickas eller tas emot, om någon. Småkaka HTTP_LOG_FIELD_COOKIE
Hänvisningsadress cs(Referrer) Den webbplats som användaren senast besökte. Den här webbplatsen tillhandahöll en länk till den aktuella webbplatsen. Hänvisningsadress HTTP_LOG_FIELD_REFERRER
Värd cs-host Namnet på värdrubriken, om det finns. Värd HTTP_LOG_FIELD_HOST
HTTP-status sc-status HTTP-statuskoden. ProtocolStatus HTTP_LOG_FIELD_STATUS
Protokollunderstatus sc-substatus Felkoden understatus. Understatus HTTP_LOG_FIELD_SUB_STATUS
Win32-status sc-win32-status Windows-statuskoden. Win32Status HTTP_LOG_FIELD_WIN32_STATUS
Skickade byte sc-byte Antalet byte som skickas av servern. HTTP Server-API:et har genererats. HTTP_LOG_FIELD_BYTES_SENT
Mottagna byte cs-bytes Antalet byte som tas emot och bearbetas av servern. HTTP Server-API:et har genererats. HTTP_LOG_FIELD_BYTES_RECV
Tidsåtgång tidsåtgång Hur lång tid åtgärden tog, i millisekunder. HTTP Server-API:et har genererats. HTTP_LOG_FIELD_TIME_TAKEN
Stream-ID streamid Stream-ID:t. HTTP Server-API:et har genererats. HTTP_LOG_FIELD_STREAM_ID

 

Loggfilen är ett anpassningsbart ASCII-textbaserat format. Fältprefixen i filen definieras på följande sätt:

Prefix Beskrivning
s Serveråtgärder.
c Klientåtgärder.
Sc Åtgärder från server till klient.
Cs Åtgärder från klient till server.

 

Programmet kan välja ett eller flera av W3C Extended-loggfilfälten, men inte alla fält innehåller information. För fält som är markerade men där det inte finns någon information visas ett bindestreck (-) som platshållare. Om ett fält innehåller ett icke-utskrivbart tecken ersätter HTTP Server-API:et det med ett plustecken (+) för att bevara loggfilformatet. Detta inträffar vanligtvis med virusattacker, till exempel när en obehörig användare skickar vagnreturer och radmatningar som, om de inte ersätts med plustecknet (+), skulle bryta loggfilsformatet. Fält avgränsas med blanksteg.

Om ett fält är aktiverat av URL-gruppen eller serversessionen, men inte valts för begäran, visas det i loggfilen med bindestreck (-) som platshållare.

Loggfiler skapas när den första begäran kommer till URL-gruppen eller serversessionen, de skapas inte när loggning konfigureras. I följande exempel visas den första loggfilsposten för en W3C-loggfil med fälten Client IP, Username, Server IP, Server Port, Method, URI Stem, URI Query, Status och User Agent aktiverat:

#Software: Microsoft HTTP Server API 2.0  
#Version: 1.0   // the log file version as it's described by "https://www.w3.org/TR/WD-logfile".
#Date: 2002-05-02 17:42:15  // when the first log file entry was recorded, which is when the entire log file was created.
#Fields: date time c-ip cs-username s-ip s-port cs-method cs-uri-stem cs-uri-query sc-status cs(User-Agent)
2002-05-02 17:42:15 172.22.255.255 - 172.30.255.255 80 GET /images/picture.jpg - 200 Mozilla/4.0+(compatible;MSIE+5.5;+Windows+2000+Server)

Det tidsbegränsade fältet initieras när HTTP Server-API:et tar emot det första bytet innan begäran parsas. Tidsstämpeln stoppas när den senaste sändningen slutförs. Tidsåtgången återspeglar inte tiden i nätverket. Den första begäran till webbplatsen visar en något längre tid än andra liknande begäranden eftersom HTTP Server-API:et öppnar loggfilen med den första begäran.