Informes de excepción

Los informes de excepción son fundamentales para identificar y resolver los cierres inesperados y los errores de una aplicación. El Babel Licensing Service ofrece una función potente para recopilar y analizar los informes de fallos de la aplicación.

En este artículo se examina el código de ejemplo console_exception_report_example, que muestra cómo usar la biblioteca cliente de Babel Licensing para enviar informes de excepción de una aplicación al Babel Licensing Service. Con este código de ejemplo, los desarrolladores pueden conocer las causas de las excepciones y mejorar la estabilidad y la fiabilidad de sus aplicaciones.

Ejemplo de informe de excepción de una aplicación

Para empezar con console_exception_report_example, siga estos pasos:

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

cd console_exception_report_example

El ejemplo console_exception_report_example muestra cómo integrar la biblioteca cliente de Babel Licensing en su aplicación para capturar informes de excepción y enviarlos al Babel Licensing Service. A continuación se explica el código paso a paso:

1. Inicialización de BabelReporting: el código de ejemplo inicializa un objeto BabelReporting, que sirve de interfaz con la biblioteca cliente de Babel Licensing.
2. Clave de usuario: el código de ejemplo asigna una clave de usuario (UserKey) que autoriza al cliente a enviar informes de excepción. Sustitúyala por una clave de usuario válida. Para generar una clave de usuario, consulte los apartados Licencia flotante o Activación de licencia.
3. Configuración: la URL del servicio de informes de Babel se configura para conectarse al Babel Licensing Service. Cambie la URL si es necesario.

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

4. Evento BeforeSendReport: el código de ejemplo se suscribe al evento BeforeSendReport, que permite personalizar el informe de excepción antes de enviarlo. En este controlador de eventos se añaden al informe propiedades personalizadas como cmdline (línea de comandos) y username (nombre del usuario actual).

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

5. Control de excepciones y envío del informe: el código presenta un menú para simular distintos tipos de excepciones. Cuando se produce una excepción, se captura y se muestran sus detalles, incluida la traza de pila. A continuación se invoca el método SendExceptionReport del objeto BabelReporting para enviar el informe de excepción al 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. Ejemplos de excepciones: el código de ejemplo incluye cuatro escenarios de excepción: DivideByZeroException, IndexOutOfRangeException, ArgumentNullException y OutOfMemoryException. Cada escenario muestra, con sus fragmentos de código, cómo se lanza y se captura un tipo concreto de excepción.

Los informes enviados por el ejemplo se pueden consultar en la vista Informes de Babel Desktop o, con la edición Data Center, en la página Reports de la aplicación web.

El ejemplo console_exception_report_example es una demostración práctica de cómo usar el Babel Licensing Service para recopilar y analizar informes de fallos de la aplicación. Al integrar la biblioteca cliente de Babel Licensing en sus propias aplicaciones y partir del código de ejemplo, puede obtener información valiosa sobre los cierres inesperados de la aplicación, acelerar la corrección de errores, mejorar la experiencia del usuario y tomar decisiones basadas en datos para futuras mejoras. Clone el repositorio, examine el código y aproveche los informes de excepción para mejorar la estabilidad y la fiabilidad de sus aplicaciones.