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:
- Servizio BLOB:Impostare le proprietà del servizio BLOB (supporta entrambe le versioni 1.0 e 2.0)
- Servizio di accodamento:Impostare le proprietà del servizio di accodamento (supporta entrambe le versioni 1.0 e 2.0)
- Servizio tabelle:Impostare le proprietà del servizio tabelle (supporta solo la versione 1.0)
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.comhttps://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&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"}]"
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&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