Partager via

Configurer la journalisation améliorée des diagnostics pour les contrôles hébergés personnalisés

  • Article

Unified Service Desk vous permet de configurer la journalisation des diagnostics pour enregistrer les événements et les erreurs opérationnelles de l’application cliente dans un fichier journal, qui peut ensuite être utilisé pour identifier et résoudre les problèmes de performances ou les erreurs. Pour plus d’informations sur la journalisation des diagnostics, voir Configurer la journalisation des diagnostics clients dans Unified Service Desk.

La journalisation des diagnostics pour les types de contrôles hébergés prédéfinis a été améliorée pour fournir des informations complètes sur une exception ou une erreur, comme la source où l’erreur s’est produite (nom du contrôle hébergé, type de contrôle hébergé, ID de session) et des informations détaillées sur l’erreur et la trace de la pile. Les informations de diagnostics détaillées permettent d’identifier et de résoudre rapidement les problèmes dans Unified Service Desk.

Vous pouvez utiliser les mêmes fonctionnalités améliorées de journalisation des diagnostics disponibles dans les contrôles hébergés prédéfinis pour vos contrôles personnalisés en utilisant la méthode LogException dans votre code de contrôle personnalisé pour fournir des informations détaillées sur l’exception (si elle se produit) afin d’identifier plus facilement si le problème provient de votre code personnalisé ou d’un autre contrôle dans Unified Service Desk.

La méthode LogException est surchargée, et utilise en interne DynamicsLogger pour fournir des informations de diagnostic détaillées pour les exceptions de votre contrôle personnalisé. Utilisez l’une des deux signatures suivantes pour utiliser cette méthode :

  • Passez l’objet d’exception et le type d’événement à l’origine du suivi (facultatif). Si vous ne spécifiez pas le type d’événement, le type d’événement de suivi Error par défaut est passé :

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

  • Passez la valeur de chaîne pour le message d’erreur personnalisé, le type d’événement à l’origine du suivi et l’objet d’exception :

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

    Voici un exemple d’informations de diagnostics résultant de l’utilisation de la méthode LogException, où des informations détaillées sur la source (ID de session, nom et type de contrôle hébergé) et les détails de l’exception sont enregistrées :

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

Voir aussi

Configurer la journalisation des diagnostics clients dans Unified Service Desk
Contrôles hébergés d’Unified Service Desk
Créer un contrôle hébergé Unified Service Desk personnalisé