Lire une entrée de journal

Sur cette page

Cliquez sur une requête dans la liste de l'onglet Logs pour ouvrir ses détails à droite. Les détails indiquent quand la requête a été effectuée, par qui et d'où, ce qui a été envoyé et ce qui a été renvoyé. Pour une requête en échec, vous pouvez aussi demander un résumé de l'erreur en langage clair.

Référence rapide

Où le trouver : Paramètres (icône en forme d'engrenage, en bas à gauche) → Journaux d'audit → Logs, puis cliquez sur une requête

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

Objectif : voir exactement ce qui s'est passé lors d'une requête

Ouvrir une entrée de journal

  1. Dans l'onglet Logs, filtrez la liste pour afficher les requêtes dont vous avez besoin.
  2. Cliquez sur une requête. Ses détails s'ouvrent à droite et la requête est mise en surbrillance dans la liste.
  3. Utilisez les touches fléchées haut et bas pour parcourir la liste sans quitter les détails.

Le haut des détails reprend le statut, la méthode, le badge de source et l'endpoint.

Les détails d'une entrée de journal : horodatage, temps de réponse, ID de requête, adresse IP, utilisateur, référent, agent utilisateur, installation et organisation, puis les corps de la requête et de la réponseLes détails d'une entrée de journal : horodatage, temps de réponse, ID de requête, adresse IP, utilisateur, référent, agent utilisateur, installation et organisation, puis les corps de la requête et de la réponse

Figure 1 : Une entrée de journal : quand elle a eu lieu, qui l'a effectuée, d'où elle provient, ainsi que les corps de la requête et de la réponse

Les champs

Les champs sont affichés en majuscules dans le Performance Hub, dans cet ordre :

ChampCe qu'il indique
TimestampLa date et l'heure de la requête
Response TimeLe temps de réponse du Performance Hub, en millisecondes
Request IDUn identifiant unique pour cette requête. Cliquez sur le bouton de copie pour le copier, par exemple pour le communiquer au support.
IP AddressL'adresse IP d'où provient la requête
UserL'adresse e-mail de la personne qui a effectué la requête
RefererLa page depuis laquelle la requête a été effectuée, le cas échéant
User AgentLe navigateur, l'application ou l'outil qui a envoyé la requête
InstallationL'installation visée par la requête, sous la forme « Nom (id) », par exemple Lower Manhattan et son ID d'installation
OrganisationL'organisation, sous la forme « Nom (id) »

Requête et réponse

Sous les champs figurent les corps de la requête, le cas échéant :

SectionCe qu'elle indique
Request POST BodyCe qui a été envoyé, par exemple le motif donné pour le déverrouillage d'une porte ou les nouveaux horaires d'une installation. L'en-tête indique « Request POST Body » pour toutes les méthodes qui envoient un corps.
Response BodyCe que le Performance Hub a renvoyé, y compris tout message d'erreur
Query ParametersLes options ajoutées à la requête, comme un numéro de page ou une installation

Cliquez sur Copy section (l'icône de copie en haut à droite d'une section) pour copier son contenu, par exemple pour le coller dans une demande d'assistance.

Si une requête n'a rien à afficher, les détails indiquent « No request/response payloads recorded for this entry. » De nombreuses requêtes GET, qui ne font que lire des informations, n'ont pas de corps de requête.

Résumé des erreurs IA

Pour une requête en échec, dont le statut est 400 ou supérieur, les détails comprennent une section AI Error Summary.

  1. Cliquez sur Generate summary.
  2. Lisez le résumé. Il explique en langage clair ce qui n'a pas fonctionné et ce qu'il faut faire ensuite.

Le résumé AI Error Summary d'une requête 403, expliquant que la personne qui effectuait la modification n'avait pas l'autorisation d'attribuer le rôleLe résumé AI Error Summary d'une requête 403, expliquant que la personne qui effectuait la modification n'avait pas l'autorisation d'attribuer le rôle

Figure 2 : Pour une requête en échec, Generate summary explique l'erreur en langage clair

  • Le résumé n'est généré que lorsque vous cliquez sur Generate summary. Une fois un résumé généré, il peut afficher une étiquette cached.
  • Il est généré par l'IA et peut être erroné. Comparez-le au Response Body, qui contient le message réellement renvoyé par le Performance Hub.
  • Si le résumé ne peut pas être généré, un avertissement vous invite à réessayer plus tard. En attendant, lisez le Response Body.

Après 7 jours : aperçus

Les corps complets des requêtes et des réponses sont conservés 7 jours. Ensuite, les corps les plus longs sont réduits à un court aperçu, et les détails indiquent « Full request and response payloads are kept for 7 days. Showing a preview for this log. » Les corps courts qui tiennent dans l'aperçu sont conservés en entier.

Le reste de l'entrée de journal, comme l'auteur de la requête, sa date et son résultat, est conservé 90 jours.

Une entrée de journal de plus de 7 jours, avec l'avis d'aperçu et des corps de requête et de réponse raccourcisUne entrée de journal de plus de 7 jours, avec l'avis d'aperçu et des corps de requête et de réponse raccourcis

Figure 3 : Après 7 jours, seul un court aperçu de la requête et de la réponse subsiste

Si vous risquez d'avoir besoin des corps complets plus tard, ouvrez la requête et utilisez Copy section dans les 7 jours. Un export CSV n'inclut pas les corps.

Codes de statut

Le statut est le premier élément de chaque ligne. Son premier chiffre indique le type de résultat :

StatutSignificationExemples
2xxRéussite200 OK, 201 Created
3xxRedirection : la requête a été envoyée ailleurs301 Moved
4xxUn problème lié à la requête, par exemple une absence d'autorisation ou une saisie non valide400 Bad Request (une valeur n'était pas valide), 401 Unauthorised (non connecté), 403 Forbidden (aucune autorisation), 404 Not Found, 409 Conflict (la requête entrait en conflit avec l'état actuel, comme une porte en mode maintenance), 429 Too Many Requests (trop de requêtes en peu de temps)
5xxUne erreur du serveur500 Server Error, 502 Bad Gateway, 503 Service Unavailable

Badges de source

Chaque requête comporte un badge de source qui indique sa provenance :

BadgeProvenance de la requête
webUne personne qui utilise le Performance Hub dans un navigateur ou l'application
api-keyUne intégration qui utilise une clé API, comme un système de réservation ou de gestion des membres. Consultez Authentification de la Partner API.
mcpUn agent IA ou un client IA connecté via MCP. Consultez Utilisation avec l'IA.
model-routerLe Model Router
websocketUne connexion en direct, comme une mise à jour en temps réel
guest-tokenUn lien invité

D'autres badges peuvent apparaître.