Storage Analytics-logboekindeling
Opslaganalyse registreert logboekregistratiegegevens voor zowel geslaagde als mislukte aanvragen voor uw opslagaccount. met Opslaganalyse logboeken kunt u details van lees-, schrijf- en verwijderbewerkingen bekijken voor uw Azure-tabellen, -wachtrijen en -blobs. Ze stellen u ook in staat om de redenen voor mislukte aanvragen te onderzoeken, zoals time-outs, beperking en autorisatiefouten.
Elke logboekvermelding voldoet aan een standaardlogboekindeling die wordt bepaald door de versie van Opslaganalyse logboekregistratie die wordt gebruikt. Versie 1.0 bevat alle velden die worden beschreven in Logboekvermeldingsindeling 1.0. Met versie 2.0 worden velden toegevoegd voor het vastleggen van informatie over aanvragen voor de Blob- en Queue-services die zijn geautoriseerd met een OAuth 2.0-token. Deze extra velden worden beschreven in Logboekvermeldingsindeling 2.0.
Het eerste veld in een logboekvermelding geeft altijd het versienummer op. Gebruikers van logboekgegevens kunnen afhankelijk zijn van dit veld en de volgende aspecten van een logboekvermelding:
Alle velden, ingevuld of leeg, worden gescheiden door een puntkomma ";"
Elke logboekvermelding wordt gescheiden door een nieuw regelteken '\n'
Het laatste veld in de vermelding eindigt niet op een puntkomma ";"
Controleer altijd de versie voordat u een logboekvermelding verwerkt.
Notitie
Elk veld dat een aanhalingsteken ("), een puntkomma (;) of een nieuwe regel (\n) kan bevatten, is gecodeerd en wordt aangeroepen door HTML.
Logboekregistratieversie instellen
Als u de logboekregistratieversie wilt instellen, roept u de juiste bewerking voor de service aan:
- Blob-service:Blob-service-eigenschappen instellen (ondersteunt zowel versie 1.0 als versie 2.0)
- Wachtrijservice:Eigenschappen van wachtrijservice instellen (ondersteunt zowel versie 1.0 als versie 2.0)
- Tabelservice:Eigenschappen van tabelservice instellen (alleen ondersteuning voor versie 1.0)
Logboekvermeldingsindeling 1.0
Elke logboekvermelding van versie 1.0 heeft de volgende indeling:
<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>
Logboekinvoervelden voor versie 1.0
De volgende tabel bevat en definieert de velden in een logboekvermelding van versie 1.0.
| Veldnaam | Veldtype | Definitie | Voorbeeld |
|---|---|---|---|
<version-number> |
tekenreeks | De versie van Opslaganalyse logboekregistratie die wordt gebruikt om de vermelding vast te leggen. | 1.0 |
<request-start-time> |
tijdstempel | De tijd in UTC waarop de aanvraag is ontvangen door Opslaganalyse. | 2011-08-09T21:44:36.2481552Z |
<operation-type> |
tekenreeks | Het type REST-bewerking dat is uitgevoerd. Zie het onderwerp Opslaganalyse Vastgelegde bewerkingen en statusberichten voor een lijst met mogelijke bewerkingen. | GetBlob |
<request-status> |
tekenreeks | De status van de aangevraagde bewerking. Zie het onderwerp Opslaganalyse Geregistreerde bewerkingen en statusberichten voor een lijst met mogelijke statusberichten. In versie 2017-04-17 en hoger wordt ClientOtherError niet gebruikt. In plaats daarvan bevat dit veld de foutcode. |
Success |
<http-status-code> |
tekenreeks | De HTTP-statuscode voor de aanvraag. Als de aanvraag wordt onderbroken, kan deze waarde worden ingesteld op Unknown. |
200 |
<end-to-end-latency-in-ms> |
duur | De totale tijd in milliseconden om de aangevraagde bewerking uit te voeren, inclusief de tijd die nodig is om de binnenkomende aanvraag te lezen en het antwoord naar de aanvrager te verzenden. | 39 |
<server-latency-in-ms> |
duur | De totale tijd in milliseconden om de aangevraagde bewerking uit te voeren. Deze waarde omvat geen netwerklatentie (de tijd die is om de binnenkomende aanvraag te lezen en het antwoord naar de aanvrager te verzenden). | 22 |
<authentication-type> |
tekenreeks | Hiermee wordt aangegeven of de aanvraag geautoriseerd, anoniem of sas (Shared Access Signature) is gebruikt. | authenticated |
<requester-account-name> |
tekenreeks | Hetzelfde als de naam van het opslagaccount, als de aanvraag is geautoriseerd. Dit veld is leeg voor anonieme en SAS-aanvragen. | myaccount |
<owner-account-name> |
tekenreeks | De accountnaam van de service-eigenaar. | myaccount |
<service-type> |
tekenreeks | De aangevraagde opslagservice: blob, tabel of wachtrij. | blob |
<request-url> |
tekenreeks | De volledige URL van de aanvraag, tussen offertes. | "https://myaccount.blob.core.windows.net/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034?timeout=30000" |
<requested-object-key> |
tekenreeks | De sleutel van het aangevraagde object, tussen aanhalingstekens. In dit veld wordt altijd de accountnaam gebruikt, zelfs als een aangepaste domeinnaam is geconfigureerd. | "/myaccount/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034" |
<request-id-header> |
guid | De aanvraag-id die is toegewezen door de opslagservice. Dit komt overeen met de waarde van de x-ms-request-id header. |
668a4744-7eb3-4e8f-b8d3-fbfd3829715b |
<operation-count> |
int | Het nummer van elke vastgelegde bewerking voor een aanvraag, met behulp van een index van nul. Voor sommige aanvragen is meer dan één bewerking vereist, zoals Blob kopiëren, hoewel de meeste slechts één bewerking uitvoeren. | 0 |
<requester-ip-address> |
tekenreeks | Het IP-adres van de aanvrager, inclusief het poortnummer. | 192.100.0.102:4362 |
<request-version-header> |
tekenreeks | De versie van de opslagservice die is opgegeven toen de aanvraag werd gedaan. Dit komt overeen met de waarde van de x-ms-version header. |
2009-09-19 |
<request-header-size> |
long | De grootte van de aanvraagheader, in bytes. Als een aanvraag mislukt, is deze waarde mogelijk leeg. | 280 |
<request-packet-size> |
long | De grootte van de aanvraagpakketten die door de opslagservice worden gelezen, in bytes. Als een aanvraag mislukt, is deze waarde mogelijk leeg. | 0 |
<response-header-size> |
long | De grootte van de antwoordheader, in bytes. Als een aanvraag mislukt, is deze waarde mogelijk leeg. | 216 |
<response-packet-size> |
long | De grootte van de antwoordpakketten die door de opslagservice zijn geschreven, in bytes. Als een aanvraag mislukt, is deze waarde mogelijk leeg. | 0 |
<request-content-length> |
long | De waarde van de Content-Length header voor de aanvraag die naar de opslagservice is verzonden. Als de aanvraag is geslaagd, is deze waarde gelijk aan <request-packet-size>. Als een aanvraag mislukt, is deze waarde mogelijk niet gelijk aan <request-packet-size>, of is deze leeg. |
0 |
<request-md5> |
tekenreeks | De waarde van de Content-MD5-header of de x-ms-content-md5-header in de aanvraag, tussen aanhalingstekens. De MD5-hashwaarde die in dit veld is opgegeven, vertegenwoordigt de inhoud in de aanvraag. Dit veld kan leeg zijn. | "788815fd0198be0d275ad329cafd1830" |
<server-md5> |
tekenreeks | De waarde van de MD5-hash die is berekend door de opslagservice, tussen aanhalingstekens. Dit veld kan leeg zijn. | "3228b3cf1069a5489b298446321f8521" |
<etag-identifier> |
tekenreeks | De ETag-id voor het geretourneerde object, tussen aanhalingstekens. | "0x8D101F7E4B662C4" |
<last-modified-time> |
datum/tijd | De laatste wijzigingstijd (LMT) voor het geretourneerde object, tussen aanhalingstekens. Dit veld is leeg voor bewerkingen die meerdere objecten kunnen retourneren. | Tuesday, 09-Aug-11 21:13:26 GMT |
<conditions-used> |
tekenreeks | Een door puntkomma's gescheiden lijst in de vorm van ConditionName=value, tussen aanhalingstekens.
ConditionName kan een van de volgende voorwaarden zijn:- 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> |
tekenreeks | De User-Agent headerwaarde, tussen aanhalingstekens. |
"Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0)" |
<referrer-header> |
tekenreeks | De Referer headerwaarde, tussen aanhalingstekens. |
"http://contoso.com/about.html" |
<client-request-id> |
tekenreeks | De x-ms-client-request-id headerwaarde die in de aanvraag is opgenomen, tussen aanhalingstekens. |
"8/9/2011 9:44:36 PM 45ef1c0f-8c71-4153-bc88-38589f63fbfc" |
Voorbeeld van logboekvermeldingen voor versie 1.0
Blob ophalen
De volgende voorbeeldlogboekvermelding is van toepassing op een anonieme GetBlob-aanvraag :
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"
Blob plaatsen
De volgende voorbeeldlogboekvermelding is van toepassing op een geautoriseerde PutBlob-aanvraag :
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"
Blob kopiëren
De volgende voorbeeldlogboekvermeldingen zijn van toepassing op een geautoriseerde CopyBlob-aanvraag . Met de bewerking Blob kopiëren worden 3 bewerkingen in het logboek opgenomen: CopyBlob, CopyBlobSource en CopyBlobDestination. Houd er rekening mee dat de eigenschap aanvraag-id identiek is voor alle drie bewerkingen, maar dat de bewerkings-id voor elke bewerking wordt verhoogd.
Serviceversie 2012-02-12 en hoger
In versie 2012-02-12 en hoger is de <requested-object-key> een URL, die de /accountname/containername/blobname indeling vervangt die werd gebruikt in versies vóór 2012-02-12.
De aanvraag-id en bewerkings-id zijn vetgedrukt voor elke logboekvermelding hieronder:
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"
Serviceversies vóór 12-02-2012
De aanvraag-id en bewerkings-id zijn vetgedrukt voor elke logboekvermelding hieronder:
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"
Logboekvermeldingsindeling 2.0
Opslaganalyse logboekindeling versie 2.0 voegt velden toe ter ondersteuning van logboekgegevens over aanvragen die zijn geautoriseerd met een OAuth 2.0-token dat door Microsoft Entra ID wordt verstrekt. Zie Verifiëren met Microsoft Entra ID voor meer informatie.
Elke logboekvermelding van versie 2.0 heeft de volgende indeling:
<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>
Logboekinvoervelden voor versie 2.0
De volgende tabel bevat en definieert de extra velden die naar een versie 2.0-logboekvermelding zijn geschreven. Alle versie 1.0-velden zijn opgenomen in logboekvermeldingen van versie 2.0.
| Veldnaam | Veldtype | Definitie | Voorbeeld |
|---|---|---|---|
| UserObjectId | tekenreeks | De object-id die wordt gebruikt voor verificatie. Dit kan elke beveiligingsprincipal zijn, inclusief een gebruiker, beheerde identiteit of service-principal. | 03124200-da00-4aa6-aa09-be77923d7870 |
| TenantId | tekenreeks | Tenant-id die wordt gebruikt in bearer-autorisatie. | 72f988bf-86f1-41af-91ab-2d7cd011db47 |
| ApplicationID | tekenreeks | Toepassings-id die wordt gebruikt in bearer-autorisatie. | 2cd20493-fe97-42ef-9ace-ab95b63d82c4 |
| Resource-id | tekenreeks | Resource-id die wordt gebruikt in bearer-autorisatie. | https://storage.azure.comhttps://storagesamples.blob.core.windows.net |
| Verlener | tekenreeks | Verlener die wordt gebruikt in bearer-autorisatie. | https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/ |
| UserPrincipalName | tekenreeks | User Principal Name die wordt gebruikt in bearer-autorisatie. | testuser@azure.onmicrosoft.com |
| Gereserveerd | tekenreeks | Gereserveerd voor toekomstig gebruik. Waarde is een lege tekenreeks. | N.v.t. |
| AuthorizationDetail | tekenreeks | Gedetailleerde beleidsinformatie die wordt gebruikt om de aanvraag te autoriseren. | [{"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"}] |
Voorbeeld van logboekvermeldingen voor versie 2.0
Blobs weergeven
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"}]"
Blok plaatsen
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"}]"
Zie ook
Over Opslaganalyse logboekregistratie
Opslaganalyse geregistreerde bewerkingen en statusberichten