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 följer 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. Autentisering med Azure AD för blob- och kötjänsterna är för närvarande i förhandsversion.

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:

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. En lista över möjliga statusmeddelanden finns i avsnittet Lagringsanalys loggade åtgärder och 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 auktoriserats med en OAuth 2.0-token som tillhandahålls av Azure Active Directory(Azure AD). Autentisering och auktorisering med Azure AD för blob- och kötjänsterna är för närvarande i förhandsversion. Mer information finns i Autentisera med Azure Active Directory.

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.com

https://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&amp;comp=list&amp;prefix=&amp;delimiter=/&amp;marker=&amp;maxresults=30&amp;include=metadata&amp;_=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&amp;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