Journaux en temps réel des actions

Apprendre comment utiliser les journaux en temps réel des actions Auth0

La fonctionnalité Journaux en temps réel des actions affiche tous les journaux en temps réel pour le code personnalisé de votre compte. Cela inclut toutes les sorties de console.log et les exceptions. Ces journaux sont utiles pour le débogage de vos actions, de vos scripts de base de données personnalisés et de vos connexions via réseaux sociaux personnalisées.

Lorsque vous utilisez les Journaux en temps réel des actions, soyez prudent quant à la journalisation d’informations sensibles. Par exemple, les fonctions de paramètres reçues en entrée pour les actions, les scripts de base de données personnalisés ou les connexions via réseaux sociaux personnalisées peuvent contenir des informations sensibles, explicites ou implicites. La journalisation d’objets complets peut entraîner la divulgation d’informations sensibles dans les journaux en temps réel.

Auth0 déconseille fortement ces pratiques. Nous vous recommandons de prendre connaissance des objets que vous journalisez et de vous assurer qu’aucune information sensible n’y figure, ainsi que d’éviter de journaliser explicitement toute information sensible.

​

Comment les utiliser

Pour consulter les journaux en temps réel de votre code personnalisé :

1. Rendez-vous à Auth0 Dashboard > Surveillance > Journaux des actions.
2. Veuillez patienter jusqu’à ce que le flux soit connecté. La connexion s’effectue automatiquement.
3. Une fois la connexion établie, les entrées du journal s’affichent dans le panneau principal au moment où elles ont lieu.

​

Fonctionnalités

Le panneau des journaux en temps réel des actions vous permet de surveiller l’activité du système en direct. Il fournit un retour d’information instantané sur les actions exécutées via le tableau de bord, facilitant ainsi l’identification des problèmes, la confirmation du bon déroulement des opérations ou simplement l’observation du système en temps réel. Vous trouverez ci-dessous une liste détaillée des fonctionnalités actuellement proposées.

​

Exportation des journaux en temps réel

Les entrées du journal sont exportées en direct au fur et à mesure de leur génération par les actions. Chaque action exécutée génère automatiquement l’entrée correspondante dans le panneau de journaux, sans qu’il soit nécessaire d’actualiser la page.

​

État de la connexion

La partie supérieure du panneau affiche l’état actuel de la connexion entre votre navigateur et le flux de journaux. Cela vous permet de vérifier si les journaux sont bien reçus. Les états courants sont les suivants :

État	Description
Connexion au flux de journaux…	Tentative de connexion.
CONNECTÉ	Connexion avec succès et réception de journaux.
DÉCONNECTÉ	Présentement déconnecté du flux de journaux.

​

Fonctionnalité de recherche

Utilisez la barre de recherche en haut du panneau pour filtrer les entrées du journal. Vous pouvez effectuer une recherche par :

• Mots clés ou expressions
• Codes d’erreur précis
• Messages de journaux exacts

Ceci est particulièrement utile lors de l’analyse de grands volumes de journaux pour une action ou un problème particulier.

​

Menu Options (…)

Cliquez sur le menu Options dans le coin supérieur droit du panneau de journaux pour accéder aux autres commandes.

• **Heure locale :**permet d’afficher l’horodatage des entrées de journal entre l’heure par défaut du serveur (souvent UTC) et l’heure locale du navigateur de l’utilisateur.
• **Téléchargement :**permet de télécharger les journaux actuellement affichés sous forme de fichier JSON pour une analyse hors ligne, un partage ou un archivage.
• **Supprimer les journaux :**supprime toutes les entrées de journal actuellement visibles dans la fenêtre. Cette action ne supprime pas les journaux du stockage du système, mais uniquement ceux affichés dans la fenêtre.

​

Défilement vers le bas

Lorsque de nouvelles entrées sont ajoutées et ne sont plus visibles, un bouton Défilement vers le bas s’affiche dans le panneau de journaux. En cliquant dessus, vous pourrez accéder à l’entrée la plus récente et rester ainsi au courant des dernières activités.

​

Déboguer une action

L’exemple suivant décrit comment créer une action générique « Hello World », l’exécuter et utiliser les journaux en temps réel des actions pour voir les résultats.

1. Suivez les instructions pour Écrire votre première action afin d’écrire une action après la connexion en utilisant l’exemple de code ci-dessous :

   /**
   * Gestionnaire qui sera appelé lors de l’exécution d’un flux PostLogin.
   *
   * Événement @param {Event} – Détails sur l’utilisateur et contexte dans lequel il se connecte.
   * API @param {PostLoginAPI} – Interface dont les méthodes peuvent être utilisées pour modifier le comportement de la connexion.
   */
   exports.onExecutePostLogin = async (event, api) => {
     console.log('Hello World!');
   };
   
   /**
   * Gestionnaire qui sera appelé lorsque cette action reprendra après une redirection externe. Si votre
   * fonction onExecutePostLogin n’effectue pas de redirection, cette fonction peut être ignorée complètement.
   *
   * Événement @param {Event} – Détails sur l’utilisateur et contexte dans lequel il se connecte.
   * API @param {PostLoginAPI} – Interface dont les méthodes peuvent être utilisées pour modifier le comportement de la connexion.
   */
   // exports.onContinuePostLogin = async (event, api) => {
   // };
   

2. Ouvrez un nouvel onglet, puis rendez-vous à Auth0 Dashboard > Surveillance > Journaux d’actions

3. Une fois le flux connecté, passez à votre éditeur d’actions et exécutez un test.

4. Vos résultats devraient s’afficher en temps réel dans vos Journaux en temps réel des actions.

​

Énoncés pris en charge

Le tableau suivant répertorie les instructions de la console JavaScript prises en charge par la fonctionnalité de journalisation en temps réel :

Énoncé	Description	Cas d’utilisation
console.log()	Journalisation générale de l’information.	Messages d’information de base, valeurs des variables.
console.info()	Messages d’information indiquant le progrès ou l’état de l’application.	Rapports sur les opérations réussies, les étapes importantes de l’application.
console.warn()	Indique des problématiques potentielles ou des situations imprévues qui ne constituent pas des erreurs critiques.	Signaler les problèmes non critiques et les fonctionnalités obsolètes.
console.error()	Signale les erreurs qui se sont produites dans l’application.	Signale les échecs, les exceptions et les problématiques critiques.
console.trace()	Affiche un rapport des appels de procédure, indiquant la séquence d’appels de fonction menant au point actuel.	Utilisé pour déboguer des flux d’appels complexes et comprendre l’origine des problèmes.

​

En savoir plus

• Comprendre le fonctionnement des Auth0 Actions
• Programmer votre première action
• Explorer les déclencheurs