Visualización de registros de actividad para supervisar acciones sobre recursosView activity logs to monitor actions on resources

Mediante los registros de actividad, puede determinar:Through activity logs, you can determine:

  • qué operaciones se realizaron en los recursos en la suscripciónwhat operations were taken on the resources in your subscription
  • quién inició la operaciónwho started the operation
  • cuándo tuvo lugar la operaciónwhen the operation occurred
  • el estado de la operaciónthe status of the operation
  • los valores de otras propiedades que podrían ayudarle en la investigación de la operaciónthe values of other properties that might help you research the operation

El registro de actividad contiene todas las operaciones de escritura (PUT, POST, DELETE) para los recursos.The activity log contains all write operations (PUT, POST, DELETE) for your resources. No incluye operaciones de lectura (GET).It doesn't include read operations (GET). Para obtener una lista de las acciones de recurso, consulte Operaciones del proveedor de recursos de Azure Resource Manager.For a list of resource actions, see Azure Resource Manager Resource Provider operations. Puede usar los registros de actividad para encontrar un error al solucionar problemas o para supervisar cómo un usuario de su organización modificó un recurso.You can use the activity logs to find an error when troubleshooting or to monitor how a user in your organization modified a resource.

Los registros de actividad se conservan 90 días.Activity logs are kept for 90 days. Puede consultar cualquier intervalo de fechas, siempre que no hayan transcurrido más de 90 días desde la fecha inicial.You can query for any range of dates, as long as the starting date isn't more than 90 days in the past.

Puede recuperar información de los registros de actividad mediante el portal, PowerShell, la CLI de Azure, la API de REST de Insights o la biblioteca .NET de Insights.You can retrieve information from the activity logs through the portal, PowerShell, Azure CLI, Insights REST API, or Insights .NET Library.

Portal de AzureAzure portal

Para ver los registros de actividad mediante el portal, siga estos pasos:To view the activity logs through the portal, follow these steps:

  1. En el menú de Azure Portal, seleccione Monitor o busque y seleccione Monitor desde cualquier página.On the Azure portal menu, select Monitor, or search for and select Monitor from any page.

    Seleccionar Monitor

  2. Seleccione Registro de actividad.Select Activity Log.

    Seleccionar el registro de actividades

  3. Verá un resumen de operaciones recientes.You see a summary of recent operations. Se aplica un conjunto predeterminado de filtros a las operaciones.A default set of filters is applied to the operations. Tenga en cuenta que en la información del resumen se incluye quién ha iniciado la acción y cuándo ha tenido lugar.Notice the information on the summary includes who started the action and when it happened.

    Vista de resumen de las operaciones recientes

  4. Para ejecutar de forma rápida un conjunto predefinido de filtros, seleccione Conclusiones rápidas.To quickly run a pre-defined set of filters, select Quick Insights.

    Selección de Conclusiones rápidas

  5. Seleccione una de las opciones.Select one of the options. Por ejemplo, seleccione Implementaciones con errores para ver los errores de las implementaciones.For example, select Failed deployments to see errors from deployments.

    Selección de Implementaciones con errores

  6. Tenga en cuenta que los filtros se han cambiado para centrarse en los errores de implementación de las últimas 24 horas.Notice the filters have been changed to focus on deployment errors in the last 24 hours. Solo se muestran las operaciones que coinciden con los filtros.Only operations that match the filters are displayed.

    Ver filtros

  7. Para centrarse en operaciones específicas, cambie los filtros o aplique otros nuevos.To focus on specific operations, change the filters or apply new ones. Por ejemplo, la siguiente imagen muestra que se estableció un nuevo valor para Timespan y Resource type en cuentas de almacenamiento.For example, the following image shows a new value for the Timespan and Resource type is set to storage accounts.

    Establecer opciones de filtro

  8. Si necesita volver a ejecutar la consulta más tarde, seleccione Anclar los filtros actuales.If you need to run the query again later, select Pin current filters.

    Anclar filtros

  9. Asigne un nombre al filtro.Give the filter a name.

    Asignar un nombre a los filtros

  10. El filtro está disponible en el panel.The filter is available in the dashboard. En el menú de Azure Portal, seleccione Panel.On the Azure portal menu, select Dashboard.

    Mostrar filtro en el panel

  11. Desde el portal, puede ver los cambios realizados en un recurso.From the portal, you can view changes to a resource. Vaya hasta la vista predeterminada en el Monitor y seleccione una operación que implique el cambio de un recurso.Go back to the default view in Monitor, and select an operation that involved changing a resource.

    Selección de la operación

  12. Seleccione Historial de cambios (versión preliminar) y elija una de las operaciones disponibles.Select Change history (Preview) and pick one of the available operations.

    Selección del Historial de cambios

  13. Se mostrarán los cambios en el recurso.The changes in the resource are displayed.

    Mostrar cambios

Para obtener más información sobre el historial de cambios, vea Obtención de los cambios del recurso.To learn more about change history, see Get resource changes.

PowerShellPowerShell

Nota

Este artículo se ha actualizado para usar el nuevo módulo Az de Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Aún puede usar el módulo de AzureRM que continuará recibiendo correcciones de errores hasta diciembre de 2020 como mínimo.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Para más información acerca del nuevo módulo Az y la compatibilidad con AzureRM, consulte Introducing the new Azure PowerShell Az module (Presentación del nuevo módulo Az de Azure PowerShell).To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Para obtener instrucciones sobre la instalación del módulo Az, consulte Instalación de Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Para recuperar las entradas de registro, ejecute el comando Get-AzLog.To retrieve log entries, run the Get-AzLog command. Ofrezca parámetros adicionales para filtrar la lista de entradas.You provide additional parameters to filter the list of entries. Si no especifica una hora de inicio y de finalización, se devuelven las entradas de los últimos siete días.If you don't specify a start and end time, entries for the last seven days are returned.

Get-AzLog -ResourceGroup ExampleGroup

En el ejemplo siguiente se muestra cómo usar el registro de actividad para investigar operaciones llevadas a cabo durante un tiempo especificado.The following example shows how to use the activity log to research operations taken during a specified time. Las fechas inicial y final se especifican en un formato de fecha.The start and end dates are specified in a date format.

Get-AzLog -ResourceGroup ExampleGroup -StartTime 2019-05-05T06:00 -EndTime 2019-05-09T06:00

También puede usar funciones de fecha para especificar el intervalo de fechas, como los últimos 14 días.Or, you can use date functions to specify the date range, such as the last 14 days.

Get-AzLog -ResourceGroup ExampleGroup -StartTime (Get-Date).AddDays(-14)

Puede buscar las acciones realizadas por un usuario determinado.You can look up the actions taken by a particular user.

Get-AzLog -ResourceGroup ExampleGroup -StartTime (Get-Date).AddDays(-14) -Caller someone@contoso.com

Puede filtrar por las operaciones con errores.You can filter for failed operations.

Get-AzLog -ResourceGroup ExampleGroup -Status Failed

Para centrarse en un error, examine el mensaje de estado para esa entidad.You can focus on one error by looking at the status message for that entry.

(Get-AzLog -ResourceGroup ExampleGroup -Status Failed).Properties.Content.statusMessage | ConvertFrom-Json

Puede seleccionar valores específicos para limitar los datos que se devuelven.You can select specific values to limit the data that is returned.

Get-AzLog -ResourceGroupName ExampleGroup | Format-table EventTimeStamp, Caller, @{n='Operation'; e={$_.OperationName.value}}, @{n='Status'; e={$_.Status.value}}, @{n='SubStatus'; e={$_.SubStatus.LocalizedValue}}

En función de la hora de inicio que especifique, los comandos anteriores pueden devolver una lista larga de operaciones para el grupo de recursos.Depending on the start time you specify, the previous commands can return a long list of operations for the resource group. Puede filtrar los resultados para lo que busca ofreciendo criterios de búsqueda.You can filter the results for what you are looking for by providing search criteria. Por ejemplo, puede filtrar por el tipo de operación.For example, you can filter by the type of operation.

Get-AzLog -ResourceGroup ExampleGroup | Where-Object {$_.OperationName.value -eq "Microsoft.Resources/deployments/write"}

Puede usar Resource Graph para ver el historial de cambios de un recurso.You can use Resource Graph to see the change history for a resource. Para más información, vea Obtención de los cambios del recurso.For more information, see Get resource changes.

CLI de AzureAzure CLI

Para recuperar las entradas del registro, ejecute el comando az monitor activity-log list con un desplazamiento para indicar el intervalo de tiempo.To retrieve log entries, run the az monitor activity-log list command with an offset to indicate the time span.

az monitor activity-log list --resource-group ExampleGroup --offset 7d

En el ejemplo siguiente se muestra cómo usar el registro de actividad para investigar operaciones llevadas a cabo durante un tiempo especificado.The following example shows how to use the activity log to research operations taken during a specified time. Las fechas inicial y final se especifican en un formato de fecha.The start and end dates are specified in a date format.

az monitor activity-log list -g ExampleGroup --start-time 2019-05-01 --end-time 2019-05-15

Puede buscar las acciones realizadas por un usuario determinado, incluso para un grupo de recursos que ya no existe.You can look up the actions taken by a particular user, even for a resource group that no longer exists.

az monitor activity-log list -g ExampleGroup --caller someone@contoso.com --offset 5d

Puede filtrar por las operaciones con errores.You can filter for failed operations.

az monitor activity-log list -g ExampleGroup --status Failed --offset 1d

Para centrarse en un error, examine el mensaje de estado para esa entidad.You can focus on one error by looking at the status message for that entry.

az monitor activity-log list -g ExampleGroup --status Failed --offset 1d --query [].properties.statusMessage

Puede seleccionar valores específicos para limitar los datos que se devuelven.You can select specific values to limit the data that is returned.

az monitor activity-log list -g ExampleGroup --offset 1d --query '[].{Operation: operationName.value, Status: status.value, SubStatus: subStatus.localizedValue}'

En función de la hora de inicio que especifique, los comandos anteriores pueden devolver una lista larga de operaciones para el grupo de recursos.Depending on the start time you specify, the previous commands can return a long list of operations for the resource group. Puede filtrar los resultados para lo que busca ofreciendo criterios de búsqueda.You can filter the results for what you are looking for by providing search criteria. Por ejemplo, puede filtrar por el tipo de operación.For example, you can filter by the type of operation.

az monitor activity-log list -g ExampleGroup --offset 1d --query "[?operationName.value=='Microsoft.Storage/storageAccounts/write']"

Puede usar Resource Graph para ver el historial de cambios de un recurso.You can use Resource Graph to see the change history for a resource. Para más información, vea Obtención de los cambios del recurso.For more information, see Get resource changes.

API DE RESTREST API

Las operaciones REST para trabajar con el registro de actividad forman parte de la API de REST de Insights.The REST operations for working with the activity log are part of the Insights REST API. Para recuperar eventos de registro de actividad, consulte Lista de los eventos de administración de una suscripción.To retrieve activity log events, see List the management events in a subscription.

Pasos siguientesNext steps