La boîte de réception des erreurs fournit une expérience de suivi des erreurs unifiée pour détecter et trier les erreurs :
- Affichez et triez les problèmes dans les applications et les services qui intéressent votre équipe pour une résolution des erreurs plus rapide.
- Notification proactive avec des informations d'erreur détaillées dans Slack.
- Profils d'erreur pour montrer les similitudes entre l'événement d'erreur et faire apparaître la cause première en analysant l'attribut.
- Analysez les erreurs dans le contexte de la stack complète et résolvez les erreurs avec précision.
- Les erreurs pour , , et la fonction AWS Lambda sont toutes capturées dans la même boîte de réception.
Prêt à commencer ? Consultez notre documentation sur la création de votre première workload.
Erreurs de monitoring
Une fois que vous avez configuré votre boîte de réception des erreurs, vous pouvez commencer monitoring de manière proactive toutes les erreurs de votre stack:
Groupes d'erreurs
Les groupes d’erreurs sont des ensembles d’événements qui constituent une erreur unique. Les groupes d'erreurs sont stockés à long terme et contiennent des métriques, log d'activité, des discussions et des informations de base sur l'erreur unique. Les groupes d'erreurs sont liés à l' entité. Par conséquent, toute modification de l'état d'un groupe d'erreurs dans une boîte de réception d'erreurs aura un impact sur toutes les autres boîtes de réception contenant cette entité.
Comment fonctionnent les groupes d'erreurs
Les événements d'erreur sont regroupés dans un groupe d'erreurs lorsqu'ils partagent la même empreinte. Lorsque les événements sont ingérés par New Relic, nous exécutons l'événement via un ensemble de règles gérées qui génèrent une empreinte. Chaque empreinte digitale unique est associée à un seul groupe d’erreurs.
Les règles gérées par New Relic normalisent les données d'erreur, en identifiant et en ignorant les valeurs uniques telles que les UUID, les valeurs hexadécimales et les adresses e-mail qui provoqueraient le regroupement d'erreurs « similaires » dans des groupes uniques. New Relic account ID, entity ID, error class, error message, stack trace et exception sont toutes des données qui peuvent avoir un impact sur une empreinte digitale.
L’un des éléments suivants s’applique-t-il à votre boîte de réception d’erreurs aujourd’hui ?
- Les erreurs ne sont pas regroupées de la manière la plus logique pour votre application.
- Plusieurs groupes non fusionnés que vous souhaiteriez voir fusionnés.
- Une boîte de réception « bruyante » en raison d’un mauvais regroupement qui vous pousse à dépasser la limite quotidienne de groupes d’erreurs uniques.
- Un groupe d’erreurs dans votre boîte de réception qui contient des erreurs sans rapport.
Avoir des erreurs bien regroupées aide la boîte de réception des erreurs à mieux trier et diagnostiquer les problèmes de votre système. Bien que la boîte de réception des erreurs fournisse un ensemble de regroupements par défaut, il est parfois nécessaire de procéder à des ajustements.
Il existe deux options pour ajuster les groupes d'erreurs : mettre à jour le message d'erreur en utilisant l'attribut personnalisé ou créer vos propres groupes d'erreurs.
Créez vos propres groupes d'erreurs
Bon nombre de nos agents disposent désormais d'une fonctionnalité qui permet à votre code d'examiner une erreur et de désigner un groupe d'erreurs avant qu'il ne soit soumis à New Relic. Le groupe désigné est ensuite ajouté en tant qu’attribut error.group.name lors de l’événement d’erreur. Pour commencer, consultez les liens APM ci-dessous ou la documentation de l'agent de navigateur pour obtenir des informations sur la manière de spécifier un groupe d'erreurs personnalisé. Cela garantira que les erreurs et les attributs collectés par les agents seront préservés et regroupés à votre guise.
Agents APM pris en charge :
Même si nous ne prenons pas en charge votre langue, vous pouvez toujours définir error.group.name comme attribut personnalisé. Cela nous signale que l'événement appartient à un groupe personnalisé, mais l'événement capturé n'aura pas d'autre attribut d'agent.
bonnes pratiques pour une création significative de groupes d'erreurs
Bien que nos règles gérées soient capables de fournir un regroupement automatique des erreurs en fonction d'un ensemble prédéfini de modèles, il est impossible de reconnaître toutes les combinaisons possibles. Ainsi, supprimer les valeurs de variabilité élevées du message d'erreur garantira que vos erreurs sont regroupées correctement.
Par exemple, considérons ces deux messages d’erreur :
- « Erreur d'analyse : vous avez mis 124 et ce n'est pas autorisé »
- « Erreur d'analyse : vous avez mis 456 et ce n'est pas autorisé »
Ces messages d'erreur se ressemblent, mais ces occurrences d'erreur sont moins susceptibles d'être regroupées correctement en raison de numéros inférieurs à 4 chiffres (124). S'il y a des informations supplémentaires (par exemple Instructions SQL, identifiants, etc.) que vous souhaitez inclure dans le message d'erreur, il peut être envoyé via un attribut personnalisé.
Nos recommandations :
- Évitez d’utiliser des nombres de moins de 4 chiffres dans le message d’erreur.
- Évitez d'inclure des caractères spéciaux dans le message d'erreur.
- Évitez d’inclure des instructions SQL dans le message d’erreur.
- Évitez d'inclure trace d'appels dans le message d'erreur. la trace d'appel ne sera pas formatée lorsqu'elle sera envoyée en tant que message d'erreur, elle ne fonctionnera donc pas avec l'intégration CodeStream
- Évitez d'inclure des données présentant une grande variabilité (ex : identifiants, dates, JSON). L'utilisateur serait mieux servi si ces valeurs étaient collectées sous forme d'attribut. Ces attributs peuvent être visualisés au niveau de l'occurrence individuelle ainsi qu'au niveau du groupe d'erreurs dans la liste déroulante Profils .
- Nous mettons en garde contre l'utilisation de dates/horodatages. Bien que nous capturions et regroupions certains messages d'erreur contenant des horaires, nous ne pouvons pas garantir que nous reconnaîtrons tous les formats.
Occurrences
Votre boîte de réception des erreurs affiche le nombre total d'occurrences de chaque groupe d'erreurs dans la période sélectionnée. Le graphique Sparkline correspondant affiche le nombre total d'occurrences par jour sur la période sélectionnée lorsque vous passez la souris dessus.
Trier par filtre
En utilisant la liste déroulante en haut à droite, vous pouvez trier la liste des erreurs groupées par le nombre d'occurrences ou par l'erreur vue en dernier dans la plage de temps sélectionnée. Par exemple, si le sélecteur d'intervalle de temps sélectionné est Jan 24 5:00pm ET -- Jan 24 5:45pm ET et que vous triez par dernière observation, vous verrez les groupes d'erreurs triés avec ceux contenant l'occurrence la plus récente en premier.
tagde régression
Un groupe d'erreurs est étiqueté avec une tag de régression lorsqu'une nouvelle erreur correspond à l'empreinte d'un groupe d'erreurs résolu. La tag de régression disparaîtra une fois que l'état d'un groupe d'erreurs régressées sera modifié.
erreur attendue tag
Un groupe d'erreurs est étiqueté avec une tag expected si toutes les occurrences d'erreur dans le groupe sont attendues. Il s'agit d'une balise avec une tag contains expected si certaines occurrences d'erreur sont attendues et d'autres non. Ces balises sont disponibles sur toutes les erreurs après le 21 janvier 2023.
En savoir plus sur la façon de marquer les erreurs comme attendues.
Actions groupées
Vous pouvez résoudre, ignorer ou ne pas résoudre les erreurs en masse avec la liste déroulante Edit groups .
Vous pouvez mettre à jour l'état de plusieurs groupes d'erreurs (jusqu'à 2 000) à la fois. Dans la vue de la boîte de réception, cochez la case Error groups pour mettre à jour tous vos groupes d’erreurs dans la boîte de réception. Vous pouvez également sélectionner des groupes d’erreurs individuels pour mettre à jour leurs statuts.
Dates de la première et de la dernière rencontre
Nous comprenons qu’il est très utile de savoir quand un groupe d’erreurs a été vu pour la première fois afin de le corréler avec un changement dans le code/système. L’exactitude des dates de première et de dernière observation dépend des trois scénarios décrits ci-dessous :
Scenario 1: Si un groupe d'erreurs a été créé pour la première fois le 17/05/2022 ou après, les premières et dernières valeurs vues sont exactes.
Scenario 2: Si un groupe d'erreurs a été créé pour la première fois avant le 17/05/2022, la première date d'apparition ne sera pas exacte. La première date d'observation est soit le 17/05/2022, soit la date de la première occurrence (si la fenêtre temporelle sélectionnée est antérieure au 17/05/2022). La dernière valeur vue sera exacte.
Scenario 3: Si un groupe d'erreurs se produit une fois par semaine ou moins, les dates de la première et de la dernière apparition sont des estimations basées sur l'heure de l'occurrence unique. Nous suivons uniquement les dates de première et de dernière visualisation avec précision pour les erreurs qui apparaissent plus d'une fois par semaine.
Erreurs de triage
La boîte de réception des erreurs vous permet de trier les groupes d'erreurs directement depuis l'écran principal ou depuis la page des détails des erreurs. Le tri permet d'éliminer le bruit de votre boîte de réception d'erreurs et vous permet de vous concentrer sur les erreurs à fort impact qui nécessitent une attention particulière.
État des erreurs
Lorsque vous triez votre boîte de réception, vous pouvez choisir parmi une variété de statuts. Vous pouvez choisir de résoudre les erreurs immédiatement ou même de les marquer afin qu'elles soient ignorées. Dans d’autres cas, vous souhaiterez peut-être résoudre les problèmes dans la prochaine version ou dans une version spécifique. Pour plus de détails sur les options de résolution, voir Suivi des versions.
Erreur attendue
La boîte de réception des erreurs vous permet de filtrer les erreurs attendues pour l'entité APM. Vous pouvez marquer les erreurs comme attendues et les filtrer hors de votre boîte de réception pour supprimer le bruit.
- error.expected != true:Il s'agit de la valeur par défaut. Il masque tous les groupes d'erreurs qui contiennent uniquement erreurattendue et marque les groupes d'erreurs qui contiennent un mélange d'erreurs attendues et inattendues avec la tag « Contient les erreurs attendues ».
- error.expected = true:Ce filtre affichera les groupes d’erreurs dans lesquels certaines ou toutes les erreurs du groupe sont attendues. Cela peut être utile pour identifier les erreurs marquées comme attendues.
- La suppression du filtre error.expected affichera tous les groupes d'erreurs, qu'ils contiennent ou non des erreurs marquées comme attendues.
- erreurattendue sont toujours supprimés de la notification.
- Toutes les fonctionnalités ci-dessus ainsi que la balise erreurattendue sont disponibles sur les erreurs après le 21 janvier 2023.
Détails de l'erreur
Depuis la boîte de réception des erreurs, si vous cliquez sur un groupe d'erreurs spécifique, vous verrez une vue contextuelle affichant le contexte complet du problème.
Dans le panneau de gauche, vous pouvez trouver des détails sur une agrégation de toutes les occurrences de cette erreur :
- Métriques : Nombre d'utilisateurs impactés, premier vu, dernier vu
- Occurrences : nombre de fois que l'erreur s'est produite au cours des 30 dernières minutes
- Occurrences par version : nombre de fois que l'erreur s'est produite par version de déploiement
- Profils : Attribut impacté (cliquez sur un profil pour une analyse)
Dans le panneau de droite, vous pouvez trouver les détails d'une seule occurrence de cette erreur :
Nombre et fréquence des erreurs
Comptes associés
trace d'appel
Une liste d'attributs d'erreur
À partir de la vue détaillée, vous pouvez parcourir des erreurs spécifiques à l'aide du bouton bascule en haut à droite pour naviguer entre la première instance de l'erreur, la dernière ou n'importe quelle instance intermédiaire.
Si vous avez configuré le tracing distribué et s'il existe des échantillons de traces liées à des erreurs, vous verrez des options permettant d'afficher les détails trace . Il s'agit d'un moyen rapide d'afficher les informations trace sans accéder à la page principale de tracing distribué :
Dans le volet de gauche intitulé Distributed traces, vous pouvez développer l’en-tête pour afficher une liste de toutes les traces associées aux erreurs de ce groupe d’erreurs. Alternativement, vous pouvez cliquer sur Explore all pour ouvrir une liste de toutes les traces.
Dans Distributed trace, vous verrez la trace associée à l'occurrence d'erreur affichée sur cette page. Pour voir les travées de la trace dans une vue en cascade :
Cliquez directement sur le nom de la trace, ou cliquez sur l'icône avec une flèche à droite. Cela affiche la vue de mise au point en cascade qui met en évidence trace comportant des erreurs.
Cliquez sur Explore pour ouvrir une cascade non filtrée où vous pouvez cliquer sur toutes les travées.
Attribuer des erreurs
Vous pouvez attribuer un groupe d’erreurs à n’importe qui. Sélectionnez simplement l'utilisateur dans le menu déroulant de la liste d'attribution. Vous pouvez également attribuer une erreur à n'importe quelle adresse e-mail, même s'il ne s'agit pas d'un utilisateur New Relic.
Vous pouvez mettre à jour le filtre dans la boîte de réception des erreurs pour afficher uniquement les erreurs qui vous sont attribuées ou à un coéquipier.
rôle d'utilisateur dans la boîte de réception des erreurs
Les restrictions de rôle standard (lecture seule, standard, etc.) ne sont appliquées que dans la fonctionnalité de commentaires de groupe d'erreurs de la boîte de réception des erreurs. En dehors de la capacité de commentaires, les restrictions de rôle ne sont pas appliquées. Par conséquent, un utilisateur en lecture seule a la possibilité d'attribuer un groupe d'erreurs au sein d'un compte, en dehors du compte, et de mettre à jour les états du groupe d'erreurs (tels que ignoré, résolu, non résolu).