Compartilhar via

Configurar o log de diagnóstico avançado para controles hospedados personalizados

  • Artigo

 

O Unified Service Desk permite configurar o log de diagnóstico para registrar eventos e erros operacionais no aplicativo cliente em um arquivo de log, que pode ser usado posteriormente para identificar e resolver problemas de desempenho ou erros. Para obter mais informações sobre o log de diagnóstico, veja TechNet: Configurar log de diagnóstico do cliente no Unified Service Desk.

Com a versão 2.2.1 do Unified Service Desk, o log de diagnóstico de tipos de controles hospedados predefinidos foi aperfeiçoado para fornecer informações avançadas sobre uma exceção ou erro, como a origem onde ocorreu o erro (controle hospedado), o nome e o tipo do controle hospedado, a ID da sessão) e informações detalhadas sobre o erro com rastreamento de pilha. As informações avançadas do diagnóstico melhoram muito a identificação e a solução rápidas de problemas no Unified Service Desk.

Você pode utilizar os mesmos recursos avançados de diagnóstico disponíveis nos controles hospedados predefinidos para seus controles personalizados usando o LogException Method no código de seu controle personalizado para fornecer informações avançadas sobre a exceção (se ocorrer) para facilitar a identificação de se o problema é causado por seu código personalizado ou por algum outro controle do Unified Service Desk.

O LogException Method está sobrecarregado e usa o DynamicsLogger internamente para fornecer informações avançadas de diagnóstico para exceções em seu controle personalizado. Use uma das duas assinaturas a seguir para usar esse método:

  • Passe o objeto da exceção e o tipo do evento que causou o rastreamento (opcional) Se você não especificar o tipo do evento, por padrão, o tipo de evento de rastreamento Error será passado:

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

  • Passe o valor da cadeia de caracteres da mensagem de erro, o tipo do evento que causou o rastreamento e o objeto da exceção:

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

Este é um exemplo das informações de diagnóstico como resultado do uso do LogException Method em que informações detalhadas sobre a origem (ID da sessão, nome e tipo do controle hospedado) e os detalhes da exceção são registrados em log:

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

Confira Também

TechNet: Configurar log de diagnóstico de cliente no Unified Service Desk
Controles hospedados do Unified Service Desk
Passo a passo: criar um controle hospedado personalizado para o Unified Service Desk

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais