Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Azure Monitor registra las operaciones de administración de los recursos de Azure a través de la característica de registro de actividad. El registro de actividad registra operaciones como la creación de una máquina virtual, el cambio de una directiva de acceso del almacén de claves o los errores de implementación de Resource Manager. Estas operaciones de administración también se denominan operaciones del plano de control . Use el registro de actividad para revisar o auditar esta información, o cree una alerta para recibir una notificación proactiva cuando se produzca un evento.
A diferencia del registro de actividad, los registros de recursos Azure capturan data plane las operaciones realizadas en un recurso. Por ejemplo, estas operaciones incluyen obtener un secreto de un almacén de claves o realizar una solicitud a una base de datos. Los registros de recursos no se recopilan de forma predeterminada y requieren configuración con una configuración de diagnóstico.
Sugerencia
Si un error de operación de implementación le dirige a este artículo, consulte Solución de errores comunes de implementación de Azure.
Entradas del registro de actividad
Azure Monitor recopila entradas del registro de actividad de forma predeterminada sin ninguna configuración necesaria. El sistema genera estas entradas y no puede cambiarlas ni eliminarlas. Las entradas suelen derivar de cambios (operaciones de creación, actualización y eliminación) o de una acción que se está iniciando. El registro de actividad no suele capturar operaciones de lectura.
Las entradas del registro de actividad suelen estar disponibles para el análisis y las alertas en un plazo de 3 a 20 minutos después de que se produzca el evento. Para obtener una descripción de las categorías del registro de actividad, consulte Azure esquema de eventos del registro de actividad.
Período de retención
Azure conserva los eventos del registro de actividad durante 90 días y, a continuación, los elimina. No se le aplican cargos por las entradas durante este tiempo, independientemente del volumen. Para obtener más funcionalidad, como la retención más larga, cree una configuración de diagnóstico y recopile las entradas en otra ubicación en función de sus necesidades. Una de las razones más comunes para ampliar el período de retención es conservar la información del creador de recursos, que solo está disponible en el registro de actividad.
Visualización y recuperación del registro de actividad
Vea los eventos del registro de actividad para una suscripción, un grupo de recursos o un recurso individual. Utiliza el portal de Azure o consúltalas mediante programación usando la API REST del registro de actividad.
El portal de Azure proporciona el panel Activity log desde la mayoría de los menús de servicio. Cada una de estas áreas también admite el acceso mediante programación con REST o a través de CLI de Azure y comandos de Azure PowerShell específicos.
Especifique un intervalo de tiempo de eventos para recuperar. Para recuperar eventos mediante la API REST, debe incluir el $filter parámetro junto con al menos un eventTimestamp valor inicial. De forma predeterminada, el registro de actividad conserva los eventos durante 90 días. Asegúrese de que tanto el inicio como el final del intervalo de tiempo se encuentran dentro de esa ventana de 90 días.
Escenarios de acceso al registro de actividad
En las secciones siguientes se presentan escenarios comunes que muestran diferentes formas de acceder a los eventos del registro de actividad y recuperar a través del portal de Azure, mediante programación mediante CLI de Azure y Azure PowerShell, o con llamadas REST:
Ejemplos del portal de Azure proporcionan contexto adicional sobre qué tipo de eventos esperar en esa vista.
CLI de Azure ejemplos resaltan los comandos específicos disponibles a través del comando az monitor activity-log list.
Azure PowerShell ejemplos resaltan los cmdlets específicos disponibles a través del commandlet Get-AzActivityLog.
Los ejemplos de API REST muestran cómo recuperar eventos utilizando el parámetro requerido
$filtercon la API REST del registro de actividad.El ejemplo Enumerar eventos del registro de actividad de un grupo de recursos también muestra cómo establecer explícitamente en el cliente un tiempo de espera, para ajustarlo al tiempo de espera máximo de 75 segundos de la API de REST del registro de actividad mediante el encabezado
Prefer.Patrones admitidos $filterDetalles suscripción predeterminada con un intervalo de tiempo $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}'Grupo de recursos $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}' and resourceGroupName eq '{resourceGroupName}'recurso específico $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}' and resourceUri eq '{resourceURI}'proveedor de recursos $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}' and resourceProvider eq '{resourceProviderName}'id. de correlación $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}' and correlationId eq '{correlationID}'
Listar eventos del registro de actividad de una suscripción
Los eventos de nivel de suscripción capturan los eventos creados directamente por los proveedores de recursos y es el ámbito predeterminado para enumerar los eventos del registro de actividad. Los eventos de inquilino y de grupo de administración solo capturan eventos de Azure Resource Manager en esas jerarquías. Estos ámbitos de nivel superior no incluyen eventos generados directamente por proveedores de recursos fuera de las operaciones de Azure Resource Manager.
En el ejemplo siguiente se recuperan los eventos del registro de actividad de una suscripción durante un intervalo de tiempo específico.
El menú desde el que abre registro de actividad determina su filtro inicial. Si lo abre en el menú Supervisión , el único filtro seleccionado de forma predeterminada es la suscripción. Esto es lo mismo que abrirlo desde Suscripciones>, seleccione > de suscripción.
Enumeración de eventos de registro de actividad para un grupo de recursos
Agregue resourceGroupName al $filter para definir el ámbito de los resultados del registro de actividad de Azure Monitor a un grupo de recursos específico.
El menú desde el que abre registro de actividad determina su filtro inicial. Si lo abre desde el menú de un recurso, el filtro se establecerá en ese recurso. Seleccione Agregar filtro para agregar más propiedades al filtro. Estas son las otras propiedades que puede filtrar en el portal:
- Resource: elementos que forman parte de la solución de Azure, como una base de datos o una máquina virtual.
- Tipo de recurso : categoría a la que pertenece un recurso, como máquinas virtuales, aplicaciones web o bases de datos.
- Operation: acción o comando, como crear, eliminar y escribir, que afecta a los recursos de Azure Resource Manager.
- Evento iniciado por : filtre los eventos por la identidad que inició el evento.
- Categoría de evento : filtre los tipos de eventos para determinadas operaciones.
Devolver propiedades específicas del registro de actividad
Use un parámetro para devolver solo las propiedades especificadas, lo que reduce el tamaño de la carga de respuesta. Para obtener más información, consulte Descripciones de propiedades del esquema del registro de actividad.
El portal de Azure no proporciona una manera de limitar las propiedades devueltas directamente de los eventos del registro de actividad. Para reducir la cantidad de datos vistos, use la opción Editar columnas de la hoja Registro de actividad para seleccionar qué columnas se muestran en la vista del portal.
Enumeración de eventos de registro de actividad de nivel de inquilino
Los eventos de registro de actividad de nivel de inquilino suelen tener entradas limitadas, pero pueden incluir eventos importantes, como la creación de grupos de administración o suscripciones. Estos eventos son independientes de los eventos del registro de actividad de nivel de suscripción, pero pueden contener eventos de administración de recursos duplicados.
Las consultas en este ámbito utilizan una API REST diferente a la API de eventos del registro de actividad a nivel de suscripción. CLI de Azure y Azure PowerShell no proporcionan comandos dedicados.
Vaya a Monitor>Activity log en el portal de Azure. Cambie el menú desplegable Actividad y seleccione Actividad de directorio.
Listar eventos del registro de actividad a nivel de grupo de administración
Los eventos de registro de actividad de nivel de grupo de administración capturan eventos cuyo ámbito es un grupo de administración específico, como las asignaciones de directivas y los cambios de pertenencia a grupos de administración.
Nota:
- En los ejemplos siguientes se usa la versión de la
2017-03-01-previewAPI, que es necesaria para las consultas de registro de actividad de nivel de grupo de administración.
Para ver los eventos del registro de actividad de nivel de grupo de administración en el portal de Azure, vaya a Grupos de administración> seleccione un grupo de administración > Registro de actividad.
En la tabla siguiente se describen los parámetros usados en los ejemplos anteriores.
| Variable | Ejemplo de valor | propósito |
|---|---|---|
| host | management.azure.com | Punto de conexión de ARM implícito |
| subscriptionId | aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e | Entrada de usuario |
| resourceGroupName | myResourceGroup | Entrada de usuario |
| managementGroupId | myManagementGroup | Entrada de usuario |
| apiVersion | • 2015-04-01 • 2017-03-01-preview (para el nivel de grupo de administración) |
Referencia |
Visualización del historial de cambios
En el caso de algunos eventos, puede ver el historial de cambios, en el que se muestran los cambios que se han producido durante la hora del evento. Seleccione un evento en el registro de actividad que desea examinar más profundamente. Seleccione la pestaña Historial de cambios para ver los cambios en el recurso hasta 30 minutos antes y después del tiempo de la operación.
Si hay algún cambio asociado al evento, el portal muestra una lista seleccionable de cambios. Al seleccionar un cambio, se abre la página Historial de cambios. En esta página, se muestran los cambios en el recurso.
En el ejemplo siguiente se muestra que la máquina virtual cambió los tamaños. La página muestra el tamaño de la máquina virtual antes del cambio y después del cambio. Para más información sobre el historial de cambios, consulte Obtención de cambios en los recursos.
Información del registro de actividad
Activity log insights es un libro de Azure Monitor que proporciona un conjunto de paneles que supervisan los cambios en los recursos y los grupos de recursos de una suscripción. Los paneles también presentan datos sobre qué usuarios o servicios realizaron actividades en la suscripción y el estado de las actividades.
Para habilitar la información del registro de actividad, exporte el registro de actividad a un área de trabajo de Log Analytics tal como se describe en Export activity log. Este proceso envía los eventos a la tabla AzureActivity, que usa la información del registro de actividad.
Puede acceder a los informes del registro de actividad a nivel de suscripción o de recurso. Para la suscripción, seleccione Información de registros de actividad en la sección Libros de Trabajo del menú Monitor.
Para un recurso individual, seleccione Información sobre registros de actividad en la sección Cuadernos del menú del recurso.
Exportar registro de actividad
Cree una configuración de diagnóstico para enviar entradas del registro de actividad a otros destinos para una funcionalidad y un tiempo de retención adicionales.
En el portal de Azure, seleccione Activity log en el menú Azure Monitor y, a continuación, seleccione Export Activity Logs. Para más información y otros métodos para crear la configuración de diagnóstico, consulte Configuración de diagnóstico en Azure Monitor. Asegúrese de deshabilitar cualquier configuración heredada para el registro de actividad.
En las secciones siguientes se proporcionan detalles sobre cada destino configurable para los registros de recursos.
Nota:
El método heredado para exportar el registro de actividad es perfiles de registro. Consulte Métodos de colección heredados.
Envíe el registro de actividad a un área de trabajo de Log Analytics para la funcionalidad siguiente:
- Correlacionar los registros de actividad con otros datos de registro mediante consultas de registro.
- Cree alertas de registro, que pueden usar una lógica más compleja que las alertas del registro de actividad.
- Acceda a los datos del registro de actividad con Power BI.
- Conservar los datos del registro de actividad durante más de 90 días.
No hay cargos de ingesta de datos para los registros de actividad. Los cargos de retención de los registros de actividad solo se aplican al período extendido más allá del período de retención predeterminado de 90 días. Puede aumentar el período de retención hasta 12 años.
Los datos del registro de actividad de un área de trabajo de Log Analytics se almacenan en una tabla denominada AzureActivity. La estructura de esta tabla varía en función de la categoría de la entrada de registro.
Por ejemplo, para ver un recuento de las entradas del registro de actividad para cada categoría, use la consulta siguiente:
AzureActivity
| summarize count() by CategoryValue
Para recuperar todos los registros de la categoría administrativa, use la consulta siguiente:
AzureActivity
| where CategoryValue == "Administrative"
Importante
En algunos casos, los valores en los campos de AzureActivity pueden tener un diferente uso de mayúsculas y minúsculas respecto a otros valores equivalentes. Al consultar datos en AzureActivity, use operadores que no distingan entre mayúsculas y minúsculas para las comparaciones de cadenas, o use una función escalar para forzar un campo a un formato uniforme antes de realizar cualquier comparación. Por ejemplo, use la función tolower() en un campo para forzar que siempre esté en minúsculas o el operador =~ al realizar una comparación de cadenas.
Exportación de registros de actividad del grupo de administración
Al crear una configuración de diagnóstico para un grupo de administración, exporta Azure Monitor eventos de registro de actividad para ese grupo de administración, además de todos los grupos de administración de la jerarquía. Si varios grupos de administración de la jerarquía tienen configuraciones de diagnóstico, se recibirán eventos duplicados. Solo necesita una configuración de diagnóstico en el grupo de administración de nivel más alto para capturar todos los eventos de la jerarquía.
El grupo de administración también recopila muchos eventos iguales que cualquier suscripción debajo de él. Si tanto la suscripción como el grupo de administración tienen sus propias configuraciones de diagnóstico, se recibirán eventos duplicados. Azure Resource Manager incluye una propiedad de jerarquía al escribir eventos, pero no es un campo obligatorio. Los proveedores de recursos fuera de Azure Resource Manager no lo rellenan, por lo que sus eventos no se propagan hacia arriba en la jerarquía. Debido a esto, obtener eventos duplicados es mejor que los eventos que faltan.
Por ejemplo, si tiene MG1 que incluye MG2 con Subscription1, una configuración de diagnóstico en MG1 captura todos los eventos del registro de actividad para MG1, MG2, así como muchos de los eventos recogidos por una configuración de diagnóstico en Subscription1. En este caso, no se necesita ninguna configuración de diagnóstico en MG2, ya que simplemente recopilaría eventos duplicados.
Si tiene eventos duplicados, combínelos mediante una consulta que use un hash de todos los campos para identificar registros únicos. En el ejemplo siguiente, la consulta kusto muestra un ejemplo para los registros recopilados en un área de trabajo de Log Analytics:
AzureActivity
| extend Hash = hash(dynamic_to_json(pack_all()))
| summarize arg_max(TimeGenerated, *) by Hash
Exportación del registro de actividad a un archivo
Seleccione Descargar como CSV para exportar el registro de actividad a un archivo CSV en Azure Portal.
Importante
La exportación de un gran número de entradas de registro puede tardar mucho tiempo. Para mejorar el rendimiento, reduzca el intervalo de tiempo de la exportación. En Azure Portal, establezca la configuración Timespan .
Identificación de la creación de recursos
Use el registro de actividad para averiguar cuándo el sistema creó un recurso y quién lo creó. El registro de actividad es el único lugar que almacena el creador de un recurso. Dado que el registro de actividad solo conserva los datos durante 90 días de forma predeterminada, debe exportar los registros a una ubicación que le permita ampliar el período de retención, como un área de trabajo de Log Analytics. A continuación, busque el creador de un recurso consultando la AzureActivity tabla. Los datos se conservan durante la duración especificada en el período de retención de esta tabla.