Rechercher des entrées de journal avec des groupes d'erreurs
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 journaux 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 Rapports d'erreurs 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 _.
Pour interroger un groupe d'erreurs spécifique :
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 panneau Exemples récents, cliquez sur Afficher les journaux à partir de n'importe quelle entrée de journal pour être redirigé vers la page Explorateur de journaux.
Dans l'explorateur de journaux, le champ de l'éditeur de requête est renseigné avec le champ d'ID error_groups. Par exemple, errorGroups.id="CJqhkd7Qvsbj2QE".
La liste des entrées de journal contribuant à ce groupe d'erreurs s'affiche dans le volet Résultats de la requête.
Pour interroger les entrées de journal appartenant à un groupe d'erreurs et trouver les détails du groupe d'erreurs, procédez comme suit :
Dans la console Google Cloud , accédez à la page 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.
Pour afficher les entrées de journal associées à un groupe d'erreurs, saisissez le filtre suivant dans le champ de l'éditeur de requête :
errorGroups.id:*
Dans le volet Résultats de la requête, sélectionnez une entrée de journal qui affiche le bouton Groupe d'erreurs.
Cliquez sur le bouton Groupe d'erreurs, puis sélectionnez Afficher les détails du groupe d'erreurs :
Par exemple, la capture d'écran suivante montre deux entrées de journal avec un niveau de gravité au moins égal à "Erreur".
L'une de ces entrées est annotée avec le bouton Groupe d'erreurs. La capture d'écran suivante illustre également les options disponibles avec ce bouton :
Après avoir sélectionné Afficher les détails du groupe d'erreurs, la page Rapports d'erreurs s'ouvre et affiche des informations sur le 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 les gérer. 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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/05 (UTC)."],[],[],null,["# Find log entries with error groups\n\nThis document describes how to find, filter, and exclude log entries that are\npart of error groups when using the Logs Explorer.\n[Error groups](/error-reporting/docs/grouping-errors)\nhelp you identify trends and recurring problems in your environment by grouping\nlog entries that have errors by values such\nas exception type, frames, or messages.\n\nFind error group details for a log entry\n----------------------------------------\n\nTo track recurring errors across your application and to manage their resolution\nstatus, use the **Error Reporting** page of the Google Cloud console.\nThe **Error Reporting** page lists error groups, including\ninformation about the specific type of error, the number of error occurrences,\nand the resolution status of each group.\n\nError Reporting automatically sets the value of the\n`error_groups` ID field during the creation of an error group. The field\ncontains alphanumeric characters, `-` and `_`.\n\nTo query for a specific error group, do the following:\n\n1. In the Google Cloud console, go to the **Error Reporting** page:\n\n [Go to **Error Reporting**](https://console.cloud.google.com/errors)\n\n \u003cbr /\u003e\n\n You can also find this page by using the search bar.\n2. Click the error name.\n3. In the **Recent samples** panel, click **View Logs** from any log entry to redirect you to the **Logs Explorer** page.\n4. In the **Logs Explorer** , the query-editor field is populated with the\n `error_groups` ID field. For example, `errorGroups.id=\"CJqhkd7Qvsbj2QE\"`.\n\n The list of log entries contributing to that error group is shown in the\n **Query results** pane.\n\nTo query for log entries that belong to any error group and to find the error\ngroup details, do the following:\n\n1. In the Google Cloud console, go to the **Logs Explorer** page:\n\n [Go to **Logs Explorer**](https://console.cloud.google.com/logs/query)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Logging**.\n2. To view log entries associated with any error group, enter the following\n filter into the query-editor field:\n\n errorGroups.id:*\n\n3. In the **Query results** pane, select a log entry that displays the\n **Error group** button.\n\n4. Click the **Error group** button and\n select **View error group details**:\n\n For example, the following screenshot shows two log entries with a\n severity level of at least error.\n One of these entries is annotated with the\n **Error group** button. The following screenshot also illustrates the\n options available with this button:\n\n After you select **View error group details** , the **Error reporting**\n page opens and displays information about the error group.\n\nYou can also use the options in the\n**Error group** button to change which log entries the Logs Explorer\ndisplays:\n\n- To investigate the error group in more detail, select\n **Show entries in this error group**. Logs Explorer is refreshed and\n displays only those log entries in the same error group. You can now apply\n additional query parameters to the error group's log entries.\n\n- To remove a specific error group from your query results,\n select **Hide entries in this error group**. Logs Explorer is refreshed\n and all log entries in this error group are hidden from the display.\n\nMonitor error groups\n--------------------\n\nYou can configure Error Reporting to notify you when it detects a\nnew error group. This service also lets you view the history of errors for\neach error group and to manage those errors. For more information,\nsee the following documents:\n\n- [Configure and manage notifications](/error-reporting/docs/notifications)\n- [View and filter errors](/error-reporting/docs/viewing-errors)\n\nYou can't create log-based metrics that count the number of log entries with\nerror groups or configure a log-based alert to notify you when a log entry\ncontains an error group. Similarly, you can't extract values from the\n`errorGroups` field into a label attached to a log-based metric or\nlog-based alert."]]
Groupe d'erreurs.