Configurare la registrazione della diagnostica in Unified Service Desk

Unified Service Desk e le librerie di supporto sottostanti forniscono diversi livelli di registrazione della diagnostica progettati per consentire la risoluzione dei problemi. È inoltre possibile utilizzare i registri di diagnostica in una distribuzione di produzione di Unified Service Desk per risolvere problemi specifici costantemente.

Per impostazione predefinita, la registrazione degli errori viene abilitata per l'applicazione client Unified Service Desk. Un file di registro, UnifiedServiceDesk.log, è disponibile nel percorso seguente nel computer client per registrare errori operativi dell'applicazione client: c:\Users\<NomeUtente>\AppData\Roaming\Microsoft\UnifiedServiceDesk\<Versione>. Il file di registro viene creato la prima volta che si riscontrano errori nell'applicazione client.

In questo argomento

Configurare la registrazione diagnostica

Origini dei registri di diagnostica

Livelli di registrazione della diagnostica

Listener dei registri di diagnostica

Configurare la registrazione diagnostica

È possibile abilitare la registrazione mediante il file UnifiedServiceDesk.exe.config, disponibile nella directory di installazione del client di Unified Service Desk nel computer. Per configurare il tipo di registrazione e il percorso del file di registro di Unified Service Desk:

1. Aprire il file UnifiedServiceDesk.exe.config per la modifica. Se è stato installato il client Unified Service Desk nel percorso predefinito, tale file in genere sarà disponibile in C:\Programmi\Microsoft Dynamics CRM USD\USD.

2. Passare alla sezione <switches> nel file:

   <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>
   

3. Nella sezione <switches>, specificare un'origine di registrazione (ad esempio EventTopicSwitch), quindi specificare un valore del livello di registrazione (ad esempio Error). La sezione <switches> controlla i livelli di registrazione per varie origini. Per impostazione predefinita, la registrazione degli errori viene abilitata per tutte le opzioni.

   • Per informazioni sulle origini di registrazione disponibili, vedere Origini dei registri di diagnostica più avanti in questo argomento.

   • Per informazioni sui valori che è possibile specificare per ogni origine di registrazione, vedere Livelli di registrazione della diagnostica più avanti in questo argomento.

4. Per configurare il percorso dei file di registro, passare alla sezione <shareListeners> nel file:

   <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>
   

   La sezione <sharelisteners> controlla il percorso e il tipo di registri che vengono generati per Unified Service Desk. Per impostazione predefinita, fileListener crea un file denominato UnifiedServiceDesk.log nella directory c:\Users\<NomeUtente>\AppData\Roaming\ Microsoft\UnifiedServiceDesk\<Versione> e USDDebugListener crea eventi nella scheda Scheda Output di debug del controllo ospitato Debugger.

5. Se si desidera modificare il percorso del file UnifiedServiceDesk.log, modificare il valore del parametro Location.

6. Per impostazione predefinita, la registrazione di file e debugger è abilitata per tutte le origini. Se si desidera aggiungere o rimuovere un listener da un'origine di diagnostica, individuare l'origine richiesta nella sezione <sources> e quindi modificare la sezione <listeners> dell'origine per includere il listener desiderato.

   Ad esempio, per aggiungere la registrazione di eventi per Unified Service Desk, aggiungere il listener del registro eventi all'origine 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>
   

   Verranno così segnalati gli eventi nel registro eventi di Windows con il tag "USD", oltre al file e al debugger. Per ulteriori informazioni sui listener di diagnostica, vedere Listener dei registri di diagnostica più avanti in questo argomento.

Origini dei registri di diagnostica

Le origini comuni dei registri di risoluzione dei problemi sono elencate nella tabella seguente.

È possibile attivare e disattivare ognuna delle origini di registro per supportare la risoluzione e l'isolamento dei problemi o delle informazioni in Unified Service Desk.

Livelli di registrazione della diagnostica

Esistono diversi livelli di registrazione distinti disponibili per l'utilizzo. Tuttavia, con l'aumento del livello di registrazione, vengono generati e archiviati più dati nei file di registro.

Listener dei registri di diagnostica

I listener dei registri di diagnostica sono utilizzati per indirizzare l'output del registro di diagnostica ai file, al registro eventi o ad altre origini. Per impostazione predefinita, tutte le origini di diagnostica sono collegate sia al listener predefinito (Debugger) sia ai listener di file (testo). È possibile configurare listener di registro aggiuntivi per la registrazione di diagnostica per Unified Service Desk. Per ulteriori informazioni sui listener predefiniti .NET, vedere:

• DefaultTraceListener

• EventLogTraceListener

• TextWriterTraceListener

È inoltre possibile creare listener personalizzati per inviare i registri di diagnostica nel percorso desiderato. I listener personalizzati vengono creati derivando una classe dalla classe astratta TraceListener. È possibile trovare la procedura dettagliata del processo sul sito CodeGuru.com.

Vedere anche

Concetti

Eseguire il debug in Unified Service Desk

Altre risorse

Risolvere i problemi relativi a Unified Service Desk utilizzando la registrazione di diagnostica e il debugger

Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.