Passer au contenu principal
La fonctionnalité journaux en temps réel des Actions affiche en temps réel tous les journaux du code personnalisé de votre compte. Cela comprend toute la sortie de console.log ainsi que les exceptions. Ces journaux sont utiles pour déboguer vos Actions, vos scripts de base de données personnalisés et vos connexions sociales personnalisées.
Lorsque vous utilisez les journaux en temps réel des Actions, faites preuve de prudence si vous consignez des renseignements sensibles. Par exemple, les paramètres que les fonctions reçoivent en entrée pour les Actions, les scripts de base de données personnalisés ou les connexions sociales personnalisées peuvent contenir des renseignements sensibles, explicites ou implicites. Le fait de consigner des objets complets peut entraîner la divulgation de renseignements sensibles dans les journaux en temps réel.Auth0 déconseille fortement ce type de pratique. Nous vous recommandons de bien connaître les objets que vous consignez, de vous assurer qu’aucun renseignement sensible n’est consigné et d’éviter de consigner explicitement tout type de renseignement sensible.

Comment utiliser

Pour afficher les journaux en temps réel de votre code personnalisé :
  1. Accédez à Auth0 Dashboard > Monitoring > Actions Logs.
  2. Attendez que la connexion au flux soit établie. Les tentatives de connexion se font automatiquement.
  3. Une fois la connexion établie, les entrées de journal s’affichent dans le panneau principal au fur et à mesure qu’elles se produisent.
Journaux Actions en temps réel dans Auth0 Dashboard

Fonctionnalités

Le panneau des journaux en temps réel d’Actions vous permet de surveiller l’activité du système en direct. Il fournit un retour en temps réel sur les Actions exécutées depuis le tableau de bord, ce qui facilite l’identification des problèmes, la confirmation du bon déroulement des opérations ou simplement l’observation du comportement du système. Consultez ci-dessous la liste détaillée des capacités actuellement offertes par cette fonctionnalité.

Diffusion en direct des journaux

Les entrées de journal sont diffusées en direct au fur et à mesure qu’elles sont générées par Actions. Chaque fois qu’une Action est exécutée, l’entrée de journal correspondante s’affiche automatiquement dans le panneau des journaux, sans qu’il soit nécessaire d’actualiser la page.

État de la connexion

Le haut 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 comprennent :
ÉtatDescription
Connexion au flux de journaux…Tentative d’établir une connexion.
CONNECTEDConnexion établie avec succès et réception des journaux en cours.
DISCONNECTEDAucune connexion au flux pour le moment.

Fonction de recherche

Utilisez la barre de recherche en haut du panneau pour filtrer les entrées du journal. Vous pouvez faire une recherche par :
  • Mots-clés ou expressions
  • Codes d’erreur précis
  • Messages du journal exacts
C’est particulièrement utile lorsque vous parcourez un grand volume de journaux pour trouver une Action ou un problème précis.
Cliquez sur le menu Options dans le coin supérieur droit du panneau des journaux pour accéder à des commandes supplémentaires.
  • Heure locale : Permet d’alterner l’affichage de 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écharger : Permet de télécharger les journaux actuellement affichés sous forme de fichier JSON pour les analyser hors ligne, les partager ou les archiver.
  • Effacer les journaux : Efface toutes les entrées de journal actuellement visibles dans la fenêtre d’affichage. Cela ne supprime pas les journaux du stockage système, seulement la vue actuelle.

Faire défiler jusqu’en bas

Lorsque de nouvelles entrées arrivent et ne sont plus visibles, un bouton Faire défiler jusqu’en bas apparaît dans le panneau des journaux. En cliquant dessus, vous accédez directement à l’entrée de journal la plus récente, ce qui vous permet de rester à jour avec l’activité la plus récente.

Déboguer une Action

L’exemple suivant explique comment créer une Action Hello World générique, l’exécuter et utiliser les journaux en temps réel des Actions pour en voir les résultats.
  1. Suivez les instructions de Créer votre première Action pour rédiger une Action Post Login à l’aide de l’exemple de code ci-dessous :
    /**
    * Gestionnaire appelé pendant l’exécution d’un flux PostLogin.
    *
    * @param {Event} event - Détails sur l’utilisateur et le contexte dans lequel il se connecte.
    * @param {PostLoginAPI} api - 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 invoqué lorsque cette action reprend après une redirection externe. Si votre
    * fonction onExecutePostLogin n’effectue pas de redirection, vous pouvez ignorer cette fonction en toute sécurité.
    *
    * @param {Event} event - Détails sur l’utilisateur et le contexte dans lequel il se connecte.
    * @param {PostLoginAPI} api - 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 et accédez à Auth0 Dashboard > Monitoring > Actions Logs
  3. Une fois le flux établi, revenez à votre éditeur d’Action et exécutez un test.
  4. Les résultats devraient apparaître en temps réel dans les journaux en temps réel des Actions.

Instructions de console prises en charge

Le tableau suivant présente les instructions de console JavaScript prises en charge par la fonctionnalité de journalisation en temps réel :
InstructionDescriptionCas d’utilisation
console.log()Journalisation générale d’information.Messages d’information de base, valeurs de variables.
console.info()Messages d’information mettant en évidence la progression ou l’état de l’application.Signalement d’opérations réussies, jalons de l’application.
console.warn()Indique des problèmes potentiels ou des situations inattendues qui ne constituent pas des erreurs critiques.Signalement de problèmes non critiques, fonctionnalités obsolètes.
console.error()Signale les erreurs survenues dans l’application.Indication des échecs, des exceptions et des problèmes critiques.
console.trace()Affiche une trace de la pile d’appels, montrant la séquence des appels de fonction menant au point actuel.Débogage des flux d’appels complexes, compréhension de l’origine des problèmes.

Dépannage

Si vous rencontrez des problèmes de connectivité avec les journaux en temps réel d’Actions, consultez notre section de dépannage.

En savoir plus