Diagnoseprotokollierung für benutzerdefinierte Steuerelemente konfigurieren

  • Artikel

Mit Unified Service Desk können Sie eine Diagnoseprotokollierung konfigurieren, um operative Ereignisse und Fehler in der Client-Anwendung in einer Protokolldatei zu speichern, die später zur Identifizierung und Behebung von Leistungsproblemen oder Fehlern verwendet werden kann. Weitere Informationen zu Diagnoseprotokollierung finden Sie unter Konfigurieren von Client-Diagnoseprotokollierungen in Unified Service Desk

Diagnoseprotokollierung für vordefinierte Typen das gehostete Steuerelement wurde verbessert, damit diesen Informationen eine Ausnahmeregelung oder ein Fehler, wie die Quelldaten angeben, in dem Fehler (Name das gehostete Steuerelements, gehostetes Steuerelement, Sitzungs-ID) sowie ausführliche Informationen zum Fehler auftrat anzuzeigen. Die umfangreichen Diagnoseinformationen helfen Ihnen, Probleme in Unified Service Desk schnell zu erkennen und zu beheben.

Sie können dieselben erweiterten Funktionalitäten für die Diagnoseprotokollierung, die in den vordefinierten gehosteten Steuerelementen verfügbar sind, auch für Ihre angepassten Steuerelemente nutzen, indem Sie die Methode LogException in Ihrem benutzerdefinierten Steuerelement-Code verwenden, um umfangreiche Informationen über die Ausnahme (falls sie auftritt) bereitzustellen, so dass Sie leichter feststellen können, ob das Problem durch Ihren benutzerdefinierten Code oder ein anderes Steuerelement in Unified Service Desk verursacht wurde.

LogException Methode ist überladen und verwendet intern DynamicsLogger, um Diagnoseinformationen für umfangreiche Ausnahmen in einem benutzerdefinierten Steuerelemente zu ermöglichen. Verwenden Sie eine der beiden folgenden Signaturen, um diese Möglichkeit zu nutzen:

  • Übergeben Sie das Ausnahmeobjekt und den Ereignistyp, der die Ablaufverfolgung verursacht haben (optional). Wenn Sie sich den Ereignistyp angeben, wird standardmäßig der Ablaufverfolgungsereignistyp Error übergeben:

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

  • Übergeben Sie den Zeichenfolgenwert für benutzerdefinierte Fehlermeldung, den Ereignistyp, der das Ablaufprotokoll verursacht hat und das Ausnahmeobjekt:

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

    Im Folgenden finden Sie ein Beispiel für Diagnoseinformationen als Ergebnis der Verwendung von LogException Methode in dem ausführliche Informationen zur Ursache (Sitzungs-ID, Name das gehostete Steuerelement und Typ) und Ausnahmedetail protokolliert werden:

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

Siehe auch

Konfigurieren von Client-Diagnoseprotokollierungen in Unified Service Desk
Von Unified Service Desk gehostete Steuerelemente
Erstellen eines benutzerdefinierten gehosteten Steuerelements für Unified Service Desk