Exportar eventos de auditoría
Descarga los eventos de auditoría de tu tenant, con la pestaña, los filtros y el rango de fechas que estableciste, como un archivo CSV que puedes guardar como evidencia o entregar a un auditor.
Quién puede hacerlo
Un administrador del tenant o un auditor del tenant, y un superadministrador o un auditor de la plataforma que trabaje en tu tenant. Los mismos permisos que muestran la lista permiten la exportación, y el archivo contiene solo las trazas que puedes leer.
Antes de empezar
- Una exportación siempre cubre una ventana declarada. Establece un Rango de fechas, o la exportación toma la ventana con la que realmente se sirvió la lista. La ventana puede abarcar como máximo 365 días.
- Establece primero la pestaña, los filtros y el sujeto: el archivo contiene exactamente las filas a partir de las que se construye la lista.
Pasos
- Abre Auditoría desde la navegación de tu tenant.
- Elige la pestaña, establece el Rango de fechas y los filtros o el sujeto que necesites.
- Selecciona Exportar CSV.
- En Exportar el registro de auditoría, lee Qué se va a exportar: la Ventana, los Filtros activos y el Formato.
- Selecciona Exportar CSV.
Qué ves cuando funcionó
La consola indica "Registro de auditoría exportado" y tu navegador guarda un archivo CSV. El archivo tiene el mismo conjunto fijo de columnas sea cual sea la pestaña desde la que exportas, y no incluye la columna de detalles.
Una exportación se detiene en un límite de filas establecido para tu instalación, 10.000 filas de forma predeterminada. Cuando se detiene antes, la consola avisa: "El servidor se detuvo en su límite de filas: este archivo no es el resultado completo." Acota el rango de fechas o los filtros y exporta por partes.
Si falla
| Qué ves | Causa | Qué hacer |
|---|---|---|
| Exportar CSV está deshabilitado | El filtro por sujeto tiene un valor que no puede ser un sujeto | Corrige o quita el sujeto |
| "Elige primero un rango de fechas: una exportación siempre cubre una ventana declarada." | No se conoce ninguna ventana para la lista | Establece un Rango de fechas y exporta de nuevo |
| "El servicio de auditoría de este entorno no puede filtrar la exportación por sujeto ({subject}). No se guardó ningún archivo." | El servicio de auditoría de este entorno no admite el filtro por sujeto | Exporta sin el sujeto, o consulta a tu administrador |
| "El servidor se detuvo en su límite de filas: este archivo no es el resultado completo." | Coinciden más filas de las que permite el límite | Acota el rango o los filtros y exporta por partes |
| Un rango de fechas no válido para la exportación, con un máximo de 365 días ("Invalid date range for export query: maximum range is 365 days (received {n} days)") | El rango de fechas abarca más de 365 días | Elige un rango de 365 días o menos y exporta por partes; consulta Invalid Input (en inglés) |
| El motivo que dio el servicio de auditoría, o "La exportación falló" | La solicitud se rechazó por otro motivo | Corrige lo que indica el motivo y exporta de nuevo |
Sin la consola
| Superficie | Cómo |
|---|---|
| API | GET /api/v3/audit/tenants/{tenantId}/events/export (operación exportTenantEvents) con los mismos filtros y el mismo sujeto que getUnifiedEvents. startTime y endTime son obligatorios y abarcan como máximo 365 días, y se rechaza un cursor; una solicitud rechazada responde 400 con el tipo de problema invalid-input. La respuesta lleva X-Export-Row-Ceiling y X-Export-Applied-Filters antes de la primera fila, y X-Export-Rows y X-Export-Truncated después de la última; un encabezado ausente significa desconocido, nunca completo |
No hay ningún comando de la CLI ni método del Admin SDK para la exportación.