Gérer les erreurs

Cette page explique comment gérer les erreurs dans Error Reporting.

Pour consulter les erreurs, ouvrez la page Error Reporting dans Cloud Console. Une liste de groupes d'erreurs survenues récemment s'affiche, par ordre de fréquence :

Interface utilisateur affichant la liste des erreurs.

Astuce : Traitez cette liste comme une boîte de réception. Réorganisez-la régulièrement en corrigeant les erreurs sous-jacentes et/ou en masquant les erreurs attendues et récurrentes.

Pour en savoir plus sur l'affichage et le filtrage dans votre liste Error Reporting, consultez la page Afficher les erreurs.

Pour en savoir plus sur les autorisations nécessaires pour gérer les erreurs, consultez le guide de contrôle des accès.

Exemples d'erreurs

Les erreurs regroupées sont généralement très similaires. Par conséquent, Error Reporting ne conserve que 1 000 échantillons et extrapole les informations restantes. Pour conserver toutes les occurrences d'une erreur, vous pouvez exporter vos journaux vers BigQuery afin que les futures occurrences de l'erreur soient enregistrées.

Pour chaque exemple, l'interface utilisateur affiche les données que votre application envoie à Error Reporting. Par exemple, l'environnement standard App Engine fournit des métadonnées utiles telles que le user-agent et l'URL de la requête qui a provoqué l'erreur. Si vous envoyez vos propres rapports d'erreurs en tant qu'entrées de journal, vérifiez la liste des champs que vous pouvez fournir. Si vous utilisez l'API Error Reporting, reportez-vous à l'objet ReportedErrorEvent.

Pour en savoir plus, consultez la page Regroupement des erreurs.

Modifier l'état de résolution

Pour gérer votre flux de travail, vous pouvez modifier l'état de résolution de vos groupes d'erreurs en procédant comme suit :

  1. Accédez à la page Opérations > Error Reporting dans Cloud Console :

    Accéder à la page "Error Reporting"

  2. La colonne Resolution status (État de résolution) s'affiche pour chaque groupe d'erreurs :

    Interface utilisateur indiquant l'état de résolution des erreurs.

  3. Dans le panneau précédent, développez la colonne Resolution Status (État de résolution) pour modifier l'état d'un groupe d'erreurs. Voici la liste des valeurs d'état possibles :

    • Open (Ouvert) : état initial par défaut de tous les groupes d'erreurs. Les autres états sont définis manuellement. Vous pouvez à tout moment rétablir l'état d'un groupe d'erreurs sur Open (Ouvert).
    • Acknowledged (Confirmé) : état indiquant la catégorisation des groupes d'erreurs.
    • Resolved (Résolu) : état indiquant qu'un groupe d'erreurs est résolu et ne devrait plus se produire. Si un groupe d'erreurs marqué comme Resolved (Résolu) se reproduit, Error Reporting rétablit l'état de résolution sur Open (Ouvert).
    • Muted (Ignoré) : état permettant de masquer un groupe d'erreurs de votre liste. Pour en savoir plus, consultez la section Ignorer les erreurs.

Ignorer les erreurs

Pour masquer des groupes d'erreurs de votre liste Error Reporting, définissez leur état de résolution sur Muted (Ignoré). Les erreurs ignorées ne s'affichent pas dans votre liste, même si elles se reproduisent.

Pour afficher vos groupes d'erreurs ignorées (et les réactiver si vous le souhaitez), procédez comme suit :

  1. Cliquez sur Manage muted errors (Gérer les erreurs ignorées) :

    Interface utilisateur affichant le menu des erreurs ignorées.

  2. La page Muted Errors (Erreurs ignorées) s'affiche. Dans la barre de navigation supérieure, développez le panneau Resolution Status (État de résolution). Sélectionnez les types d'état de résolution des groupes d'erreurs que vous souhaitez masquer dans votre liste.

    Interface utilisateur affichant l'option permettant d'ignorer l'état de résolution.

Pour réactiver un groupe d'erreurs, désélectionnez son type d'état de résolution dans le même panneau Resolution Status (État de résolution).

Error Reporting n'envoie pas de notification si l'erreur ignorée se reproduit.

Association à des problèmes

Vous pouvez associer des groupes d'erreurs à des problèmes.

Pour afficher ou modifier un ou plusieurs problèmes associés à un groupe d'erreurs, cliquez sur l'icône de rapport de bug  à côté de chaque ligne de votre liste :

Interface utilisateur affichant l'icône de bug.

Si le groupe d'erreurs n'est pas encore associé à l'URL d'un problème, cliquez sur l'icône de rapport de bug  pour ouvrir le panneau Associer l'URL d'un problème à cette erreur, dans lequel vous pouvez saisir l'URL appropriée.

Si un groupe d'erreurs est déjà associé à une URL dans votre système de suivi des problèmes, cliquez sur l'icône de rapport de bug  pour ouvrir ce lien dans un nouvel onglet du navigateur.

Notifications

Error Reporting peut vous avertir lorsque de nouvelles erreurs se produisent et lorsque des erreurs avec l'état Resolved (Résolu) se reproduisent. Pour en savoir plus, consultez la page Notifications.

Supprimer les erreurs

Vous pouvez supprimer tous les événements d'erreur stockés pour le projet donné et réinitialiser le nombre d'erreurs à zéro à l'aide de l'outil gcloud ou de l'API REST.

gcloud

Pour supprimer tous les événements d'erreur :

gcloud beta error-reporting events delete

API REST

Pour supprimer tous les événements d'erreur, utilisez la méthode projects.deleteEvents de l'API REST.