Esquemas específicos de servicio y común para los registros de recursos de Azure
Nota
Los registros de recurso se conocían anteriormente como registros de diagnóstico. El nombre se cambió en octubre de 2019, dado que los tipos de registros recopilados por Azure Monitor evolucionaron para incluir algo más que tan solo el recurso de Azure.
Este artículo se usa para enumerar las categorías de registro de recursos que puede recopilar. Dicha lista se encuentra ahora en Categorías del registro de recursos.
Los registros de recursos de Azure Monitor son los registros emitidos por los servicios de Azure que describen el funcionamiento de dichos servicios o recursos. Todos los registros de recursos disponibles en Azure Monitor comparten un esquema de nivel superior común. Cada servicio tiene la flexibilidad de emitir propiedades únicas para sus propios eventos.
Una combinación del tipo de recurso (disponible en la propiedad resourceId) y la categoría identifican un esquema de forma única. En este artículo se describen los esquemas de nivel superior para los registros de recursos y los vínculos a los esquemas para cada servicio.
Esquema común de nivel superior
Nota
El esquema descrito aquí es válido cuando los registros de recursos se envían a Azure Storage o a un centro de eventos. Cuando los registros se envían a un área de trabajo de Log Analytics, los nombres de columna pueden ser diferentes. Consulte Columnas estándar en registros de Azure Monitor para ver las columnas comunes a todas las tablas de un área de trabajo de Log Analytics y Referencia de datos de Azure Monitor para obtener una referencia de tablas diferentes.
| Nombre | Requerido u Opcional | Descripción |
|---|---|---|
time |
Obligatorio | Marca de tiempo (UTC) del evento que se está registrando. |
resourceId |
Obligatorio | Identificador del recurso que ha emitido el evento. Para los servicios de inquilino, presenta el formato /tenants/tenant-id/providers/provider-name. |
tenantId |
Necesario para los registros de inquilinos | El identificador del inquilino de Active Directory al que está asociado este evento. Esta propiedad solo se usa para los registros de nivel de inquilino. No aparece en los registros de nivel de recurso. |
operationName |
Obligatorio | Nombre de la operación que este evento está registrando, por ejemplo Microsoft.Storage/storageAccounts/blobServices/blobs/Read. Normalmente, operationName se modela en forma de una operación de Azure Resource Manager, Microsoft.<providerName>/<resourceType>/<subtype>/<Write|Read|Delete|Action>, aunque no sea una operación documentada de Resource Manager. |
operationVersion |
Opcional | La versión de API asociada con la operación, si operationName se ha realizado mediante una API (por ejemplo, http://myservice.windowsazure.net/object?api-version=2016-06-01). Si ninguna API se corresponde con esta opración, la versión representa la versión de esa operación en caso de que las propiedades asociadas con la operación cambien en el futuro. |
category o type |
Obligatorio | Categoría de registro del evento que se va a registrar. La categoría es la granularidad con la que se pueden habilitar o deshabilitar los registros en un recurso determinado. Las propiedades que aparecen en el blob de propiedades de un evento son las mismas dentro de una categoría de registro y un tipo de recurso concretos. Las categorías de registros típicas son Audit, Operational, Execution y Request. En el caso del recurso de Application Insights, type indica la categoría de registro exportado. |
resultType |
Opcionales | Estado del evento registrado, si procede. Los valores incluyen Started, In Progress, Succeeded, Failed, Active y Resolved. |
resultSignature |
Opcional | Subestado del evento. Si esta operación se corresponde con una llamada API de REST, este campo es el código de estado HTTP de la llamada REST correspondiente. |
resultDescription |
Opcionales | Descripción de texto estático de esta operación; por ejemplo, Get storage file. |
durationMs |
Opcional | Duración de la operación en milisegundos. |
callerIpAddress |
Opcional | Dirección IP del autor de la llamada, si la operación se corresponde con una llamada API que podría proceder de una entidad con una dirección IP disponible públicamente. |
correlationId |
Opcionales | GUID que se usa para agrupar un conjunto de eventos relacionados. Normalmente, si dos eventos tienen el mismo valor operationName pero dos estados diferentes (por ejemplo, Started y Succeeded), comparten el mismo valor correlationID. Esto también puede representar otras relaciones entre los eventos. |
identity |
Opcional | Blob JSON que describe la identidad del usuario o la aplicación que realizó la operación. Normalmente esto incluye la autorización y las notificaciones o el token JWT de Active Directory. |
level |
Opcional | Nivel de gravedad del evento. Debe ser uno de los siguientes: Informational, Warning, Error o Critical. |
location |
Opcionales | Región del recurso que emite el evento; por ejemplo, East US o France South. |
properties |
Opcionales | Todas las propiedades extendidas relacionadas con esta categoría de eventos. Todas las propiedades personalizadas o únicas se deben colocar dentro de esta "Parte B" del esquema. |
Esquemas específicos por servicio
El esquema para los registros de recursos varía según la categoría de registro y el recurso. En la lista siguiente se muestran los servicios de Azure que hacen que los registros de recursos y los vínculos estén disponibles para el servicio y los esquemas específicos de la categoría (cuando sea posible). La lista cambia a medida que se agregan nuevos servicios. Si no ve lo que necesita, no dude en abrir una incidencia de GitHub en este artículo para que podamos actualizarlo.
Pasos siguientes
- Visualización de las categorías de registro de recursos que se pueden recopilar
- Más información sobre los registros de recurso
- Transmisión de registros de recursos a Event Hubs
- Cambio de la configuración de diagnóstico del registro de recursos con la API de REST de Azure Monitor
- Análisis de registros desde Azure Storage con Log Analytics