Loggformat i Lagringsanalys
Lagringsanalys loggning registrerar information om både lyckade och misslyckade begäranden för ditt lagringskonto. Lagringsanalys loggar kan du granska information om läs-, skriv- och borttagningsåtgärder mot dina Azure-tabeller, köer och blobar. De gör det också möjligt att undersöka orsakerna till misslyckade begäranden, till exempel tidsgränser, begränsning och auktoriseringsfel.
Varje loggpost överensstämmer med ett standardloggformat som styrs av versionen av Lagringsanalys loggning som används. Version 1.0 innehåller alla fält som beskrivs i loggpostformat 1.0. Version 2.0 lägger till fält för loggningsinformation om begäranden till blob- och kötjänster som är auktoriserade med en OAuth 2.0-token. Dessa ytterligare fält beskrivs i loggpostformat 2.0.
Det första fältet i en loggpost anger alltid versionsnumret. Användare av loggdata kan vara beroende av det här fältet samt följande aspekter av en loggpost:
Alla fält, ifyllda eller tomma, avgränsas med semikolonet ";"
Varje loggpost avgränsas med ett nytt radtecken "\n"
Det sista fältet i posten slutar inte med semikolonet ";"
Kontrollera alltid versionen innan du bearbetar en loggpost.
Anteckning
Alla fält som kan innehålla ett citattecken (), ett semikolon (;) eller en ny rad (\n) är HTML-kodad och citerad.
Ange loggningsversion
Om du vill ange loggningsversionen anropar du lämplig åtgärd för tjänsten:
- Blob Service:Ange egenskaper för blobtjänsten (stöder både version 1.0 och 2.0)
- Kötjänst:Ange kötjänstegenskaper (stöder både version 1.0 och 2.0)
- Tabelltjänst:Ange tabelltjänstegenskaper (endast stöder version 1.0)
Loggpostformat 1.0
Varje loggpost i version 1.0 följer följande format:
<version-number>;<request-start-time>;<operation-type>;<request-status>;<http-status-code>;<end-to-end-latency-in-ms>;<server-latency-in-ms>;<authentication-type>;<requester-account-name>;<owner-account-name>;<service-type>;<request-url>;<requested-object-key>;<request-id-header>;<operation-count>;<requester-ip-address>;<request-version-header>;<request-header-size>;<request-packet-size>;<response-header-size>;<response-packet-size>;<request-content-length>;<request-md5>;<server-md5>;<etag-identifier>;<last-modified-time>;<conditions-used>;<user-agent-header>;<referrer-header>;<client-request-id>
Logginmatningsfält för version 1.0
I följande tabell visas och definieras fälten i en loggpost i version 1.0.
| Fältnamn | Fälttyp | Definition | Exempel |
|---|---|---|---|
<version-number> |
sträng | Den version av Lagringsanalys loggning som används för att registrera posten. | 1.0 |
<request-start-time> |
timestamp | Tiden i UTC när begäran togs emot av Lagringsanalys. | 2011-08-09T21:44:36.2481552Z |
<operation-type> |
sträng | Typ av REST-åtgärd som utförts. En lista över möjliga åtgärder finns i avsnittet Lagringsanalys loggade åtgärder och statusmeddelanden. | GetBlob |
<request-status> |
sträng | Status för den begärda åtgärden. Se avsnittet Lagringsanalys loggade åtgärder och statusmeddelanden för en lista över möjliga statusmeddelanden. I version 2017-04-17 och senare ClientOtherError används inte. I stället innehåller det här fältet felkoden. |
Success |
<http-status-code> |
sträng | HTTP-statuskoden för begäran. Om begäran avbryts kan det här värdet anges till Unknown. |
200 |
<end-to-end-latency-in-ms> |
varaktighet | Den totala tiden i millisekunder för att utföra den begärda åtgärden, inklusive tiden för att läsa den inkommande begäran och skicka svaret till beställaren. | 39 |
<server-latency-in-ms> |
varaktighet | Den totala tiden i millisekunder för att utföra den begärda åtgärden. Det här värdet omfattar inte nätverksfördröjning (den tid det tar att läsa den inkommande begäran och skicka svaret till beställaren). | 22 |
<authentication-type> |
sträng | Anger om begäran har auktoriserats, anonymt eller använt signatur för delad åtkomst (SAS). | authenticated |
<requester-account-name> |
sträng | Samma som lagringskontots namn, om begäran har behörighet. Det här fältet är tomt för anonyma begäranden och SAS-begäranden. | myaccount |
<owner-account-name> |
sträng | Tjänstägarens kontonamn. | myaccount |
<service-type> |
sträng | Den begärda lagringstjänsten: blob, tabell eller kö. | blob |
<request-url> |
sträng | Den fullständiga URL:en för begäran, med citattecken. | "https://myaccount.blob.core.windows.net/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034?timeout=30000" |
<requested-object-key> |
sträng | Nyckeln för det begärda objektet, inom citattecken. Det här fältet använder alltid kontonamnet, även om ett anpassat domännamn har konfigurerats. | "/myaccount/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034" |
<request-id-header> |
guid | Det begärande-ID som tilldelats av lagringstjänsten. Detta motsvarar värdet för x-ms-request-id rubriken. |
668a4744-7eb3-4e8f-b8d3-fbfd3829715b |
<operation-count> |
int | Antalet loggade åtgärder för en begäran med indexet noll. Vissa begäranden kräver mer än en åtgärd, till exempel Kopiera blob, men de flesta utför bara en åtgärd. | 0 |
<requester-ip-address> |
sträng | IP-adressen för beställaren, inklusive portnumret. | 192.100.0.102:4362 |
<request-version-header> |
sträng | Lagringstjänstversionen som angavs när begäran gjordes. Detta motsvarar värdet för x-ms-version rubriken. |
2009-09-19 |
<request-header-size> |
long | Storleken på begärandehuvudet i byte. Om en begäran misslyckas kan det här värdet vara tomt. | 280 |
<request-packet-size> |
long | Storleken på de begärandepaket som lästs av lagringstjänsten i byte. Om en begäran misslyckas kan det här värdet vara tomt. | 0 |
<response-header-size> |
long | Storleken på svarshuvudet i byte. Om en begäran misslyckas kan det här värdet vara tomt. | 216 |
<response-packet-size> |
long | Storleken på svarspaketen som skrivits av lagringstjänsten i byte. Om en begäran misslyckas kan det här värdet vara tomt. | 0 |
<request-content-length> |
long | Värdet för Content-Length rubriken för begäran som skickas till lagringstjänsten. Om begäran lyckades är det här värdet lika <request-packet-size>med . Om en begäran misslyckas kanske det här värdet inte är lika med <request-packet-size>, eller så kan det vara tomt. |
0 |
<request-md5> |
sträng | Värdet för content-MD5-huvudet eller x-ms-content-md5-huvudet i begäran, med citattecken. Md5-hashvärdet som anges i det här fältet representerar innehållet i begäran. Det här fältet kan vara tomt. | "788815fd0198be0d275ad329cafd1830" |
<server-md5> |
sträng | Värdet för MD5-hashen som beräknas av lagringstjänsten, med citattecken. Det här fältet kan vara tomt. | "3228b3cf1069a5489b298446321f8521" |
<etag-identifier> |
sträng | ETag-identifieraren för det returnerade objektet, inom citattecken. | "0x8D101F7E4B662C4" |
<last-modified-time> |
datetime | LMT (Last Modified Time) för det returnerade objektet, med citattecken. Det här fältet är tomt för åtgärder som kan returnera flera objekt. | Tuesday, 09-Aug-11 21:13:26 GMT |
<conditions-used> |
sträng | En semikolonavgränsad lista i form av ConditionName=value, i citattecken. ConditionName kan vara något av följande villkor:- If-Modified-Since- If-Unmodified-Since- If-Match- If-None-Match |
"If-Modified-Since=Friday, 05-Aug-11 19:11:54 GMT" |
<user-agent-header> |
sträng | Rubrikvärdet User-Agent , inom citattecken. |
"Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0)" |
<referrer-header> |
sträng | Rubrikvärdet Referer , inom citattecken. |
"http://contoso.com/about.html" |
<client-request-id> |
sträng | Det x-ms-client-request-id rubrikvärde som ingår i begäran, i citattecken. |
"8/9/2011 9:44:36 PM 45ef1c0f-8c71-4153-bc88-38589f63fbfc" |
Exempelloggposter för version 1.0
Hämta blob
Följande exempelloggpost gäller för en anonym GetBlob-begäran :
1.0;2014-06-19T22:59:23.1967767Z;GetBlob;AnonymousSuccess;200;17;16;anonymous;;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container1/00001.txt";"/storagesample/sample-container1/00001.txt";61d2e3f6-bcb7-4cd1-a81e-4f8f497f0da2;0;192.100.0.102:4362;2014-02-14;283;0;354;23;0;;;""0x8D15A2913C934DE"";Thursday, 19-Jun-14 22:58:10 GMT;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"44dfd78e-7288-4898-8f70-c3478983d3b6"
Placera blob
Följande exempelloggpost gäller för en auktoriserad PutBlob-begäran :
1.0;2014-06-19T01:33:54.0926521Z;PutBlob;Success;201;197;54;authenticated;storagesample;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container1/00001.txt";"/storagesample/sample-container1/00001.txt";a200be85-1c98-4dd9-918e-f13d8c0538e0;0;192.100.0.102:4362;2014-02-14;460;23;225;0;23;"DrPO6z1f00SCsomhaf+J/A==";"DrPO6z1f00SCsomhaf+J/A==";""0x8D15975AA456EA4"";Thursday, 19-Jun-14 01:33:53 GMT;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"1fe6814a-e4cb-4195-a3cf-837dc7120f68"
Kopiera blob
Följande exempelloggposter gäller för en auktoriserad CopyBlob-begäran . Åtgärden Kopiera blob loggar 3 åtgärder: CopyBlob, CopyBlobSource och CopyBlobDestination. Observera att egenskapen för begärande-ID är identisk för alla tre åtgärderna, men åtgärds-ID:t ökas för varje åtgärd.
Tjänstversion 2012-02-12 och senare
I version 2012-02-12 och senare <requested-object-key> är en URL som ersätter det /accountname/containername/blobname format som användes i versioner före 2012-02-12.
Begärans-ID:t och åtgärds-ID:t är i fetstil för varje loggpost nedan:
1.0;2014-06-19T23:31:36.5780954Z;CopyBlob;Success;202;13;13;authenticated;storagesample;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container/Copy-sample-blob.txt";"/storagesample/sample-container/Copy-sample-blob.txt";505fc366-688f-4622-bbb1-20e8fc26cffd;0;192.100.0.102:4362;2014-02-14;538;0;261;0;0;;;""0x8D15A2DBF11553E"";Thursday, 19-Jun-14 23:31:36 GMT;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"dc00da87-5483-4524-b0dc-d1df025a6a9a"
1.0;2014-06-19T23:31:36.5780954Z;CopyBlobSource;Success;202;13;13;authenticated;storagesample;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container/Copy-sample-blob.txt";"https://storagesample.blob.core.windows.net/sample-container/sample-blob.txt";505fc366-688f-4622-bbb1-20e8fc26cffd;1;192.100.0.102:4362;2014-02-14;538;0;261;0;0;;;;;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"dc00da87-5483-4524-b0dc-d1df025a6a9a"
1.0;2014-06-19T23:31:36.5780954Z;CopyBlobDestination;Success;202;13;13;authenticated;storagesample;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container/Copy-sample-blob.txt";"/storagesample/sample-container/Copy-sample-blob.txt";505fc366-688f-4622-bbb1-20e8fc26cffd;2;192.100.0.102:4362;2014-02-14;538;0;261;0;0;;;;;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"dc00da87-5483-4524-b0dc-d1df025a6a9a"
Tjänstversioner före 2012-02-12
Begärans-ID:t och åtgärds-ID:t är i fetstil för varje loggpost nedan:
1.0;2011-08-09T18:02:40.6526789Z;CopyBlob;Success;201;28;28;authenticated;account8ce1b67a9e80b35;myaccount;blob;"https://myaccount.blob.core.windows.net/thumbnails/lake.jpg?timeout=30000";"/myaccount/thumbnails/lakebck.jpg";85ba10a5-b7e2-495e-8033-588e08628c5d;0;268.20.203.21:4362;2009-09-19;505;0;188;0;0;;;"0x8CE1B67AD473BC5";Friday, 09-Aug-11 18:02:40 GMT;;;;"8/9/2011 6:02:40 PM 683803d3-538f-4ba8-bc7c-24c83aca5b1a"
1.0;2011-08-09T18:02:40.6526789Z;CopyBlobSource;Success;201;28;28;authenticated;myaccount;myaccount;blob;"https://myaccount.blob.core.windows.net/thumbnails/lake.jpg?timeout=30000";"/myaccount/thumbnails/lake.jpg";85ba10a5-b7e2-495e-8033-588e08628c5d;1;268.20.203.21:4362;2009-09-19;505;0;188;0;0;;;;;;;;"8/9/2011 6:02:40 PM 683803d3-538f-4ba8-bc7c-24c83aca5b1a"
1.0;2011-08-09T18:02:40.6526789Z;CopyBlobDestination;Success;201;28;28;authenticated;myaccount;myaccount;blob;"https://myaccount.blob.core.windows.net/thumbnails/lake.jpg?timeout=30000";"/myaccount/thumbnails/lakebck.jpg";85ba10a5-b7e2-495e-8033-588e08628c5d;2;268.20.203.21:4362;2009-09-19;505;0;188;0;0;;;;;;;;"8/9/2011 6:02:40 PM 683803d3-538f-4ba8-bc7c-24c83aca5b1a"
Loggpostformat 2.0
Lagringsanalys loggformat version 2.0 lägger till fält som stöd för loggningsinformation om begäranden som har auktoriserats med en OAuth 2.0-token som tillhandahålls av Microsoft Entra ID. Mer information finns i Autentisera med Microsoft Entra ID.
Varje loggpost i version 2.0 följer följande format:
<version-number>;<request-start-time>;<operation-type>;<request-status>;<http-status-code>;<end-to-end-latency-in-ms>;<server-latency-in-ms>;<authentication-type>;<requester-account-name>;<owner-account-name>;<service-type>;<request-url>;<requested-object-key>;<request-id-header>;<operation-count>;<requester-ip-address>;<request-version-header>;<request-header-size>;<request-packet-size>;<response-header-size>;<response-packet-size>;<request-content-length>;<request-md5>;<server-md5>;<etag-identifier>;<last-modified-time>;<conditions-used>;<user-agent-header>;<referrer-header>;<client-request-id>;<user-object-id>;<tenant-id>;<application-id>;<audience>;<issuer>;<user-principal-name>;<reserved-field>;<authorization-detail>
Logginmatningsfält för version 2.0
I följande tabell visas och definieras de ytterligare fält som skrivits till en loggpost i version 2.0. Alla fält i version 1.0 ingår i loggposterna i version 2.0.
| Fältnamn | Fälttyp | Definition | Exempel |
|---|---|---|---|
| UserObjectId | sträng | Objekt-ID:t som används för autentisering. Kan vara ett säkerhetsobjekt, inklusive en användare, hanterad identitet eller tjänstens huvudnamn. | 03124200-da00-4aa6-aa09-be77923d7870 |
| TenantId | sträng | Klientorganisations-ID som används i ägarauktorisering. | 72f988bf-86f1-41af-91ab-2d7cd011db47 |
| ApplicationId | sträng | Program-ID som används i ägarauktorisering. | 2cd20493-fe97-42ef-9ace-ab95b63d82c4 |
| Resurs-ID | sträng | Resurs-ID som används i ägarauktorisering. | https://storage.azure.comhttps://storagesamples.blob.core.windows.net |
| Utfärdare | sträng | Utfärdare som används i ägarauktorisering. | https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/ |
| UserPrincipalName | sträng | Användarens huvudnamn som används i ägarauktorisering. | testuser@azure.onmicrosoft.com |
| Reserverat | sträng | Reserverad för framtida användning. Värdet är en tom sträng. | Ej tillämpligt |
| AuthorizationDetail | sträng | Detaljerad principinformation som används för att auktorisera begäran. | [{"action":"Microsoft.Storage/storageAccounts/blobServices/containers/read", "roleAssignmentId":"/subscriptions/5451a164-d870-4626-a64c-c38d62da20da/providers/Microsoft.Authorization/roleAssignments/6632a082-9b6a-486c-b296-f9d785d32800", "roleDefinitionId":"/subscriptions/5451a164-d870-4626-a64c-c38d62da20da/providers/Microsoft.Authorization/roleDefinitions/ba92f5b4-2d11-453d-a403-e96b0029c9fe", "principalId":"03124200-da00-4aa6-aa09-be77923d7870", "principalType":"ServicePrincipal"}] |
Exempelloggposter för version 2.0
Lista blobar
2.0;2019-02-25T20:06:55.9794046Z;ListBlobs;OAuthSuccess;200;250;46;bearer;storagesamples;storagesamples;blob;"https://storagesamples.blob.core.windows.net/sample-container?restype=container&comp=list&prefix=&delimiter=/&marker=&maxresults=30&include=metadata&_=1551125215793";"/storagesamples/sample-container";470b9e55-201e-0137-5c45-cdd293000000;0;200.59.21.176:52659;2018-03-28;2682;0;295;5184;0;;;;;;"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.140 Safari/537.36 Edge/18.17763";"blob:https://ms.portal.azure.com/cf576432-66ab-4ae6-9cb3-4852b1137a21";;"e5981635-dcf0-4279-ab7b-ca1cbdf4a5c7";"72f988bf-86f1-41af-91ab-2d7cd011db47";"691458b9-1327-4635-9f55-ed83a7f1b41c";"https://storage.azure.com/";"https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/";;;"[{"action":"Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read", "roleAssignmentId":"ca8af92a-6708-4cdf-a678-bb55d0ff7b80", "roleDefinitionId":"ba92f5b4-2d11-453d-a403-e96b0029c9fe", "principalId":"e5981635-dcf0-4279-ab7b-ca1cbdf4a5c7", "principalType":"User"}]"
Placera block
2.0;2019-02-25T20:06:55.9089848Z;PutBlock;OAuthSuccess;201;95;95;bearer;storagesamples;storagesamples;blob;"https://storagesamples.blob.core.windows.net/sample-container/blob1.txt?comp=block&blockid=YmxvY2stMDAwMDAwMDA=";"/storagesamples/sample-container/blob1.txt";5569fa10-e01e-00c0-2745-cdb22d000000;0;200.59.21.176:52665;2017-11-09;2581;9;365;0;9;;"tdzGO9AaJte/e2HJZLtXig==";;;;"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.140 Safari/537.36 Edge/18.17763";"https://ms.portal.azure.com/";"c808142e-0393-4942-9001-af4833061026";"e5981635-dcf0-4279-ab7b-ca1cbdf4a5c7";"72f988bf-86f1-41af-91ab-2d7cd011db47";"691458b9-1327-4635-9f55-ed83a7f1b41c";"https://storage.azure.com/";"https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/";;;"[{"action":"Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write", "roleAssignmentId":"ca8af92a-6708-4cdf-a678-bb55d0ff7b80", "roleDefinitionId":"ba92f5b4-2d11-453d-a403-e96b0029c9fe", "principalId":"e5981635-dcf0-4279-ab7b-ca1cbdf4a5c7", "principalType":"User"}]"
Se även
Om Lagringsanalys loggning
Lagringsanalys loggade åtgärder och statusmeddelanden