Formato do registo da Análise de Armazenamento
Análise de Armazenamento os detalhes dos registos para pedidos bem-sucedidos e falhados para a sua conta de armazenamento. Análise de Armazenamento registos permitem-lhe rever os detalhes das operações de leitura, escrita e eliminação nas tabelas, filas e blobs do Azure. Também lhe permitem investigar os motivos dos pedidos falhados, como tempos limite, limitação e erros de autorização.
Cada entrada de registo está em conformidade com um formato de registo padrão que é regido pela versão do Análise de Armazenamento início de sessão em utilização. A versão 1.0 inclui todos os campos descritos no Formato de entrada de registo 1.0. A versão 2.0 adiciona campos para informações de registo sobre pedidos aos serviços Blob e Queue autorizados com um token OAuth 2.0. Estes campos adicionais estão descritos no formato de entrada de registo 2.0.
O primeiro campo numa entrada de registo especifica sempre o número da versão. Os consumidores de dados de registo podem assumir uma dependência neste campo, bem como os seguintes aspetos de uma entrada de registo:
Todos os campos, preenchidos ou vazios, serão separados por um ponto e vírgula ";"
Cada entrada de registo é separada por um caráter newline "\n"
O último campo na entrada não terminará com um ponto e vírgula ";"
Verifique sempre a versão antes de processar uma entrada de registo.
Nota
Qualquer campo que possa conter uma aspa ("), um ponto e vírgula (;)) ou uma nova linha (\n) é codificado e citado por HTML.
Definir versão de registo
Para definir a versão de registo, chame a operação adequada para o serviço:
- Serviço blob:Definir Propriedades do Serviço blob (suporta ambas as versões 1.0 e 2.0)
- Serviço de fila:Definir Propriedades do Serviço de Fila (suporta ambas as versões 1.0 e 2.0)
- Serviço de tabela:Definir Propriedades do Serviço de Tabela (suporta apenas a versão 1.0)
Formato de entrada de registo 1.0
Cada entrada de registo da versão 1.0 cumpre o seguinte formato:
<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>
Campos de entrada de registo para a versão 1.0
A tabela seguinte lista e define os campos numa entrada de registo da versão 1.0.
| Nome do Campo | Tipo de Campo | Definição | Exemplo |
|---|---|---|---|
<version-number> |
string | A versão do registo Análise de Armazenamento utilizado para registar a entrada. | 1.0 |
<request-start-time> |
carimbo de data/hora | A hora em UTC em que o pedido foi recebido por Análise de Armazenamento. | 2011-08-09T21:44:36.2481552Z |
<operation-type> |
string | O tipo de operação REST efetuada. Veja o tópico Análise de Armazenamento Operações Registadas e Mensagens de Estado para obter uma lista de possíveis operações. | GetBlob |
<request-status> |
string | O estado da operação pedida. Veja o tópico Análise de Armazenamento Operações Registadas e Mensagens de Estado para obter uma lista de possíveis mensagens de estado. Na versão 2017-04-17 e posterior, ClientOtherError não é utilizado. Em vez disso, este campo contém o código de erro. |
Success |
<http-status-code> |
string | O código de estado HTTP do pedido. Se o pedido for interrompido, este valor poderá ser definido como Unknown. |
200 |
<end-to-end-latency-in-ms> |
duration | O tempo total em milissegundos para efetuar a operação pedida, incluindo o tempo para ler o pedido recebido e enviar a resposta ao requerente. | 39 |
<server-latency-in-ms> |
duration | O tempo total em milissegundos para efetuar a operação pedida. Este valor não inclui latência de rede (o tempo para ler o pedido recebido e enviar a resposta ao requerente). | 22 |
<authentication-type> |
string | Indica se o pedido foi autorizado, anónimo ou utilizado como Assinatura de Acesso Partilhado (SAS). | authenticated |
<requester-account-name> |
string | O mesmo que o nome da conta de armazenamento, se o pedido for autorizado. Este campo estará vazio para pedidos anónimos e SAS. | myaccount |
<owner-account-name> |
string | O nome da conta do proprietário do serviço. | myaccount |
<service-type> |
string | O serviço de armazenamento pedido: blob, tabela ou fila. | blob |
<request-url> |
string | O URL completo do pedido, em aspas. | "https://myaccount.blob.core.windows.net/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034?timeout=30000" |
<requested-object-key> |
string | A chave do objeto pedido, em aspas. Este campo utilizará sempre o nome da conta, mesmo que tenha sido configurado um nome de domínio personalizado. | "/myaccount/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034" |
<request-id-header> |
guid | O ID do pedido atribuído pelo serviço de armazenamento. Isto é equivalente ao valor do x-ms-request-id cabeçalho. |
668a4744-7eb3-4e8f-b8d3-fbfd3829715b |
<operation-count> |
int | O número de cada operação registada para um pedido, utilizando um índice de zero. Alguns pedidos requerem mais do que uma operação, como Copiar Blob, embora a maioria execute apenas uma operação. | 0 |
<requester-ip-address> |
string | O endereço IP do requerente, incluindo o número da porta. | 192.100.0.102:4362 |
<request-version-header> |
string | A versão do serviço de armazenamento especificada quando o pedido foi feito. Isto é equivalente ao valor do x-ms-version cabeçalho. |
2009-09-19 |
<request-header-size> |
long | O tamanho do cabeçalho do pedido, em bytes. Se um pedido não for bem-sucedido, este valor poderá estar vazio. | 280 |
<request-packet-size> |
long | O tamanho dos pacotes de pedidos lidos pelo serviço de armazenamento, em bytes. Se um pedido não for bem-sucedido, este valor poderá estar vazio. | 0 |
<response-header-size> |
long | O tamanho do cabeçalho de resposta, em bytes. Se um pedido não for bem-sucedido, este valor poderá estar vazio. | 216 |
<response-packet-size> |
long | O tamanho dos pacotes de resposta escritos pelo serviço de armazenamento, em bytes. Se um pedido não for bem-sucedido, este valor poderá estar vazio. | 0 |
<request-content-length> |
long | O valor do Content-Length cabeçalho do pedido enviado para o serviço de armazenamento. Se o pedido tiver sido bem-sucedido, este valor é igual a <request-packet-size>. Se um pedido não for bem-sucedido, este valor pode não ser igual a <request-packet-size>, ou pode estar vazio. |
0 |
<request-md5> |
string | O valor do cabeçalho Content-MD5 ou do cabeçalho x-ms-content-md5 no pedido, em aspas. O valor do hash MD5 especificado neste campo representa o conteúdo do pedido. Este campo pode estar vazio. | "788815fd0198be0d275ad329cafd1830" |
<server-md5> |
string | O valor do hash MD5 calculado pelo serviço de armazenamento, em aspas. Este campo pode estar vazio. | "3228b3cf1069a5489b298446321f8521" |
<etag-identifier> |
string | O identificador ETag para o objeto devolvido, em aspas. | "0x8D101F7E4B662C4" |
<last-modified-time> |
datetime | A Hora da Última Modificação (LMT) para o objeto devolvido, em aspas. Este campo está vazio para operações que podem devolver vários objetos. | Tuesday, 09-Aug-11 21:13:26 GMT |
<conditions-used> |
string | Uma lista separada por ponto e vírgula na forma de ConditionName=value, em aspas.
ConditionName pode ser uma das seguintes condições:- 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 | O valor do User-Agent cabeçalho, em aspas. |
"Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0)" |
<referrer-header> |
string | O valor do Referer cabeçalho, em aspas. |
"http://contoso.com/about.html" |
<client-request-id> |
string | O x-ms-client-request-id valor do cabeçalho incluído no pedido, em aspas. |
"8/9/2011 9:44:36 PM 45ef1c0f-8c71-4153-bc88-38589f63fbfc" |
Entradas de registo de exemplo para a versão 1.0
Obter Blob
A seguinte entrada de registo de exemplo aplica-se a um pedido GetBlob anónimo:
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"
Colocar o Blob
A seguinte entrada de registo de exemplo aplica-se a um pedido PutBlob autorizado:
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"
Copiar Blob
As seguintes entradas de registo de exemplo aplicam-se a um pedido CopyBlob autorizado. A operação Copiar Blob irá registar 3 operações: CopyBlob, CopyBlobSource e CopyBlobDestination. Tenha em atenção que a propriedade ID do pedido é idêntica para as três operações, mas o ID da operação é incrementado para cada operação.
Versão do Serviço 2012-02-12 e Mais Recente
Na versão 2012-02-12 e mais recente, o <requested-object-key> é um URL, que substitui o /accountname/containername/blobname formato utilizado em versões antes de 2012-02-12.
O ID do pedido e o ID da operação estão a negrito para cada entrada de registo abaixo:
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"
Versões de Serviço Anteriores a 2012-02-12
O ID do pedido e o ID da operação estão a negrito para cada entrada de registo abaixo:
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 de entrada de registo 2.0
Análise de Armazenamento formato de registo versão 2.0 adiciona campos para suportar informações de registo sobre pedidos autorizados com um token OAuth 2.0 fornecido pelo Microsoft Entra ID. Para obter mais informações, veja Authenticate with Microsoft Entra ID (Autenticar com Microsoft Entra ID).
Cada entrada de registo da versão 2.0 cumpre o seguinte formato:
<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>
Campos de entrada de registo para a versão 2.0
A tabela seguinte lista e define os campos adicionais escritos numa entrada de registo da versão 2.0. Todos os campos da versão 1.0 estão incluídos nas entradas de registo da versão 2.0.
| Nome do Campo | Tipo de Campo | Definição | Exemplo |
|---|---|---|---|
| UserObjectId | string | O ID do objeto utilizado para autenticação. Pode ser qualquer principal de segurança, incluindo um utilizador, uma identidade gerida ou um principal de serviço. | 03124200-da00-4aa6-aa09-be77923d7870 |
| TenantId | string | ID do inquilino utilizado na autorização do portador. | 72f988bf-86f1-41af-91ab-2d7cd011db47 |
| ApplicationID | string | ID da aplicação utilizado na autorização do portador. | 2cd20493-fe97-42ef-9ace-ab95b63d82c4 |
| ID do Recurso | string | ID de recurso utilizado na autorização do portador. | https://storage.azure.comhttps://storagesamples.blob.core.windows.net |
| Emissor | string | Emissor utilizado na autorização do portador. | https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/ |
| UserPrincipalName | string | Nome principal de utilizador utilizado na autorização do portador. | testuser@azure.onmicrosoft.com |
| Reservado | string | Reservado para utilização futura. O valor é uma cadeia vazia. | N/D |
| AuthorizationDetail | string | Informações detalhadas da política utilizadas para autorizar o pedido. | [{"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"}] |
Entradas de registo de exemplo para a versão 2.0
Listar 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"}]"
Colocar Bloco
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"}]"
Ver também
Acerca do registo de Análise de Armazenamento
Análise de Armazenamento Mensagens de Estado e Operações Registadas