Come configurare la registrazione della diagnostica nel client

Esistono due modi per configurare la registrazione della diagnostica del client Unified Service Desk:

• Utilizzando un record Impostazioni controllo e diagnostica creato e gestito nell'area Unified Service Desk di Microsoft Dataverse.

• Apportando manualmente le modifiche al file UnifiedServiceDesk.exe.config. Questo file deve quindi essere distribuito a ogni desktop in cui vuoi applicare la registrazione della diagnostica del client Unified Service Desk.

  Inoltre, puoi configurare la registrazione della diagnostica appositamente per le eccezioni che possono verificarsi nel client Unified Service Desk.

Configurare la registrazione della diagnostica del client in Unified Service Desk

In questa sezione viene descritto come configurare manualmente la registrazione della diagnostica in Unified Service Desk. Anziché la procedura descritta qui, si consiglia di utilizzare la funzionalità Impostazioni di controllo e diagnostica che fornisce l'amministrazione centralizzata della diagnostica e la capacità connettersi a un listener personalizzato. Altre informazioni: Configurare il controllo e la diagnostica in Unified Service Desk

In questo argomento viene descritto come modificare le caratteristiche della registrazione nel client.

Puoi abilitare la registrazione con il file UnifiedServiceDesk.exe.config, disponibile nella directory di installazione del client di Unified Service Desk nel tuo 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 365 Customer Engagement USD\USD.

2. Passa 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 registro disponibili più avanti in questo argomento.

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

4. Per configurare la posizione, la dimensione massima del file e il comportamento di rollover dei file di registro, passa alla sezione <shareListeners> del file.

   <sharedListeners>  
      <add name="fileListener"  
         type="Microsoft.Xrm.Tooling.Connector.DynamicsFileLogTraceListener, Microsoft.Xrm.Tooling.Connector"  
       BaseFileName="UnifiedServiceDesk"  
       Location="LocalUserApplicationDirectory" MaxFileSize ="52428800" MaxFileCount="10"/>  
      <add name="USDDebugListener" type="Microsoft.Crm.UnifiedServiceDesk.Dynamics.UsdTraceListener, Microsoft.Crm.UnifiedServiceDesk.Dynamics" />  
      <add name="ADALListener"  
       type="Microsoft.Xrm.Tooling.Connector.DynamicsFileLogTraceListener, Microsoft.Xrm.Tooling.Connector"  
       BaseFileName="ADAL"  
        Location="LocalUserApplicationDirectory" MaxFileSize ="52428800" MaxFileCount="10"/>  
   </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\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> e USDDebugListener crea eventi nella 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, un nuovo registro Unified Service Desk viene creato quando la dimensione del file di registro corrente supera 52,42 MB. Per impostazione predefinita, fino a 10 file di registro vengono gestiti contemporaneamente prima che il file di registro meno recente venga eliminato.

   • Per modificare la dimensione massima del file di registro Unified Service Desk, modifica il valore in byte del parametro MaxFileSize.

   • Per modificare il numero di registri gestiti prima che il registro meno recente venga eliminato, modifica il valore del parametro MaxFileCount. Se viene utilizzato zero (0) la registrazione di rollover viene disabilitata e tutti i registri client Unified Service Desk creati verranno salvati.

7. 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, aggiungi 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:

• MSDN:DefaultTraceListener

• MSDN:EventLogTraceListener

• MSDN:TextWriterTraceListener

  Puoi inoltre creare listener personalizzati per inviare i registri di diagnostica a un percorso desiderato. I listener personalizzati vengono creati derivando una classe dalla classe astratta MSDN:TraceListener. Puoi trovare una guida dettagliata del processo su CodeGuru.com.

Visualizzare il file del registro di diagnostica

Per impostazione predefinita, la registrazione della diagnostica viene abilitata per l'applicazione client Unified Service Desk. Un file di registro, UnifiedServiceDesk-<date>.log, è disponibile in c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> nel computer client per la registrazione degli errori operativi che si verificano nell'applicazione client. Il file di registro viene creato la prima volta che si riscontrano errori nell'applicazione client.

Quando un errore si verifica in un controllo ospitato, le informazioni memorizzate nei file di registro offrono informazioni dettagliate sull'eccezione, ad esempio il controllo ospitato di origine che ha causato l'eccezione insieme ai dettagli dell'eccezione. Si noti che il codice JavaScript che ha causato l'eccezione non viene registrato per intero. Solo il codice in errore con la descrizione dell'eccezione viene registrato.

Di seguito sono riportati i dettagli registrati di un'eccezione di esempio.

Microsoft.Crm.UnifiedServiceDesk.Dynamics   Error   2   12/27/2016 11:54:15 AM  Origin:AppdomianUnhandledException, IsFatal:True  
Source: DemoControl  
Target: Void throwExceptionMethod()  
Exception: Exception in custom control  
StackTrace:   at DemoControl.USDControl.throwExceptionMethod()  
   at System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx)  
   at System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx)  
   at System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Object state)  
   at System.Threading.ThreadHelper.ThreadStart()  

Processo di monitoraggio di Unified Service Desk

Il processo di monitoraggio Unified Service Desk (usdmp.exe) è un servizio che controlla continuamente l'integrità di Unified Service Desk e termina, per impostazione predefinita dopo 5 secondi, tutte le istanze di processo browser che non rispondono e a causa delle quali Unified Service Desk non risponde. Se l'istanza di un processo del browser non risponde, ma Unified Service Desk è attivo, l'istanza del processo del browser non verrà terminata. Per ulteriori informazioni su come modificare la durata dell'opzione globale ProcessTerminationThreshold per il termine del processo browser, vedi Gestire le opzioni per Unified Service Desk.

Report della diagnostica di errore

Le registrazioni e i report dettagliati e completi che vengono creati quando si verifica un errore relativo al componente, all'applicazione o al sistema ti indicano con facilità quando e come si è verificato l'errore. Oltre alla registrazione della diagnostica predefinita, nei report della diagnostica di errore vengono registrate le informazioni sullo stato dell'applicazione e del sistema in caso di eccezione nel client Unified Service Desk. Ulteriori informazioni sulle eccezioni sono disponibili in Come Unified Service Desk gestisce gli errori di sistema e dell'applicazione.

Cartelle e file creati durante un'eccezione

In caso di eccezioni, il report della diagnostica di errore crea una cartella nel computer locale denominata DiagnosticsLogs_data e ora, dove data e ora sono nel formato anno-mese-data_ora, ad esempio DiagnosticLogs_20170322_173643. Nella cartella DiagnosticsLogs vengono creati la cartella e i file seguenti.

Configurare i report della diagnostica di errore

1. Accedi all'amministratore di Unified Service Desk.

2. In Impostazioni avanzate, seleziona Controllo e diagnostica.

3. Seleziona + Nuovo e seleziona DiagnosticsConfiguration.

4. Selezionare o immettere i valori che si desidera, come la registrazione, il monitoraggio di uscita e la posizione della cartella dei registri di diagnostica. Maggiori informazioni: Diagnostica

5. Selezionare Salva e chiudi.

Vedi anche

Configurare il controllo e la diagnostica in Unified Service Desk

Supporto del debug in Unified Service Desk per risolvere i problemi

Eseguire il debug in Unified Service Desk