Análise de Armazenamento formato de log

Análise de Armazenamento detalhes de registros em log para solicitações bem-sucedidas e com falha para sua conta de armazenamento. Análise de Armazenamento logs permitem que você examine os detalhes das operações de leitura, gravação e exclusão em suas tabelas, filas e blobs do Azure. Eles também permitem que você investigue os motivos de solicitações com falha, como tempos limite, limitação e erros de autorização.

Cada entrada de log está em conformidade com um formato de log padrão que é regido pela versão de Análise de Armazenamento log em uso. A versão 1.0 inclui todos os campos descritos no formato de entrada de log 1.0. A versão 2.0 adiciona campos para registrar em log informações sobre solicitações aos serviços de Blob e Fila autorizados com um token OAuth 2.0. Esses campos adicionais são descritos no formato de entrada de log 2.0. A autenticação com Azure AD para os serviços blob e fila está atualmente em versão prévia.

O primeiro campo em uma entrada de log sempre especifica o número da versão. Os consumidores de dados de log podem usar uma dependência nesse campo, bem como os seguintes aspectos de uma entrada de log:

  • Todos os campos, preenchidos ou vazios, serão separados por um ponto-e-vírgula ";"

  • Cada entrada de log é separada por um caractere newline "\n"

  • O último campo na entrada não terminará com um ponto e vírgula ";"

Sempre verifique a versão antes de processar uma entrada de log.

Observação

Qualquer campo que possa conter uma aspa ("), um ponto-e-vírgula (;) ou uma nova linha (\n) é codificado em HTML e entre aspas.

Definir versão de log

Para definir a versão de log, chame a operação apropriada para o serviço:

Formato de entrada de log 1.0

Cada entrada de log da versão 1.0 adere ao 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 log para a versão 1.0

A tabela a seguir lista e define os campos em uma entrada de log da versão 1.0.

Nome do campo Tipo de campo Definição Exemplo
<version-number> string A versão de Análise de Armazenamento registro em log usada para gravar a entrada. 1.0
<request-start-time> timestamp A hora em UTC quando a solicitação foi recebida pela Análise de Armazenamento. 2011-08-09T21:44:36.2481552Z
<operation-type> string O tipo de operação REST executado. Consulte o tópico Análise de Armazenamento Operações Registradas e Mensagens de Status para obter uma lista de possíveis operações. GetBlob
<request-status> string O status da operação solicitada. Consulte o tópico Análise de Armazenamento Operações Registradas e Mensagens de Status para obter uma lista de possíveis mensagens de status. Na versão 2017-04-17 e posterior, ClientOtherError não é usado. Em vez disso, esse campo contém o código de erro. Success
<http-status-code> string O código de status HTTP da solicitação. Se a solicitação for interrompida, esse valor poderá ser definido como Unknown. 200
<end-to-end-latency-in-ms> duration O tempo total em milissegundos para executar a operação solicitada, incluindo o tempo para ler a solicitação de entrada e enviar a resposta ao solicitante. 39
<server-latency-in-ms> duration O tempo total em milissegundos para executar a operação solicitada. Esse valor não inclui a latência de rede (o tempo de leitura da solicitação de entrada e envio da resposta ao solicitante). 22
<authentication-type> string Indica se a solicitação foi autorizada, anônima ou sas (assinatura de acesso compartilhado) usada. authenticated
<requester-account-name> string O mesmo que o nome da conta de armazenamento, se a solicitação estiver autorizada. Esse campo estará vazio para solicitações anônimas e de SAS. myaccount
<owner-account-name> string O nome da conta do proprietário do serviço. myaccount
<service-type> string O serviço solicitado de armazenamento: Blob, Tabela ou Fila. blob
<request-url> string A URL completa da solicitação, entre aspas. "https://myaccount.blob.core.windows.net/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034?timeout=30000"
<requested-object-key> string A chave do objeto solicitado, entre aspas. Esse campo sempre usará o nome da conta, mesmo que um nome de domínio personalizado tenha sido configurado. "/myaccount/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034"
<request-id-header> guid A ID da solicitação atribuída pelo serviço de armazenamento. Isso é equivalente ao valor do cabeçalho x-ms-request-id. 668a4744-7eb3-4e8f-b8d3-fbfd3829715b
<operation-count> INT O número de cada operação registrada em log para uma solicitação, usando um índice de zero. Algumas solicitações exigem mais de uma operação, como o Copiar Blob, embora a maioria execute apenas uma operação. 0
<requester-ip-address> string O endereço IP do solicitante, 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 a solicitação foi feita. Isso é equivalente ao valor do cabeçalho x-ms-version. 2009-09-19
<request-header-size> long O tamanho do cabeçalho da solicitação, em bytes. Se uma solicitação for malsucedida, esse valor poderá estar vazia. 280
<request-packet-size> long O tamanho dos pacotes de solicitação lidos pelo serviço de armazenamento, em bytes. Se uma solicitação for malsucedida, esse valor poderá estar vazia. 0
<response-header-size> long O tamanho do cabeçalho da resposta, em bytes. Se uma solicitação for malsucedida, esse valor poderá estar vazia. 216
<response-packet-size> long O tamanho dos pacotes de resposta gravados pelo serviço de armazenamento, em bytes. Se uma solicitação for malsucedida, esse valor poderá estar vazia. 0
<request-content-length> long O valor do cabeçalho Content-Length para a solicitação enviada ao serviço de armazenamento. Se a solicitação foi bem-sucedida, esse valor será igual a <request-packet-size>. Se uma solicitação for malsucedida, esse valor talvez não seja 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 na solicitação, entre aspas. O valor de hash MD5 especificado nesse campo representa o conteúdo na solicitação. Este campo pode estar vazio. "788815fd0198be0d275ad329cafd1830"
<server-md5> string O valor de hash MD5 calculado pelo serviço de armazenamento, entre aspas. Este campo pode estar vazio. "3228b3cf1069a5489b298446321f8521"
<etag-identifier> string O identificador ETag para o objeto retornado, entre aspas. "0x8D101F7E4B662C4"
<last-modified-time> DATETIME A LMT (Hora da Última Modificação) do objeto retornado, entre aspas. Esse campo fica vazio para operações que podem retornar 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, entre 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 de cabeçalho User-Agent, entre aspas. "Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0)"
<referrer-header> string O valor de cabeçalho Referer, entre aspas. "http://contoso.com/about.html"
<client-request-id> string O valor de cabeçalho x-ms-client-request-id incluído na solicitação, entre aspas. "8/9/2011 9:44:36 PM 45ef1c0f-8c71-4153-bc88-38589f63fbfc"

Entradas de log de exemplo para a versão 1.0

Get Blob

A seguinte entrada de log de exemplo se aplica a uma solicitação GetBlob anônima:

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

A seguinte entrada de log de exemplo se aplica a uma solicitação putblob autorizada:

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 entradas de log de exemplo a seguir se aplicam a uma solicitação do CopyBlob autorizada. A operação Copiar Blob registrará três operações: CopyBlob, CopyBlobSource e CopyBlobDestination. Observe que a propriedade ID da solicitação é idêntica para todas as três operações, mas a ID da operação é incrementada para cada operação.

Versão do Serviço 2012-02-12 e Mais Recente

Na versão 2012-02-12 e mais recente, <requested-object-key> é uma URL que substitui o formato /accountname/containername/blobname usado em versões antes de 2012-02-12.

A ID da solicitação e a ID da operação estão em negrito para cada entrada de log 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

A ID da solicitação e a ID da operação estão em negrito para cada entrada de log 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 log 2.0

Análise de Armazenamento formato de log versão 2.0 adiciona campos para dar suporte a informações de log sobre solicitações autorizadas com um token OAuth 2.0 fornecido pelo Azure Active Directory(Azure AD). A autenticação e a autorização com Azure AD para os serviços blob e fila estão atualmente em versão prévia. Para obter mais informações, confira Autenticar com o Azure Active Directory.

Cada entrada de log da versão 2.0 segue 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 log para a versão 2.0

A tabela a seguir lista e define os campos adicionais gravados em uma entrada de log da versão 2.0. Todos os campos da versão 1.0 estão incluídos nas entradas de log da versão 2.0.

Nome do campo Tipo de campo Definição Exemplo
UserObjectId string A ID do objeto usada para autenticação. Pode ser qualquer entidade de segurança, incluindo um usuário, identidade gerenciada ou entidade de serviço. 03124200-da00-4aa6-aa09-be77923d7870
TenantId string ID do locatário usada na autorização do portador. 72f988bf-86f1-41af-91ab-2d7cd011db47
ApplicationId string ID do aplicativo usada na autorização de portador. 2cd20493-fe97-42ef-9ace-ab95b63d82c4
ID de Recurso string ID do recurso usada na autorização do portador. https://storage.azure.com

https://storagesamples.blob.core.windows.net
Emissor string Emissor usado na autorização do portador. https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/
UserPrincipalName string Nome da entidade de usuário usado na autorização do portador. testuser@azure.onmicrosoft.com
Reservado string Reservado para uso futuro. O valor é uma cadeia de caracteres vazia. N/D
AuthorizationDetail string Informações de política detalhadas usadas para autorizar a solicitação. [{"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 log 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&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"}]"

Confira também

Sobre Análise de Armazenamento registro em log
Mensagens de operações e status registradas de análise de armazenamento