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 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.
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:
- Blob service:Set Blob Service Properties (admite las versiones 1.0 y 2.0)
- Queue service:Set Queue Service Properties (admite las versiones 1.0 y 2.0)
- Table service:Set Table Service Properties (solo admite la versión 1.0)
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 Microsoft Entra ID. Para más información, consulte Autenticación con Microsoft Entra ID.
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.comhttps://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 |
| Reservado | 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&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"}]"
Consulte también
Acerca del registro de Storage Analytics
Operaciones y mensajes de estado registrados por Storage Analytics