Vous pouvez utiliser l'explorateur de journaux pour rechercher, filtrer et exclure les entrées de journal appartenant à des groupes d'erreurs afin d'identifier les tendances et les problèmes récurrents dans votre environnement. Les groupes d'erreurs regroupent les entrées de journal contenant des erreurs en fonction de valeurs partagées, telles que le type d'exception, les frames ou les messages.
Rechercher 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 _.
Rechercher les entrées de journal d'un groupe d'erreurs à partir d'Error Reporting
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 Error Reporting :
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 une valeur telle que
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 rechercher les entrées de journal associées à un groupe d'erreurs, ajoutez ce qui suit au volet de requête :
errorGroups.id:*Pour rechercher les entrées de journal associées à un groupe d'erreurs spécifique, ajoutez ce qui suit 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 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 le groupe d'erreurs plus en détail, 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 maintenant 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 qu'il vous avertisse 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 une 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 les valeurs du champ errorGroups dans un libellé associé à une métrique basée sur les journaux ou à une alerte basée sur les journaux.