Ce document explique comment rechercher, filtrer et exclure les entrées de journal qui font partie de groupes d'erreurs lorsque vous utilisez l'explorateur de journaux. Les groupes d'erreurs vous aident à identifier les tendances et les problèmes récurrents dans votre environnement en regroupant les entrées de journal comportant des erreurs par valeurs telles que le type d'exception, les frames ou les messages.
Afficher les détails d'un groupe d'erreurs pour une entrée de journal
Pour suivre les erreurs récurrentes dans votre application et gérer leur état de résolution, utilisez la page Error Reporting de la console Google Cloud . La page Error Reporting liste les groupes d'erreurs, y compris des informations sur le type d'erreur spécifique, le nombre d'occurrences d'erreur et l'état de résolution de chaque groupe.
Error Reporting définit automatiquement la valeur du champ d'ID error_groups lors de la création d'un groupe d'erreurs. Le champ contient des caractères alphanumériques, - et _.
Dans Error Reporting, recherchez les entrées de journal d'un groupe d'erreurs.
Si vous consultez la page "Error Reporting" et que vous souhaitez trouver les entrées de journal associées à un groupe d'erreurs spécifique, procédez comme suit :
-
Dans la console Google Cloud , accédez à la page Rapports d'erreurs :
Vous pouvez également accéder à cette page à l'aide de la barre de recherche.
- Cliquez sur le nom de l'erreur.
Dans le volet Exemples récents, cliquez sur Afficher les journaux à partir de n'importe quelle entrée de journal.
La page Explorateur de journaux s'ouvre et affiche les entrées de journal associées au groupe d'erreurs. Le champ de l'éditeur de requête spécifie l'ID du groupe d'erreurs. Par exemple, ce champ peut inclure
errorGroups.id="ERROR_GROUP_ID", où ERROR_GROUP_ID est l'ID de votre groupe d'erreurs.
Filtrer les entrées de journal par groupe d'erreurs
Si vous consultez la page de l'explorateur de journaux et que vous souhaitez trouver des entrées de journal associées à une erreur spécifique ou à un groupe d'erreurs, procédez comme suit :
-
Dans la console Google Cloud , accédez à la pageExplorateur de journaux :
Accéder à l'explorateur de journaux
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.
Effectuez l'une des opérations suivantes :
Pour trouver les entrées de journal associées à un groupe d'erreurs, ajoutez ce qui suit au volet de requête :
errorGroups.id:*Pour trouver les entrées de journal associées à un groupe d'erreurs spécifique, ajoutez les éléments suivants au volet de requête :
errorGroups.id: "ERROR_GROUP_ID"
Exécutez la requête.
Examiner le groupe d'erreurs d'une entrée de journal
Pour ouvrir le groupe d'erreurs d'une entrée de journal, sélectionnez
Groupe d'erreurs, puis sélectionnez
Afficher les détails du groupe d'erreurs :
Vous pouvez également utiliser les options du bouton Groupe d'erreurs pour modifier les entrées de journal affichées par l'explorateur de journaux :
Pour examiner plus en détail le groupe d'erreurs, sélectionnez Afficher les entrées de ce groupe d'erreurs. L'explorateur de journaux est actualisé et n'affiche que les entrées de journal du même groupe d'erreurs. Vous pouvez désormais appliquer des paramètres de requête supplémentaires aux entrées de journal du groupe d'erreurs.
Pour supprimer un groupe d'erreurs spécifique des résultats de votre requête, sélectionnez Masquer les entrées dans ce groupe d'erreurs. L'explorateur de journaux est actualisé et toutes les entrées de journal de ce groupe d'erreurs sont masquées.
Surveiller les groupes d'erreurs
Vous pouvez configurer Error Reporting pour vous avertir lorsqu'il détecte un nouveau groupe d'erreurs. Ce service vous permet également d'afficher l'historique des erreurs pour chaque groupe d'erreurs et de gérer ces erreurs. Pour en savoir plus, consultez les documents suivants :
Vous ne pouvez pas créer de métriques basées sur les journaux qui comptent le nombre d'entrées de journal avec des groupes d'erreurs ni configurer d'alerte basée sur les journaux pour vous avertir lorsqu'une entrée de journal contient un groupe d'erreurs. De même, vous ne pouvez pas extraire de valeurs du champ errorGroups dans un libellé associé à une métrique ou une alerte basées sur les journaux.