Configurar registro de diagnóstico no Unified Service Desk

Artigo
07/15/2015

Unified Service Desk e as bibliotecas de suporte subjacentes proporcionam várias camadas de log de diagnóstico que você pode usar para ajudar a solucionar problemas. Você também pode usar o log de diagnóstico em uma implantação em produção de Unified Service Desk para solucionar problemas específicos regularmente.

Por padrão, o log de erros está habilitado para o aplicativo cliente Unified Service Desk. O arquivo de log, UnifiedServiceDesk.log, está disponível no computador cliente para registrar os erros operacionais no aplicativo cliente no seguinte local: c:\Users\<UserName>\ AppData \ roaming \ Microsoft \ UnifiedServiceDesk \<Version>. O arquivo de log é criado na primeira vez que você encontra qualquer problemas no aplicativo cliente.

Neste tópico

Configurar o log de diagnóstico

Fontes de log diagnóstico

Níveis do log de diagnóstico

Ouvintes de log diagnóstico

Configurar o log de diagnóstico

Você pode habilitar o log usando o arquivo UnifiedServiceDesk.exe.config, disponível no diretório de instalação do cliente Unified Service Desk do computador. Para configurar o tipo de log e o local do arquivo de log Unified Service Desk:

Abra o arquivo UnifiedServiceDesk.exe.config para edição. Se você instalou o cliente Unified Service Desk na localização padrão, o arquivo normalmente estará disponível em C:\Program Files\Microsoft Dynamics CRM USD\USD.

Navegue até a seção <switches> no arquivo:

<switches>
<!-- 
     Possible values for switches: Off, Error, Warning, Information, Verbose
        Verbose:      includes Error, Warning, Info, Trace levels
        Information:  includes Error, Warning, Info levels
        Warning:      includes Error, Warning levels
        Error:        includes Error level
 -->
    <add name="EventTopicSwitch" value="Error"/>
    <add name="Microsoft.Uii.Common.Logging" value="Error"/>
    <add name="Microsoft.Xrm.Tooling.CrmConnectControl" value="Error"/>
    <add name="Microsoft.Xrm.Tooling.Connector.CrmServiceClient" value="Error"/>
    <add name="Microsoft.Xrm.Tooling.WebResourceUtility" value="Error"/>
    <add name="Microsoft.Crm.UnifiedServiceDesk" value="Error"/>
    <add name="Microsoft.Crm.UnifiedServiceDesk.Dynamics" value="Error"/>
    <add name="Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager" value="Error"/>
    <add name="UnifiedServiceDesk.KPIControl" value="Error"/>
</switches>

Na seção <switches>, especifique uma origem de log (como EventTopicSwitch) e especifique um valor do nível de log (como Error). A seção <switches> controla os níveis de log de várias origens. Por padrão, o log de erros está habilitado para todas as opções:
- Para obter informações sobre as origens de log disponíveis, consulte Fontes de log diagnóstico mais adiante neste tópico.
- Para obter informações sobre os valores que você pode especificar para cada origem de log, consulte Níveis do log de diagnóstico mais adiante neste tópico.
Para configurar o local dos arquivos de log, navegue até a seção <shareListeners> no arquivo:
```
<sharedListeners>
    <add name="fileListener"
        type="Microsoft.Xrm.Tooling.Connector.DynamicsFileLogTraceListener, Microsoft.Xrm.Tooling.Connector"
            BaseFileName="UnifiedServiceDesk"
                Location="LocalUserApplicationDirectory"
        />
    <add name="USDDebugListener" type="Microsoft.Crm.UnifiedServiceDesk.Dynamics.UsdTraceListener, Microsoft.Crm.UnifiedServiceDesk.Dynamics" />
</sharedListeners>
```
A seção <sharelisteners> controla o local e o tipo de logs gerados para Unified Service Desk. Por padrão, fileListener criará um arquivo chamado UnifiedServiceDesk.log no diretório c:\Users\<UserName>\AppData\Roaming\Microsoft\UnifiedServiceDesk\<Version>USDDebugListener e criará eventos na guia Guia Saída de depuração do controle hospedado do depurador.
Se desejar alterar a localização do arquivo UnifiedServiceDesk.log, altere o valor do parâmetro Location.
Por padrão, o arquivo e o depurador de log estão habilitados para todas as origens. Se quiser adicionar ou remover um ouvinte de uma origem diagnóstica, localize a origem necessária na seção <sources> e modifique a seção <listeners> da origem para incluir o ouvinte desejado.

Por exemplo, para adicionar o log de evento para o Unified Service Desk, adicione o ouvinte do log de evento à origem Microsoft.Crm.UnifiedServiceDesk:
```
<source name="Microsoft.Crm.UnifiedServiceDesk" switchName="Microsoft.Crm.UnifiedServiceDesk" switchType="System.Diagnostics.SourceSwitch">
    <listeners>
        <add name="fileListener"/>
        <add name="USDDebugListener" />
        <add name="eventLogListener" type="System.Diagnostics.EventLogTraceListener" initializeData="USD"/>
    </listeners>
</source>
```
Isto relatará eventos para o log de evento Windows com a marca “USD”, além do arquivo e depurador. Para obter mais informações sobre ouvintes diagnósticos, consulte Ouvintes de log diagnóstico mais adiante neste tópico.

Fontes de log diagnóstico

As origens comuns de log para solução de problemas estão listadas na tabela a seguir.

Nome da Origem	Descrição
EventTopicSwitch	Origem detalhada de log Integração da Interface do Usuário (UII) para monitorar o tráfego de mensagens dentro do UII.
Microsoft.Uii.Common.Logging	Fonte do Log Geral do UII geral para mensagens relatadas pelo UII.
Microsoft.Xrm.Tooling.CrmConnectControl	Origem de log para o processo de entrada para CRM. Esta origem relatará informações gerais ou detalhadas de diagnósticos sobre o procedimento de entrada.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Origem de log para todas as interações no nível de dados CRM. Esta origem relatará todas as interações com CRM, exceções e controles de tempo.
Microsoft.Xrm.Tooling.WebResourceUtility	Origem do log para solicitações de dados de recurso de Web pelo link da interface CRM.
Microsoft.Crm.UnifiedServiceDesk	Origem de log para a funcionalidade Unified Service Desk principal. Esta origem de log relatará as ações e os eventos fundamentais para Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Origem de log para o processador de correia e de carga de bota Unified Service Desk. Esta origem relatará ações e eventos que fazem parte da inicialização e começo do UII e Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Origem de log para ações que interagem com o sistema do perfil do usuário; isto faz parte do sistema do cache. Para obter mais informações: Configurar o cache do cliente no Unified Service Desk

Você pode alternar cada uma dessas origens de log de forma independente para oferecer suporte à solução de problemas e ao isolamento de problemas ou informações dentro do Unified Service Desk.

Níveis do log de diagnóstico

Há vários níveis de diferentes log disponíveis para uso. Entretanto, conforme você aumenta o nível de log, mais dados serão gerados e armazenados nos arquivos de log.

Nível de log	Descrição
Desligado	Desabilitar todos os eventos desta fonte.
Erro	Reportar somente eventos de erro.
Aviso	Reportar erros e eventos de aviso.
Informações	Relatar erros, avisos e eventos de informações.
Modo detalhado	Relatar erros, avisos, informações e eventos de informações detalhadas.
ActivityTracing	Relatar erros, avisos, informações e eventos de informações detalhadas e atividade de rastreamento (nomes dos métodos). Observação ActivityTracing está disponível somente em algumas origens.
Tudo	Reportar todos os eventos levantados pelo sistema.

Ouvintes de log diagnóstico

Os ouvintes de log diagnósticos são usados para identificar a saída do log diagnóstico para os arquivos, o log de eventos ou outras origens. Por padrão, as origens diagnósticas são presas aos ouvintes padrão (depurador) e arquivo (texto). Você pode configurar ouvintes de log adicionais para o log diagnóstico Unified Service Desk. Para obter mais informações sobre os ouvintes padrão .NET, consulte:

Você também pode criar ouvintes personalizados para enviar logs de diagnóstico a um local de sua escolha. Os ouvintes personalizados são criados ao derivar uma classe a partir da classe abstrata TraceListener. Você pode encontrar um passo a passo do processo em CodeGuru.como processo.

Consulte também

Conceitos

Depurar problemas no Unified Service Desk

Outros recursos

Solucionar problemas do Unified Service Desk usando o depurador e o registro de diagnóstico

Compartilhar via

Configurar registro de diagnóstico no Unified Service Desk

Neste tópico

Configurar o log de diagnóstico

Fontes de log diagnóstico

Níveis do log de diagnóstico

Ouvintes de log diagnóstico

Consulte também

Conceitos

Outros recursos

Recursos adicionais