Compartir a través de

Configurar el registro de diagnóstico mejorado para controles hospedados personalizados

  • Artículo

Unified Service Desk le permite configurar el registro de diagnóstico para registrar eventos operativos y errores de la aplicación cliente en un archivo de registro, que se puede usar posteriormente para identificar y solucionar problemas de rendimiento o errores. Para obtener más información sobre el registro de diagnóstico, consulte Configurar el registro de diagnóstico de clientes en Unified Service Desk.

Los registros de diagnóstico para tipos de controles hospedados predefinidos se han mejorado para proporcionar información detallada sobre una excepción o un error, como el origen de donde se produjo el error (nombre del control hospedado, tipo de control hospedado, Id. de sesión) e información detallada sobre el error junto con el seguimiento de la pila. La información detallada de diagnóstico mejora considerablemente en la rápida identificación y solución de problemas de Unified Service Desk.

Puede aprovechar las mismas capacidades de registro de diagnóstico mejorado disponibles en los controles hospedados predefinidos para controles personalizados utilizando el método LogException en el código de control personalizado para proporcionar información detallada sobre la excepción (si aparece) para que sea más fácil determinar si el problema es producido por el código personalizado o por algún otro control en Unified Service Desk.

El método LogException se sobrecarga y usa internamente DynamicsLogger para proporcionar información detallada de diagnóstico para excepciones en el control personalizado. Use una de las dos firmas siguientes para usar este método:

  • Pase el objeto de excepción y el tipo de evento que causó el seguimiento (opcional). Si no especifica el tipo de evento, se pasa el tipo de evento de seguimiento Error de forma predeterminada:

    LogException(Exception ex, TraceEventType eventType = TraceEventType.Error);

  • Pase el valor de cadena para el mensaje de error personalizado, el tipo de evento que causó el seguimiento, y el objeto de la excepción:

    LogException(string errorMessage, TraceEventType eventType, Exception ex);

    Este es un ejemplo de la información de diagnóstico como resultado de usar el método LogException donde se registra información detallada sobre el origen (Id. de sesión, nombre del control hospedado y tipo) y se registra el detalle de la excepción:

Exception raised in :  Session ID : d14893b0-6859-4827-9ddc-949d3fd36854 - Application : DemoControl - USD Component Type : USDHostedControl - Hosting Type : USD Hosted Control - Display Group : MainPanel -   
Exception details:   
Source: DemoControl  
Target: Void ThrowAndLogException_Click(System.Object, System.Windows.RoutedEventArgs)  
Exception: SampleLogException  
StackTrace:   at DemoControl.USDControl.ThrowAndLogException_Click(Object sender, RoutedEventArgs e

Vea también

Configure el registro de diagnóstico del cliente en Unified Service Desk
Controles hospedados de Unified Service Desk
Crear un control hospedado Unified Service Desk personalizado