Journaux d'audit

Les Journaux d'audit consignent les requêtes adressées à Performance Hub dans votre organisation. Ils couvrent les requêtes des personnes qui utilisent Performance Hub dans un navigateur ou dans l'application, ainsi que celles des outils connectés tels que les clés API, les agents IA connectés via MCP et Model Router. Utilisez-les pour répondre à des questions telles que : qui a déverrouillé une porte, pourquoi une modification n'a pas été enregistrée ou quand une intégration a cessé de fonctionner, que vos sites soient des bureaux, des magasins, des cafés, des lieux d'événements, des cliniques, des campus ou des salles de sport.

Référence rapide

Où le trouver : Settings (icône en forme de roue dentée, en bas à gauche) → Journaux d'audit

Qui peut l'utiliser : vous devez disposer d'un rôle qui inclut Journaux d'audit et Identity & Access Management dans votre organisation, comme Organisation Administrator. Consultez Qui peut utiliser les Journaux d'audit.

Objectif : voir qui a fait quoi dans Performance Hub et comprendre pourquoi une requête a échoué

Figure 1 : Le tableau de bord des Journaux d'audit : la fenêtre de temps, les indicateurs principaux et la chronologie des requêtes

Ce qui est consigné

Chaque entrée de journal correspond à une requête adressée à Performance Hub. Elle indique :

• Qui a effectué la requête : l'adresse e-mail de l'utilisateur.
• D'où : l'adresse IP, ainsi que le navigateur ou l'outil qui l'a envoyée.
• Ce qui a été appelé : la méthode (par exemple GET pour lire ou POST pour créer) et le point de terminaison, c'est-à-dire la partie de Performance Hub visée par la requête, comme /api/door-gate-access/doors/front-entrance/unlock.
• Le résultat : le code de réponse, par exemple 200 en cas de réussite ou 403 lorsque la personne n'avait pas l'autorisation.
• La durée de traitement, en millisecondes.
• Sa provenance : un badge de source, tel que web pour une personne utilisant Performance Hub ou api-key pour une intégration. Consultez Badges de source.

Pour les requêtes récentes, l'entrée de journal contient également ce qui a été envoyé et ce qui a été renvoyé. Consultez Lire une entrée de journal.

Les deux onglets

Qui peut utiliser les Journaux d'audit

Vous devez disposer d'un rôle qui inclut Journaux d'audit et Identity & Access Management dans votre organisation, comme Organisation Administrator. Si vous ne voyez pas Journaux d'audit dans le menu des paramètres, votre rôle ne l'inclut pas.

• Organisations visibles : les organisations dans lesquelles votre rôle inclut à la fois Journaux d'audit et Identity & Access Management. L'onglet Logs en indique le nombre, par exemple "Viewing logs for 1 organisation".
• Modèles de rôles : le modèle Organisation Administrator inclut Journaux d'audit. Les modèles Site Manager et Site Owner ne l'incluent pas. Consultez Modèles de rôles.
• Rôles personnalisés : pour permettre à un rôle personnalisé d'utiliser Journaux d'audit, incluez à la fois Journaux d'audit et Identity & Access Management dans son accès aux modules. Consultez Portée d'accès et accès aux modules.

Les Journaux d'audit affichent les adresses e-mail des personnes, leurs adresses IP et ce qu'elles ont envoyé : ne les rendez accessibles qu'aux personnes qui en ont besoin.

Durée de conservation des journaux

La conservation des journaux d'audit détermine la durée pendant laquelle ils sont conservés : 90 jours pour chaque entrée de journal, et 7 jours pour l'intégralité des contenus de requête et de réponse.

Le menu Range de l'onglet Logs indique :

"Les journaux d'audit sont conservés pendant 90 jours. Les charges utiles complètes des requêtes et réponses sont conservées pendant 7 jours, après quoi un bref aperçu est conservé. Besoin d'un historique plus long ? Contactez le support (des frais supplémentaires s'appliquent)."

Vous pouvez donc remonter jusqu'à 90 jours. Pendant les 7 premiers jours, une entrée de journal contient l'intégralité de la requête et de la réponse. Ensuite, les contenus les plus longs sont réduits à un court aperçu. Consultez Après 7 jours : aperçus.

Ce que vous pouvez faire

• Lire le tableau de bord : consultez le volume de requêtes, les taux d'erreur ainsi que les points de terminaison et les utilisateurs les plus actifs sur une fenêtre de temps.
• Trouver des requêtes : filtrez par plage de temps, adresse e-mail, adresse IP, point de terminaison, organisation, site, méthode et code de réponse, et partagez une vue filtrée.
• Lire une entrée de journal : voyez qui a effectué une requête, depuis où, et ce qui a été envoyé et renvoyé. Pour une requête ayant échoué, obtenez un résumé de l'erreur en langage clair.
• Exporter les journaux : téléchargez les journaux chargés sous forme de fichier CSV.
• Suivre un exemple d'investigation : des réponses étape par étape à des questions courantes, comme savoir qui a déverrouillé une porte ou pourquoi une intégration a cessé de se synchroniser.
• Questions fréquentes

Pages connexes

• Modèles de rôles : les modèles qui incluent Journaux d'audit
• Portée d'accès et accès aux modules : attribuer Journaux d'audit à un rôle personnalisé
• Door & Gate Access : Journaux d'accès : l'enregistrement distinct de chaque tentative de déverrouillage de porte et de portail