Come configurare la registrazione della diagnostica nel client

Articolo
04/19/2023

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

Importante

La diagnostica configurata manualmente (come descritta qui) non funzionerà più una volta abilitato un record Impostazioni di controllo e diagnostica configurato per la diagnostica.
Unified Service Desk fornisce anche un'API che ti consente di configurare la registrazione diagnostica avanzata per i controlli ospitati personalizzati. Ulteriori informazioni: Configurare la registrazione diagnostica avanzata per controlli ospitati personalizzati

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:

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.

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>

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.

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.

Se si desidera modificare il percorso del file UnifiedServiceDesk.log, modificare il valore del parametro Location.
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.
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.

Nome origine	Description
EventTopicSwitch	Origine di registrazione di User Interface Integration (UII) dettagliata per il monitoraggio del traffico della messaggistica in UII.
Microsoft.Uii.Common.Logging	Origine del registro di UII generale per i messaggi segnalati da UII.
Microsoft.Xrm.Tooling.CrmConnectControl	Origine del registro per il processo di accesso. Questa origine segnalerà le informazioni generali o dettagliate di diagnostica sulla procedura di accesso.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Origine del registro per tutte le interazioni a livello dati di Dataverse. Questa origine segnalerà tutte le interazioni con Dataverse, eccezioni e intervalli.
Microsoft.Xrm.Tooling.WebResourceUtility	Origine del registro per le richieste di dati delle risorse Web tramite il collegamento dell'interfaccia di Dataverse.
Microsoft.Crm.UnifiedServiceDesk	Origine del registro per la funzionalità di base di Unified Service Desk. Questa origine del registro segnalerà le azioni e gli eventi fondamentali per Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Origine del registro per l'avvio di Unified Service Desk e il processore di caricamento. Questa origine segnala le azioni e gli eventi che fanno parte del'inizializzazione e dell'avvio di UII e Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	File di origine per le azioni che interagiscono con il sistema di UserProfile; ciò fa parte del sistema di memorizzazione nella cache. Altre informazioni: Configurare la memorizzazione nella cache del client per l'applicazione agente

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

Livello di registrazione	Descrizione
Non visualizzare	Disabilita tutti gli eventi dall'origine.
Errore	Segnala solo gli eventi di errore.
Avviso	Segnala errori ed eventi di avviso.
Informazioni	Segnala errori, avvisi ed eventi di informazioni.
Dettagliato	Segnala errori, avvisi, informazioni ed eventi dettagliati.
ActivityTracing	Segnala errori, avvisi, informazioni ed eventi dettagliati e l'analisi dell'impegno (nomi dei metodi). Nota: ActivityTracing è disponibile solo in alcune origini.
Tutte	Segnala tutti gli eventi generati dal sistema.

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. È possibile trovare la procedura dettagliata del processo sul sito 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.

File di diagnostica	Descrizione
UnifiedServiceDesk_dateandtime.log	Registro di diagnostica predefinito che viene creato e aggiunto quando il client Unified Service Desk è in esecuzione. Il file contiene le informazioni di registrazione per il client Unified Service Desk (UnifiedServiceDesk.exe). I file correnti vengono spostati nella cartella DiagnosticsLogs in caso di eccezioni.
UnifiedServiceDeskMonitoring_data.log	Registro di diagnostica predefinito che viene creato e aggiunto quando il client Unified Service Desk è in esecuzione. Contiene le informazioni di registrazione per il processo di monitoraggio Unified Service Desk (usdmp.exe), un processo che controlla l'integrità del client Unified Service Desk. I file correnti vengono spostati nella cartella DiagnosticsLogs in caso di eccezioni. Ulteriori informazioni: Processo di monitoraggio per Unified Service Desk.
Eventlogs (cartella)	Cartella creata in caso di eccezioni irreversibili e non irreversibili. Contiene i registri degli eventi di sistema e dell'applicazione di Windows e i file di testo report degli errori.
ExitReport.txt	Registro di uscita creato in caso di eccezioni irreversibili e non irreversibili. Contiene informazioni di stato di processo ad esempio il nome del computer, la versione di Unified Service Desk, l'ID del processo, il codice di uscita e l'ora di uscita.
MachineHealthReport.txt	Registro di uscita creato in caso di eccezioni irreversibili e non irreversibili. Contiene informazioni sullo stato del sistema come il processore del computer, il sistema operativo, i dettagli del video, la lingua e la versione del browser.
ProcessReport.csv	Registro di uscita creato in caso di eccezioni irreversibili e non irreversibili. Fornisce un elenco completo dei processi che sono in esecuzione nel sistema al momento dell'eccezione.
RegistryLog.txt	Registro di uscita creato in caso di eccezioni irreversibili e non irreversibili. Include una copia di testo delle sottochiavi del Registro di sistema di Windows per Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_dateandtime.dmp	Creato solo in caso di eccezioni interna irreversibili non gestite o se richiamato manualmente con la combinazione di tastiera dell'opzione globale ManualDumpShortcut. Fornisce un file dump completo della memoria per UnifiedServiceDesk.exe. Nota che per visualizzare il file di dump, è necessario Visual Studio o un altro strumento di visualizzazione dei file dump di Windows.

Configurare i report della diagnostica di errore

Accedi all'amministratore di Unified Service Desk.
In Impostazioni avanzate, seleziona Controllo e diagnostica.
Seleziona + Nuovo e seleziona DiagnosticsConfiguration.
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
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