Rapports d’exception

Les rapports d’exception sont essentiels pour identifier et corriger les plantages et les erreurs d’une application. Le Babel Licensing Service offre une fonctionnalité de collecte et d’analyse des rapports d’erreur des applications.

Cet article présente l’exemple de code console_exception_report_example, qui montre comment utiliser la bibliothèque cliente Babel Licensing pour envoyer au Babel Licensing Service les rapports d’exception d’une application. Cet exemple aide les développeurs à comprendre les causes profondes des exceptions et à améliorer la stabilité et la fiabilité de leurs applications.

Exemple de rapport d’exception d’application

Pour commencer avec console_exception_report_example, procédez comme suit :

git clone https://github.com/babelfornet/console-exception-report-example.git

cd console_exception_report_example

L’exemple console_exception_report_example montre comment intégrer la bibliothèque cliente Babel Licensing à votre application pour capturer les rapports d’exception et les envoyer au Babel Licensing Service. Voici le détail du code :

1. Initialisation de BabelReporting : le code de l’exemple initialise un objet BabelReporting, qui sert d’interface avec la bibliothèque cliente Babel Licensing.
2. Clé utilisateur : le code de l’exemple attribue une clé utilisateur (UserKey) qui autorise le client à envoyer des rapports d’exception. Veillez à la remplacer par une clé utilisateur valide. Pour générer une clé utilisateur, reportez-vous aux sections Licence flottante ou Activation de licence.
3. Configuration : l’URL du service de rapports Babel est configurée pour la connexion au Babel Licensing Service. Modifiez l’URL si nécessaire.

// Configure Babel Reporting Service URL
reporting.Configuration.ServiceUrl = "http://127.0.0.1:5005";

4. Événement BeforeSendReport : le code de l’exemple s’abonne à l’événement BeforeSendReport, qui permet de personnaliser le rapport d’exception avant son envoi. Ce gestionnaire d’événement ajoute au rapport des propriétés personnalisées telles que cmdline (la ligne de commande) et username (le nom de l’utilisateur actuel).

reporting.BeforeSendReport += (s, e) => {
 
   // Set report custom properties
   e.Report.Properties.Add("cmdline", Environment.CommandLine);
   e.Report.Properties.Add("username", Environment.UserName);
};

5. Gestion et envoi des exceptions : le code affiche un menu qui permet de simuler différents types d’exceptions. Lorsqu’une exception se produit, elle est interceptée et ses détails, dont la trace de pile, sont affichés. La méthode SendExceptionReport de l’objet BabelReporting est ensuite appelée pour envoyer le rapport d’exception au Babel Licensing Service.

static async void TryThrowException(Action throwException)
{
   try
   {
      throwException();
   }
   catch (Exception ex)
   {
      Console.WriteLine("Exception thrown:");
      Console.WriteLine(ex.StackTrace);
 
      reporting.SendExceptionReport(UserKey, ex);
   }
}

6. Exemples d’exceptions : le code de l’exemple comprend quatre scénarios d’exception, DivideByZeroException, IndexOutOfRangeException, ArgumentNullException et OutOfMemoryException. Chaque scénario montre, extraits de code à l’appui, un type d’exception précis qui est levé puis intercepté.

Les rapports envoyés par l’exemple peuvent être consultés dans la vue Rapports de Babel Desktop ou, avec l’édition Data Center, sur la page Rapports de l’application web.

L’exemple console_exception_report_example montre concrètement comment utiliser le Babel Licensing Service pour collecter et analyser les rapports d’erreur des applications. En intégrant la bibliothèque cliente Babel Licensing à vos propres applications et en vous appuyant sur le code de l’exemple, vous pouvez mieux comprendre les plantages, accélérer la correction des bogues, améliorer l’expérience utilisateur et fonder sur des données vos décisions d’amélioration. Clonez le dépôt, explorez le code et utilisez les rapports d’exception pour améliorer la stabilité et la fiabilité de vos applications.