Condividi tramite


Formato log Analisi archiviazione

Analisi archiviazione registrare i dettagli dei record per le richieste riuscite e non riuscite per l'account di archiviazione. Analisi archiviazione log consentono di esaminare i dettagli delle operazioni di lettura, scrittura ed eliminazione su tabelle, code e BLOB di Azure. Consentono inoltre di analizzare i motivi delle richieste non riuscite, ad esempio timeout, limitazione e errori di autorizzazione.

Ogni voce di log è conforme a un formato di log standard regolato dalla versione di Analisi archiviazione di accesso in uso. La versione 1.0 include tutti i campi descritti in Formato voce di log 1.0. La versione 2.0 aggiunge campi per registrare le informazioni sulle richieste ai servizi BLOB e code autorizzati con un token OAuth 2.0. Questi campi aggiuntivi sono descritti in Formato voce di log 2.0.

Il primo campo in una voce di log indica sempre il numero di versione. I consumer dei dati di registrazione possono accettare una dipendenza da questo campo e i seguenti aspetti di una voce di log:

  • Tutti i campi, popolati o vuoti, verranno separati da un punto e virgola ";"

  • Ogni voce di log è separata da un carattere di nuova riga "\n"

  • L'ultimo campo nella voce non terminerà con un punto e virgola ";"

Verificare sempre la versione prima di elaborare una voce di log.

Nota

Qualsiasi campo che può contenere una virgoletta ("), un punto e virgola (;) o una nuova riga (\n) è codificato e racchiuso tra virgolette HTML.

Impostare la versione di registrazione

Per impostare la versione di registrazione, chiamare l'operazione appropriata per il servizio:

Formato voce di log 1.0

Ogni voce di log versione 1.0 è conforme al formato seguente:

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

Campi voce di log per la versione 1.0

La tabella seguente elenca e definisce i campi in una voce di log versione 1.0.

Nome campo Tipo di campo Definizione Esempio
<version-number> string Versione della registrazione Analisi archiviazione utilizzata per registrare la voce. 1.0
<request-start-time> timestamp Ora UTC di ricezione della richiesta da Analisi archiviazione. 2011-08-09T21:44:36.2481552Z
<operation-type> string Tipo di operazione REST eseguita. Per un elenco delle possibili operazioni, vedere l'argomento Analisi archiviazione operazioni registrate e messaggi di stato. GetBlob
<request-status> string Stato dell'operazione richiesta. Vedere l'argomento Analisi archiviazione Operazioni registrate e messaggi di stato per un elenco dei messaggi di stato possibili. Nella versione 2017-04-17 e successive non ClientOtherError viene usata. Questo campo contiene invece il codice di errore. Success
<http-status-code> string Codice di stato HTTL della richiesta. Se la richiesta viene interrotta, questo valore può essere impostato su Unknown. 200
<end-to-end-latency-in-ms> duration Tempo totale in millisecondi per eseguire l'operazione richiesta, incluso il tempo per leggere la richiesta in arrivo e inviare la risposta al richiedente. 39
<server-latency-in-ms> duration Tempo totale in millisecondi per eseguire l'operazione richiesta. Questo valore non include la latenza di rete (il tempo per leggere la richiesta in arrivo e inviare la risposta al richiedente). 22
<authentication-type> string Indica se la richiesta è stata autorizzata, anonima o usata firma di accesso condiviso. authenticated
<requester-account-name> string Uguale al nome dell'account di archiviazione, se la richiesta è autorizzata. Questo campo è vuoto per le richieste SAS e anonime. myaccount
<owner-account-name> string Nome dell'account del proprietario del servizio. myaccount
<service-type> string Servizio di archiviazione richiesto: Blob, tabelle o di accodamento. blob
<request-url> string URL completo della richiesta, tra virgolette. "https://myaccount.blob.core.windows.net/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034?timeout=30000"
<requested-object-key> string Chiave dell'oggetto richiesto, tra virgolette. Questo campo utilizza sempre il nome dell'account, anche se è stato configurato un nome di dominio personalizzato. "/myaccount/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034"
<request-id-header> guid ID richiesta assegnato dal servizio di archiviazione. Equivale al valore dell'intestazione x-ms-request-id. 668a4744-7eb3-4e8f-b8d3-fbfd3829715b
<operation-count> INT Numero di ogni operazione registrata per una richiesta, utilizzando un indice zero. Alcune richieste richiedono più di un'operazione, ad esempio Copy Blob, anche se la maggior parte ne esegue solo una. 0
<requester-ip-address> string Indirizzo IP del richiedente, incluso il numero di porta. 192.100.0.102:4362
<request-version-header> string Versione del servizio di archiviazione specificata quando è stata effettuata la richiesta. Equivale al valore dell'intestazione x-ms-version. 2009-09-19
<request-header-size> long Dimensioni dell'intestazione della richiesta, in byte. Se una richiesta ha esito negativo, questo valore può essere vuoto. 280
<request-packet-size> long Dimensioni dei pacchetti della richiesta letti dal servizio di archiviazione, in byte. Se una richiesta ha esito negativo, questo valore può essere vuoto. 0
<response-header-size> long Dimensioni dell'intestazione della risposta, in byte. Se una richiesta ha esito negativo, questo valore può essere vuoto. 216
<response-packet-size> long Dimensioni dei pacchetti della risposta scritti dal servizio di archiviazione, in byte. Se una richiesta ha esito negativo, questo valore può essere vuoto. 0
<request-content-length> long Valore dell'intestazione Content-Length per la richiesta inviata al servizio di archiviazione. Se la richiesta ha avuto esito positivo, questo valore è uguale a <request-packet-size>. Se una richiesta ha avuto esito negativo, questo valore potrebbe essere diverso da <request-packet-size> oppure vuoto. 0
<request-md5> string Valore dell'intestazione Content-MD5 o x-ms-content-md5 nella richiesta, tra virgolette. Il valore hash MD5 specificato in questo campo rappresenta il contenuto nella richiesta. Questo campo può essere vuoto. "788815fd0198be0d275ad329cafd1830"
<server-md5> string Valore hash MD5 calcolato dal servizio di archiviazione, tra virgolette. Questo campo può essere vuoto. "3228b3cf1069a5489b298446321f8521"
<etag-identifier> string Identificatore ETag per l'oggetto restituito, tra virgolette. "0x8D101F7E4B662C4"
<last-modified-time> Datetime Ora dell'ultima modifica per l'oggetto restituito, tra virgolette. Questo campo è vuoto per le operazioni che possono restituire più oggetti. Tuesday, 09-Aug-11 21:13:26 GMT
<conditions-used> string Elenco delimitato da punto e virgola sotto forma di ConditionName=value, tra virgolette. ConditionName può essere una delle condizioni seguenti:

- 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> string Valore dell'intestazione User-Agent, tra virgolette. "Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0)"
<referrer-header> string Valore dell'intestazione Referer, tra virgolette. "http://contoso.com/about.html"
<client-request-id> string Valore dell'intestazione x-ms-client-request-id incluso nella richiesta, tra virgolette. "8/9/2011 9:44:36 PM 45ef1c0f-8c71-4153-bc88-38589f63fbfc"

Voci di log di esempio per la versione 1.0

Get Blob

La voce di log di esempio seguente si applica a una richiesta GetBlob anonima:

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"

Put Blob

La voce di log di esempio seguente si applica a una richiesta PutBlob autorizzata :

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"

Copy Blob

Le voci di log di esempio seguenti si applicano a una richiesta CopyBlob autorizzata . L'operazione Copy BLOB registra 3 operazioni: CopyBlob, CopyBlobSource e CopyBlobDestination. Si noti che la proprietà ID della richiesta è identica per tutte e tre le operazioni, tuttavia l'ID operazione viene incrementato per ogni operazione.

Versione del servizio 2012-02-12 e versioni successive

Nella versione 12/02/2012 e successive <requested-object-key> è un URL che sostituisce il formato /accountname/containername/blobname usato nelle versioni precedenti alla 12/02/2012.

L'ID richiesta e l'ID operazione sono riportati in grassetto per ogni voce di log seguente:

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"

Versioni del servizio precedenti al 2012-02-12

L'ID richiesta e l'ID operazione sono riportati in grassetto per ogni voce di log seguente:

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"

Formato voce di log 2.0

Analisi archiviazione formato log versione 2.0 aggiunge campi per supportare le informazioni di registrazione sulle richieste autorizzate con un token OAuth 2.0 fornito da Microsoft Entra ID. Per altre informazioni, vedere Eseguire l'autenticazione con Microsoft Entra ID.

Ogni voce di log 2.0 è conforme al formato seguente:

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

Campi di voce di log per la versione 2.0

La tabella seguente elenca e definisce i campi aggiuntivi scritti in una voce di log versione 2.0. Tutti i campi versione 1.0 sono inclusi nelle voci di log della versione 2.0.

Nome campo Tipo di campo Definizione Esempio
UserObjectId string ID oggetto usato per l'autenticazione. Può essere qualsiasi entità di sicurezza, tra cui un utente, un'identità gestita o un'entità servizio. 03124200-da00-4aa6-aa09-be77923d7870
TenantId string ID tenant usato nell'autorizzazione di connessione. 72f988bf-86f1-41af-91ab-2d7cd011db47
ApplicationId string ID applicazione usato nell'autorizzazione di connessione. 2cd20493-fe97-42ef-9ace-ab95b63d82c4
ID risorsa string ID risorsa usato nell'autorizzazione di connessione. https://storage.azure.com

https://storagesamples.blob.core.windows.net
Issuer string Autorità di certificazione usata per l'autorizzazione di connessione. https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/
UserPrincipalName string Nome dell'entità utente usato nell'autorizzazione di connessione. testuser@azure.onmicrosoft.com
Riservato string Riservato per utilizzi futuri. Il valore è una stringa vuota. N/D
AuthorizationDetail string Informazioni dettagliate sui criteri usate per autorizzare la richiesta. [{"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"}]

Voci di log di esempio per la versione 2.0

List Blobs

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"}]"

Put 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"}]"

Vedi anche

Informazioni sulla registrazione Analisi archiviazione
Operazioni registrate di Analisi archiviazione e messaggi di stato