Storage Analytics formato de registro

Storage Analytics los detalles de registro de las solicitudes correctas y erróneas de la cuenta de almacenamiento. Storage Analytics registros le permiten revisar los detalles de las operaciones de lectura, escritura y eliminación en las tablas, colas y blobs de Azure. También le permiten investigar los motivos de las solicitudes con errores, como tiempos de espera, limitación y errores de autorización.

Cada entrada de registro se ajusta a un formato de registro estándar que se rige por la versión de Storage Analytics registro en uso. La versión 1.0 incluye todos los campos descritos en Formato de entrada de registro 1.0. La versión 2.0 agrega campos para registrar información sobre las solicitudes a los servicios Blob y Queue que están autorizados con un token de OAuth 2.0. Estos campos adicionales se describen en Formato de entrada de registro 2.0. La autenticación con Azure AD para los servicios Blob y Queue está actualmente en versión preliminar.

El primer campo de una entrada de registro siempre especifica el número de versión. Los consumidores de datos de registro pueden establecer una dependencia sobre este campo, así como sobre los aspectos siguientes de una entrada de registro:

  • Todos los campos, rellenados o vacíos, se separarán mediante un punto y coma ";".

  • Cada entrada de registro está separada por un carácter de nueva línea "\n"

  • El último campo de la entrada no terminará con un punto y coma ";".

Compruebe siempre la versión antes de procesar una entrada de registro.

Nota

Cualquier campo que pueda contener una comilla ("), un punto y coma (;) o una nueva línea (\n) es HTML codificado y entre comillas.

Establecimiento de la versión de registro

Para establecer la versión de registro, llame a la operación adecuada para el servicio:

Formato de entrada de registro 1.0

Cada entrada de registro de la versión 1.0 se ajusta al formato siguiente:

<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 registro para la versión 1.0

En la tabla siguiente se enumeran y definen los campos de una entrada de registro de la versión 1.0.

Nombre del campo Tipo de campo Definición Ejemplo
<version-number> string Versión de Storage Analytics registro que se usa para registrar la entrada. 1.0
<request-start-time> timestamp La hora en formato UTC en la que el análisis de almacenamiento recibió la solicitud. 2011-08-09T21:44:36.2481552Z
<operation-type> string El tipo de operación REST realizada. Consulte el tema Storage Analytics Operaciones registradas y mensajes de estado para obtener una lista de las posibles operaciones. GetBlob
<request-status> string Estado de la operación solicitada. Consulte el tema Storage Analytics Operaciones registradas y mensajes de estado para obtener una lista de posibles mensajes de estado. En la versión 2017-04-17 y posteriores, ClientOtherError no se usa. En su lugar, este campo contiene el código de error. Success
<http-status-code> string Código de estado HTTP de la solicitud. Si se interrumpe la solicitud, este valor se puede establecer en Unknown. 200
<end-to-end-latency-in-ms> duration El tiempo total en milisegundos para realizar la operación solicitada, incluido el tiempo para leer la solicitud entrante y enviar la respuesta al solicitante. 39
<server-latency-in-ms> duration El tiempo total en milisegundos para realizar la operación solicitada. Este valor no incluye la latencia de red (el tiempo para leer la solicitud entrante y enviar la respuesta al solicitante). 22
<authentication-type> string Indica si la solicitud se autorizó, anónima o usó la firma de acceso compartido (SAS). authenticated
<requester-account-name> string Igual que el nombre de la cuenta de almacenamiento, si la solicitud está autorizada. Este campo estará vacío para las solicitudes SAS y las anónimas. myaccount
<owner-account-name> string El nombre de cuenta del propietario del servicio. myaccount
<service-type> string El servicio de almacenamiento solicitado: blob, tabla o cola. blob
<request-url> string La dirección URL completa de la solicitud, entre comillas. "https://myaccount.blob.core.windows.net/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034?timeout=30000"
<requested-object-key> string La clave del objeto solicitado, entre comillas. Este campo utilizará siempre el nombre de cuenta, incluso si se ha configurado un nombre de dominio personalizado. "/myaccount/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034"
<request-id-header> guid El identificador de solicitud asignado por el servicio de almacenamiento. Esto equivale al valor del encabezado x-ms-request-id. 668a4744-7eb3-4e8f-b8d3-fbfd3829715b
<operation-count> int El número de cada operación registrada para una solicitud, utilizando un índice de cero. Algunas solicitudes requieren más de una operación, como Copy Blob, aunque la mayoría realizan una sola. 0
<requester-ip-address> string Dirección IP del solicitante, incluido el número de puerto. 192.100.0.102:4362
<request-version-header> string La versión del servicio de almacenamiento especificada al realizar la solicitud. Esto equivale al valor del encabezado x-ms-version. 2009-09-19
<request-header-size> long El tamaño del encabezado de solicitud, en bytes. Si una solicitud no se realiza correctamente, este valor puede estar vacío. 280
<request-packet-size> long El tamaño de los paquetes de solicitud leídos por el servicio de almacenamiento, en bytes. Si una solicitud no se realiza correctamente, este valor puede estar vacío. 0
<response-header-size> long El tamaño del encabezado de respuesta, en bytes. Si una solicitud no se realiza correctamente, este valor puede estar vacío. 216
<response-packet-size> long Tamaño de los paquetes de respuesta escritos por el servicio de almacenamiento, en bytes. Si una solicitud no se realiza correctamente, este valor puede estar vacío. 0
<request-content-length> long El valor del encabezado Content-Length para la solicitud enviada al servicio de almacenamiento. Si la solicitud se realizó correctamente, este valor es igual a <request-packet-size>. Si la solicitud se realizó incorrectamente, este valor puede no ser igual a <request-packet-size>, o puede estar vacío. 0
<request-md5> string El valor del encabezado Content-MD5 o x-ms-content-md5 de la solicitud, entre comillas. El valor del hash MD5 especificado en este campo representa el contenido de la solicitud. Este campo puede estar vacío. "788815fd0198be0d275ad329cafd1830"
<server-md5> string El valor del hash MD5 calculado por el servicio de almacenamiento, entre comillas. Este campo puede estar vacío. "3228b3cf1069a5489b298446321f8521"
<etag-identifier> string Identificador de la ETag del objeto devuelto, entre comillas. "0x8D101F7E4B662C4"
<last-modified-time> datetime La hora de última modificación (LMT) para el objeto devuelto, entre comillas. Este campo está vacío en el caso de operaciones que pueden devolver varios objetos. Tuesday, 09-Aug-11 21:13:26 GMT
<conditions-used> string Una lista separada por punto y coma en forma de ConditionName=value, entre comillas. ConditionName puede ser una de las condiciones siguientes:

- 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 El valor del encabezado User-Agent, entre comillas. "Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0)"
<referrer-header> string El valor del encabezado Referer, entre comillas. "http://contoso.com/about.html"
<client-request-id> string El valor del encabezado x-ms-client-request-id incluido en la solicitud, entre comillas. "8/9/2011 9:44:36 PM 45ef1c0f-8c71-4153-bc88-38589f63fbfc"

Entradas de registro de ejemplo para la versión 1.0

Get Blob

La siguiente entrada de registro de ejemplo se aplica a una solicitud 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

La siguiente entrada de registro de ejemplo se aplica a una solicitud 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"

Copia de blobs

Las siguientes entradas de registro de ejemplo se aplican a una solicitud copyBlob autorizada. La operación Copiar blob registrará 3 operaciones: CopyBlob, CopyBlobSource y CopyBlobDestination. Observe que la propiedad de identificador de solicitud es idéntica para las tres operaciones, pero el identificador de operación se incrementa en cada una.

Versión del servicio 2012-02-12 y versiones más recientes

En la versión 12-02-2012 y versiones más recientes, la <requested-object-key> es una URL, que reemplaza el formato de /accountname/containername/blobname que se usa en las versiones anteriores a 12-02-2012.

El identificador de solicitud y el identificador de operación están en negrita para cada una de las entradas de registro siguientes:

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"

Versiones de servicio anteriores a 2012-02-12

El identificador de solicitud y el identificador de operación están en negrita para cada una de las entradas de registro siguientes:

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

Storage Analytics formato de registro versión 2.0 agrega campos para admitir la información de registro sobre las solicitudes autorizadas con un token de OAuth 2.0 proporcionado por Azure Active Directory(Azure AD). La autenticación y autorización con Azure AD para los servicios de blobs y colas se encuentra actualmente en versión preliminar. Para obtener más información, vea Autenticación mediante Azure Active Directory.

Cada entrada de registro de la versión 2.0 cumple el siguiente 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 registro para la versión 2.0

En la tabla siguiente se enumeran y definen los campos adicionales escritos en una entrada de registro de la versión 2.0. Todos los campos de la versión 1.0 se incluyen en las entradas de registro de la versión 2.0.

Nombre del campo Tipo de campo Definición Ejemplo
UserObjectId string Identificador de objeto usado para la autenticación. Puede ser cualquier entidad de seguridad, incluido un usuario, una identidad administrada o una entidad de servicio. 03124200-da00-4aa6-aa09-be77923d7870
TenantId string Identificador de inquilino usado en la autorización de portador. 72f988bf-86f1-41af-91ab-2d7cd011db47
ApplicationId string Identificador de aplicación usado en la autorización del portador. 2cd20493-fe97-42ef-9ace-ab95b63d82c4
Id. de recurso string Identificador de recurso usado en la autorización de portador. https://storage.azure.com

https://storagesamples.blob.core.windows.net
Emisor string Emisor usado en la autorización de portador. https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/
UserPrincipalName string Nombre principal de usuario usado en la autorización de portador. testuser@azure.onmicrosoft.com
Reserved string Reservado para uso futuro. El valor es una cadena vacía. N/D
AuthorizationDetail string Información detallada de la directiva utilizada para autorizar la solicitud. [{"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 registro de ejemplo para la versión 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"}]"

Consulte también

Acerca del registro de Storage Analytics
Operaciones y mensajes de estado registrados por Storage Analytics