Exceptions traitées : analyser les tendances, prévenir les pannes, enquêter sur les événements

Notre fonctionnalité monitoring des exceptions gérées vous aide à identifier les facteurs importants contribuant à une mauvaise expérience des applications mobiles et à utiliser des données filtrables pour trouver une solution plus rapidement. Vous pouvez également utiliser l' API des exceptions gérées pour personnaliser les données que vous envoyez et utiliser NRQL pour interroger et partager les données.

Caractéristiques

La gestion des exceptions au fur et à mesure qu'elles se produisent peut contribuer à améliorer l'expérience utilisateur de votre application mobile, mais elle ne suffit pas à détecter les exceptions. Il faut aussi savoir comment les prévenir. Notre fonctionnalité Exceptions traitées vous aide à répondre à ces types de questions :

• Combien de types différents d’exceptions traitées se produisent ? Un taux d'occurrence élevé peut indiquer que vous devez apporter des modifications au système backend .
• Pourquoi l'utilisation de l'application par l'utilisateur entraîne-t-elle un try/catch ? Quel est le contexte des exceptions ?
• Quand les réponses d’un environnement de test aux exceptions traitées peuvent-elles indiquer des problèmes supplémentaires plus graves ?
• Qu'est-ce qui aurait pu provoquer un crash si l'exception n'avait pas été détectée en production ? Qu'est-ce qui d'autre (dans le code ou l'API backend ) affecte encore l'expérience de l'utilisateur ?

En utilisant des exceptions gérées, vous pouvez identifier et résoudre ces types de problèmes plus rapidement.

Exigences

Pour afficher les données d’exception traitées, votre application doit répondre aux exigences suivantes :

• Android: Agent Android version 5.15.0 ou supérieure
• iOS: Agent iOS version 5.15.0 ou supérieure

Graphiques de pourcentage d'exceptions

Commencez par les graphiques de pourcentage Users affected et Sessions affected pour voir s’il y a des pics, des creux ou des modèles inattendus avec des exceptions en général. Si le graphique Users affected est vide, cela signifie qu'il n'y a eu aucune session utilisateur pendant la période sélectionnée.

Utilisez ceci pour répondre à des questions telles que :

• Y a-t-il des pics à proximité d'une sortie de version récente ?
• Existe-t-il une période pendant laquelle le pourcentage d'utilisateurs a été affecté de manière significative par l'exception ?
• Y a-t-il des périodes sans incident ?

Pour examiner les données plus en détail : sous n’importe quel graphique, sélectionnez Expand chart.

Exemple de graphiques de pourcentage d'exceptions

Groupes et filtres

Utilisez les groupes et les filtres pour examiner plus en détail les attributs des pannes, des appareils, des emplacements ou d'autres attributs personnalisés. Vous pouvez sélectionner un groupe, puis filtrer sur des données spécifiques. Utilisez ceci pour faire des choses comme :

• Regroupez la liste par emplacement d'exception (par défaut), cause, build ou version d'application, appareils, connexions ou autre attribut personnalisé. Cela vous permet de découvrir des modèles dans vos exceptions pour déterminer la cause première.
• Utilisez le sélecteur d'intervalle de temps pour régler la période de temps actuellement sélectionnée.
• Filtrez par un Version spécifique ou par un ou plusieurs attributs Filter, tels que appVersion, exceptionLocationMethod, lastInteraction, ou l'un des attributs standard et personnalisés de la liste plus longue .

Les filtres actuellement sélectionnés apparaissent en haut de la page de l’interface utilisateur. Vous pouvez les fermer, ajouter d’autres filtres ou sélectionner d’autres groupes et filtres.

Exemple de groupes et de filtres

Les meilleurs emplacements d'exception

Utilisez le tableau Top exception locations pour rechercher ou trier des modèles dans le type d'exception que vous avez sélectionné parmi les groupes et les filtres. Cela comprend :

• Lieux récurrents dans la trace d'appels
• Version de l'application mobile
• Nombre d'occurrences
• Nombre d'utilisateurs concernés pendant la période sélectionnée

Par exemple, vous pouvez regrouper par Exception Message, filtrer sur timeout message, puis sélectionner des emplacements de délai d'expiration individuels dans le tableau pour consulter le fil de trace des appels et les détails de chaque occurrence.

• Pour filtrer ou regrouper par un autre attribut, utilisez la fenêtre de recherche du tableau ou sélectionnez l'un des filtres disponibles. Par exemple, filtrez par type d'événement, appareil, emplacement spécifique ou tout attribut personnalisé.
• Pour rechercher d’autres modèles historiques, modifiez la période sélectionnée.

Exemple d'emplacements d'exceptions principales

Liens vers le générateur de requêtes

Handled exceptions les graphiques utilisent l'attribut par défaut pour l'événement mobile (y compris MobileHandledException), ainsi que tout attribut personnalisé que vous avez ajouté à ce type d'événement. Lorsque vous passez la souris sur les graphiques, des liens directs apparaissent en dessous. Ces liens vers le générateur de requêtes vous permettent d'analyser encore plus en profondeur les données de votre application mobile.

• View query lien : Afficher la requête NRQL utilisée pour calculer les données du graphique.
• View in query builder lien : Consultez le graphique et partagez-le avec d'autres.

Tableau des emplacements d'exception

Le tableau Exception locations complète les graphiques. Il répertorie où les cinq principales exceptions traitées apparaissent dans leur fil de trace des appels et les relie aux détails pertinents. Chaque ligne vous aide à trouver des réponses à des questions telles que :

• Combien de ces exceptions se sont produites au cours de la période sélectionnée ?
• Une version d'application spécifique a-t-elle un nombre plus élevé (ou plus faible) d'utilisateurs affectés ?
• Quelle exception a le moins d’occurrences ?

Vous pouvez modifier l'ordre de tri ou les options de filtrage pour vous concentrer uniquement sur les types d'exceptions qui comptent le plus pour vous et vos équipes. Pour afficher des détails de thread supplémentaires pour chaque occurrence de l'exception, sélectionnez un enregistrement dans la table Top exceptions location .

Exemple de tableau des emplacements d'exception

Détails de l'occurrence de l'exception traitée

Pour afficher les détails de chaque occurrence d’une exception traitée :

1. Allez à one.newrelic.com > All capabilities > Mobile > (select an app) > Exceptions > Handled exceptions.
2. Dans la table Top exception locations , sélectionnez une exception gérée sur n’importe quelle ligne.

La page Occurrences affiche les détails de l'exception sélectionnée, y compris les données de répartition par type d'appareil ou système d'exploitation, le nombre d'utilisateurs concernés, le nombre total d'occurrences pour la période sélectionnée, l'attribut, etc.

Suivi des événements pour un événement

Le graphique Event trail vous permet de voir l'horodatage de l'événement menant à une exception traitée.

Trace d'appels non symbolisée

New Relic ne stocke pas les traces d'appels non symbolisées pour les exceptions traitées. Ceci est différent du suivi des événements de crash. Vous pouvez télécharger un dSYM ultérieurement si nécessaire, car les nouvelles exceptions gérées seront symbolisées.

API des exceptions gérées

Notre fonctionnalité Handled exceptions inclut automatiquement un attribut par défaut que vous pouvez utiliser pour explorer vos données d'exceptions gérées dans le générateur de requêtes et obtenir des détails spécifiques :

• Utilisez la méthoderecordHandledExceptions() .
• Requête le type d'événement MobileHandledException . Pour plus d'informations, consultez les exemples NRQL pour monitoring d'applications mobiles.

Créer un attribut personnalisé et événement

Vous pouvez également attribuer personnalisé et événement personnalisé. Une fois que vous les avez créés, sélectionnez et interrogez l'attribut sur la page Handled exceptions .