Journaux d’audit
La fonctionnalité des journaux d’audit définit des événements d’opération structurés au niveau du compte pour l’historique d’exécution et le dépannage. Cela vous donne une trace fiable de qui a fait quoi et de ce qui s’est passé ensuite.
Pourquoi c’est important
Cette fonctionnalité préserve une trace vérifiable des opérations d’identification, de tâche, de travail et de courrier électronique afin que l’examen des incidents soit basé sur un historique d’exécution concret. Il combine un accès limité au compte avec des champs de journal consultables et des opérations de nettoyage explicites pour garantir la fiabilité des diagnostics au fil du temps.
Flux de base
Les actions opérationnelles émettent des événements de journal structurés avec des champs d’objet et d’action, que les opérateurs interrogent via des listes et des itinéraires de recherche lors du dépannage. Les lectures de journaux détaillées et les appels de nettoyage limités restent des opérations explicites.
Opérations
| Opération | Point de terminaison | Objectif |
|---|---|---|
| Créer un journal | POST /api/accounts/:account_id/logs |
Écrire un événement d’opération structurée |
| Liste des journaux | GET /api/accounts/:account_id/logs |
Récupérer le flux du journal du compte |
| Journaux de recherche | POST /api/accounts/:account_id/logs/search |
Journaux de requête par critères d’événement |
| Supprimer les journaux par recherche | POST /api/accounts/:account_id/logs/search-delete |
Journaux correspondants de nettoyage en masse |
| Obtenir le journal | GET /api/logs/:log_id |
Récupérer une entrée de journal |
| Supprimer le journal | DELETE /api/logs/:log_id |
Supprimer une entrée de journal |
Données clés et état
{
id: "log_...",
account_id: "acc_...",
subject: "job",
action: "retry",
status: "failed",
data: { job_id: "job_...", error_code: "provider_timeout" }
}Modes de défaillance et contrôles
L’étendue du compte ou l’autorisation manquante rejette les lectures et écritures du journal, et la suppression de la recherche reste explicite et limitée au compte pour éviter toute suppression accidentelle à grande échelle. Les champs structurés préservent les détails des échecs pour le débogage déterministe, tandis que les points de terminaison de récupération restent en lecture seule et distincts des routes de mutation.
Connexes
[Journal des opérations] (/fr/types/operation-log), [09-audit-logs-and-opérations] (/fr/guides/09-audit-logs-and-operations).