Registros de auditoría
La función de registros de auditoría define eventos operativos estructurados con alcance de cuenta para el historial de ejecución y la resolución de problemas. Le brinda un rastro confiable de quién hizo qué y qué pasó después.
Por qué esto importa
Esta característica conserva un rastro auditable de las operaciones de credenciales, tareas, trabajos y correo electrónico, de modo que la revisión de incidentes se base en un historial de ejecución concreto. Combina acceso al ámbito de la cuenta con campos de registro con capacidad de búsqueda y operaciones de limpieza explícitas para mantener los diagnósticos confiables a lo largo del tiempo.
Flujo central
Las acciones operativas emiten eventos de registro estructurados con campos de asunto y acción, que los operadores consultan a través de listas y rutas de búsqueda durante la resolución de problemas. Las lecturas de registros detalladas y las llamadas de limpieza con alcance siguen siendo operaciones explícitas.
Operaciones
| Operación | Punto final | Objetivo |
|---|---|---|
| Crear registro | POST /api/accounts/:account_id/logs | Escribir evento de operación estructurada |
| Listar registros | GET /api/accounts/:account_id/logs | Recuperar flujo de registro de cuenta |
| Registros de búsqueda | POST /api/accounts/:account_id/logs/search | Consultar registros por criterios de eventos |
| Eliminar registros mediante búsqueda | POST /api/accounts/:account_id/logs/search-delete | Registros coincidentes de limpieza masiva |
| Obtener registro | GET /api/logs/:log_id | Recuperar una entrada de registro |
| Eliminar registro | DELETE /api/logs/:log_id | Eliminar una entrada de registro |
Datos clave y estado
{
id: "log_...",
account_id: "acc_...",
subject: "job",
action: "retry",
status: "failed",
data: { job_id: "job_...", error_code: "provider_timeout" }
}Modos de falla y controles
La falta de autorización o alcance de la cuenta rechaza las lecturas y escrituras de registros, y la eliminación por búsqueda permanece explícita y con el alcance de la cuenta para evitar una eliminación amplia accidental. Los campos estructurados preservan los detalles de las fallas para la depuración determinista, mientras que los endpoints de recuperación permanecen como de solo lectura y separados de las rutas de mutación.
Relacionado
Registro de operaciones, 09-registros-y-operaciones-de-auditoría.