Logo Performance HubPerformance Hub
Section du site : Documentation

Rechercher des requêtes

Sur cette page

L'onglet Logs répertorie les requêtes effectuées dans votre organisation, des plus récentes aux plus anciennes. Utilisez les filtres en haut de la page pour limiter la liste à une personne, une adresse IP, une partie du Performance Hub ou un type de résultat, puis cliquez sur une requête pour en afficher les détails.

Référence rapide

Où le trouver : Paramètres (icône en forme d'engrenage, en bas à gauche) → Journaux d'audit → Logs

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 : trouver les requêtes à l'origine d'une question, par exemple qui a modifié un élément ou pourquoi une action a échoué

L'onglet Logs, avec la barre de filtres en haut, une liste de requêtes à gauche et les détails de la requête sélectionnée à droiteL'onglet Logs, avec la barre de filtres en haut, une liste de requêtes à gauche et les détails de la requête sélectionnée à droite

Figure 1 : L'onglet Logs : les filtres en haut, les requêtes correspondantes à gauche et la requête sélectionnée à droite

L'onglet Logs

  • Barre de filtres : les filtres en haut de la page, avec Live, le bouton d'actualisation et Exporter au format CSV à droite.
  • Liste : les requêtes correspondantes, des plus récentes aux plus anciennes. Au-dessus figure la mention « Viewing logs for 1 organisation » (ou le nombre d'organisations que vous pouvez consulter). Chaque ligne indique le code de statut, la méthode, le badge de source, la date et l'heure, l'endpoint, l'adresse e-mail de l'utilisateur et le temps de réponse en millisecondes.
  • Détails : la requête que vous avez sélectionnée. Consultez Lire une entrée de journal.

La liste charge d'autres requêtes à mesure que vous faites défiler la page. À la fin de la liste, elle indique le nombre de requêtes correspondantes, par exemple « End of results · 5 logs ».

Filtrer la liste

  1. Cliquez sur un filtre dans la barre de filtres, par exemple Endpoint.
  2. Choisissez une option ou saisissez une valeur. Par exemple, saisissez /api/door-gate-access/* dans Endpoint et cliquez sur Apply.
  3. Le filtre affiche la valeur choisie et la liste se met à jour. Ajoutez d'autres filtres pour affiner davantage la liste : une requête doit correspondre à tous les filtres pour apparaître.
  4. Pour supprimer un filtre, cliquez sur le × qui y figure. Pour les supprimer tous, cliquez sur Clear, qui apparaît dès qu'un filtre est défini.

La barre de filtres : Range, Email, IP, Endpoint, Org, Facility, Method et Status, puis Live, le bouton d'actualisation et Export CSVLa barre de filtres : Range, Email, IP, Endpoint, Org, Facility, Method et Status, puis Live, le bouton d'actualisation et Export CSV

Figure 2 : La barre de filtres : Range, Email, IP, Endpoint, Org, Facility, Method et Status, puis Live, le bouton d'actualisation et Export CSV

FiltreCe qu'il recherche
RangeL'heure à laquelle la requête a été effectuée. La valeur par défaut est Last 24 hours. Consultez Range.
EmailL'adresse e-mail complète de l'utilisateur, par exemple priya.shah@example.com. Des adresses peuvent vous être suggérées pendant la saisie.
IPL'adresse IP complète d'où provient la requête, par exemple 203.0.113.140
EndpointLa partie du Performance Hub visée par la requête. N'importe quelle partie du chemin correspond, et vous pouvez utiliser le caractère générique *. Consultez Endpoint et caractères génériques.
OrgUne organisation, ou Any org. Affiché lorsque vous avez accès à au moins une organisation.
InstallationUne installation, ou Any facility. Affiché lorsque vous avez accès à au moins une installation.
MethodGET, POST, PUT, PATCH ou DELETE
StatusLe statut de la réponse. Consultez Status.

Email et IP nécessitent la valeur complète

Email et IP ne trouvent que les correspondances exactes. Saisissez l'adresse e-mail complète, comme ruby.castellano@example.com, ou l'adresse IP complète. Une partie d'adresse, comme ruby ou 203.0.113, ne trouve rien.

Pour trouver une personne sans connaître son adresse complète, utilisez Top Users sur le tableau de bord, ou ouvrez l'une de ses requêtes et copiez l'adresse depuis le champ User.

Plage

Cliquez sur Range pour choisir jusqu'où remonter dans le temps.

  • Préréglages : Last 15 minutes, Last hour, Last 12 hours, Last 24 hours, Last 7 days, Last 30 days et Last 90 days.
  • Dates : choisissez une date de début et une date de fin dans le calendrier de deux mois, puis cliquez sur Apply. Cliquez sur Cancel pour fermer le menu sans modifier la période. Les dates antérieures à 90 jours ne peuvent pas être sélectionnées.

La note en bas du menu indique la durée de conservation des journaux : « Audit logs are kept for 90 days. Full request and response payloads are kept for 7 days, after which a short preview remains. Need a longer history? Contact Support (additional charges apply). »

Le menu Range ouvert, avec les préréglages de Last 15 minutes à Last 90 days, un calendrier de deux mois et la note sur la durée de conservation des journauxLe menu Range ouvert, avec les préréglages de Last 15 minutes à Last 90 days, un calendrier de deux mois et la note sur la durée de conservation des journaux

Figure 3 : Range : choisissez un préréglage ou des dates dans le calendrier. La note indique la durée de conservation des journaux

Endpoint et caractères génériques

L'endpoint est le chemin vers lequel la requête a été envoyée, comme /api/door-gate-access/doors/front-entrance/unlock. Il indique la partie du Performance Hub visée par la requête.

  • Sans *, n'importe quelle partie du chemin correspond. Par exemple, unlock trouve toutes les requêtes dont le chemin contient « unlock ».
  • Avec *, chaque fragment situé entre les astérisques doit figurer dans le chemin. Par exemple, /api/door-gate-access/* trouve toutes les requêtes Door & Gate Access, et /partner/v1/* trouve toutes les requêtes provenant d'une intégration qui utilise la Partner API.

Le filtre Endpoint ouvert, avec /api/door-gate-access/* saisi et les boutons Cancel et ApplyLe filtre Endpoint ouvert, avec /api/door-gate-access/* saisi et les boutons Cancel et Apply

Figure 4 : Endpoint accepte le caractère générique *, par exemple pour toutes les requêtes de porte

L'onglet Logs filtré sur /api/door-gate-access/*, avec cinq requêtes de porte et la première ouverteL'onglet Logs filtré sur /api/door-gate-access/*, avec cinq requêtes de porte et la première ouverte

Figure 5 : La liste après un filtrage par modèle d'endpoint

Vous ne savez pas quel endpoint utiliser ? Ouvrez une requête que vous connaissez, comme une porte que vous avez vous-même déverrouillée, et copiez le début de son endpoint depuis les détails.

Statut

Cliquez sur Status pour filtrer selon le statut de la réponse. Saisissez du texte dans Search… pour trouver rapidement un statut, par exemple « 403 ». Choisissez Any pour afficher tous les statuts.

Les statuts sont répertoriés avec leur nom, comme 200 OK, 201 Created, 400 Bad Request, 401 Unauthorised, 403 Forbidden, 404 Not Found, 409 Conflict, 429 Too Many Requests, 500 Server Error et 503 Service Unavailable. Consultez Codes de statut pour connaître leur signification.

Le menu Status ouvert, avec un champ de recherche, Any et les statuts de 200 OK à 401 UnauthorisedLe menu Status ouvert, avec un champ de recherche, Any et les statuts de 200 OK à 401 Unauthorised

Figure 6 : Filtrer par statut de réponse

Live et actualisation

Dans l'onglet Logs, Live est défini sur Off par défaut, afin que la liste reste figée pendant votre enquête. Activez-le et choisissez la fréquence d'actualisation de la liste pour voir arriver les nouvelles requêtes. Cliquez sur le bouton d'actualisation (les flèches circulaires) pour recharger la liste une seule fois.

Partager une vue filtrée ou l'ajouter aux favoris

Vos filtres sont enregistrés dans l'adresse de la page. Ajoutez la page à vos favoris pour revenir à la même vue, ou envoyez l'adresse à un collègue. Il verra la même liste filtrée s'il a accès aux Journaux d'audit et à la même organisation.

Par exemple, une adresse se terminant par /audit-logs/logs?email=priya.shah%40example.com ouvre la liste filtrée sur cette personne, et une adresse se terminant par /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F* ouvre toutes les requêtes de porte.

Parcourir la liste

  • Cliquez sur une requête pour ouvrir ses détails à droite.
  • Utilisez les touches fléchées haut et bas pour passer à la requête précédente ou suivante de la liste.
  • Sur un écran étroit, les détails s'ouvrent par-dessus la liste. Cliquez sur le bouton de fermeture pour revenir à la liste.

Aucun résultat

Si rien ne correspond, la liste affiche « No logs match these filters » et « Try widening the time range or clearing a filter. »

L'onglet Logs avec un filtre Email défini, affichant No logs match these filtersL'onglet Logs avec un filtre Email défini, affichant No logs match these filters

Figure 7 : Aucune requête ne correspond : élargissez la période ou supprimez un filtre

Pour trouver ce que vous cherchez :

  • Choisissez une Range plus longue, comme Last 7 days.
  • Vérifiez que Email et IP contiennent l'adresse complète. Une partie d'adresse ne trouve rien.
  • Supprimez les filtres un par un avec leur ×, ou cliquez sur Clear.