Come si può configurare la registrazione diagnostica del client

2025-05-22

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

Utilizzando un record delle impostazioni di 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 tutti i desktop in cui si desidera la registrazione diagnostica del client Unified Service Desk.

Inoltre, è possibile configurare la registrazione diagnostica in modo specifico per le eccezioni che possono verificarsi nel client Unified Service Desk.

Configurare la registrazione diagnostica del cliente Unified Service Desk

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

Importante

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

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

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

Apri il file UnifiedServiceDesk.exe.config per la modifica. Se il client Unified Service Desk è stato installato nel percorso predefinito, questo file sarà in genere disponibile in C:\Programmi\Microsoft Dynamics 365 Customer Engagement USD\USD.

Vai alla <switches> sezione del 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 specificare un'origine <switches> di registrazione (ad esempio EventTopicSwitch) e 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 è abilitata per tutti gli switch:
- Per informazioni sulle origini di registrazione disponibili, vedere Origini di log 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 il percorso, le dimensioni massime del file e il comportamento di rollover dei file di registro, passare alla <shareListeners> sezione 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 <sharelisteners> sezione controlla la posizione e il tipo di log generati per Unified Service Desk. Per impostazione predefinita, fileListener verrà creato un file denominato UnifiedServiceDesk.log nella c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> directory e USDDebugListener verranno creati eventi nella scheda Output debug del controllo ospitato del debugger.

Se si desidera modificare la posizione del file UnifiedServiceDesk.log , modificare il valore del Location parametro.
Per impostazione predefinita, viene creato un nuovo registro di Unified Service Desk dopo che le dimensioni del file di registro corrente superano i 52,42 MB. Per impostazione predefinita, vengono mantenuti fino a 10 file di registro contemporaneamente prima che il file di registro meno recente venga eliminato.
- Per modificare la dimensione massima del file di log di Unified Service Desk, modificare il valore, in byte, del parametro MaxFileSize .
- Per modificare il numero di registri gestiti prima dell'eliminazione del registro meno recente, modificare il valore del parametro MaxFileCount . Se si utilizza zero (0), la registrazione di rollover verrà disabilitata e tutti i registri client di 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 una sorgente di diagnostica, individuare la sorgente richiesta nella sezione <sources> e quindi modificare la sezione <listeners> della sorgente in modo da 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>  
```
Questo ora segnalerà gli eventi al 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 log di diagnostica

Le origini comuni dei log per la risoluzione dei problemi sono elencate nella tabella seguente.

Nome della sorgente	Descrizione
EventTopicSwitch	Fonte di registrazione dettagliata dell'integrazione dell'interfaccia utente (UII) per monitorare il traffico dei messaggi all'interno di 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 riporterà informazioni di diagnostica generali o dettagliate sulla procedura di accesso.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Origine del registro per tutte le interazioni a livello dati di Dataverse. Questa fonte segnalerà tutte le interazioni con Dataverse, le eccezioni e le tempistiche.
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	Fonte del log per la funzionalità principale di Unified Service Desk. Questa origine di registro segnalerà le azioni e gli eventi fondamentali di 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	Origine del registro per le azioni che interagiscono con il sistema UserProfile; Questo fa parte del sistema di memorizzazione nella cache. Ulteriori informazioni: Configurare la memorizzazione nella cache del client per l'applicazione agente

È possibile attivare o disattivare ciascuna di queste origini di log in modo indipendente per supportare la risoluzione dei problemi e l'isolamento di problemi o informazioni all'interno di Unified Service Desk.

Livelli di registrazione della diagnostica

Sono disponibili diversi livelli di registrazione distinti per l'uso. Tuttavia, man mano che si aumenta il livello di registrazione, vengono generati e archiviati più dati nei file di registro.

Livello di log	Descrizione
Disattivato	Disabilita tutti gli eventi da questa origine.
Errore	Segnala solo gli eventi di errore.
Avvertimento	Segnala errori ed eventi di avviso.
Informazione	Segnala errori, avvisi ed eventi informativi.
Dettagli	Segnala errori, avvisi, informazioni ed eventi dettagliati.
ActivityTracing	Segnala errori, avvisi, informazioni ed eventi dettagliati e traccia delle attività (nomi dei metodi). Nota: ActivityTracing è disponibile solo in alcune origini.
Tutti	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 log aggiuntivi per la registrazione diagnostica per Unified Service Desk. Per altre informazioni sui listener predefiniti .NET, vedere:

MSDN:DefaultTraceListener
MSDN:EventLogTraceListener
MSDN:TextWriterTraceListener

È anche possibile creare listener personalizzati per inviare i log di diagnostica a una posizione scelta. I listener personalizzati vengono creati derivando una classe dalla classe astratta MSDN:TraceListener . Puoi trovare una guida del processo su CodeGuru.com.

Visualizzazione del file di log di diagnostica

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

Quando si verifica un errore in un controllo ospitato, le informazioni registrate nei file di registro forniscono informazioni dettagliate sull'eccezione, ad esempio il controllo ospitato di origine che ha causato l'eccezione insieme ai dettagli dell'eccezione. Si noti che l'intero codice JavaScript che ha causato l'eccezione non viene registrato. Vengono registrati solo il codice difettoso insieme alla descrizione dell'eccezione.

Di seguito è riportato un esempio di dettaglio dell'eccezione registrato.

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 unificato del Service Desk

Il processo di monitoraggio di Unified Service Desk (usdmp.exe) è un servizio che monitora continuamente l'integrità di Unified Service Desk e termina, per impostazione predefinita, dopo 5 secondi tutte le istanze del processo del browser che non rispondono e causano la mancata risposta di Unified Service Desk. Se un'istanza del processo del browser non risponde, ma Unified Service Desk risponde, l'istanza del processo del browser non verrà terminata. Per ulteriori informazioni su come modificare la durata dell'opzione globale ProcessTerminationThreshold per la terminazione del processo del browser, vedere Gestire le opzioni per Unified Service Desk.

Segnalazione diagnostica errori

La registrazione e la reportistica dettagliate e complete che si verificano durante un errore di un componente, di un'applicazione o di un sistema può aiutare a identificare quando e come si è verificato l'errore. "In caso di eccezione nel client Unified Service Desk, oltre alla normale registrazione diagnostica, la segnalazione degli errori registra le informazioni sullo stato del sistema e dell'applicazione." Per ulteriori informazioni sulle eccezioni, vedere Gestione degli errori di sistema e dell'applicazione da parte di Unified Service Desk.

Cartelle e file creati durante un'eccezione

In caso di eccezione, la segnalazione della diagnostica degli errori crea una cartella nel computer locale denominata DiagnosticsLogs_data e ora, dove data e ora sono nel formato anno-mese-date_time, ad esempio DiagnosticLogs_20170322_173643. All'interno della cartella DiagnosticsLogs vengono creati la cartella e i file seguenti.

File di diagnostica	Descrizione
UnifiedServiceDesk_dateandtime.log	Log di diagnostica standard 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 eccezione.
UnifiedServiceDeskMonitoring_data.log	Log di diagnostica standard creato e aggiunto quando il client Unified Service Desk è in esecuzione. Contiene informazioni di registrazione per il processo di monitoraggio di Unified Service Desk (usdmp.exe), che è un processo che monitora la salute del cliente Unified Service Desk. I file correnti vengono spostati nella cartella DiagnosticsLogs in caso di eccezione. Ulteriori informazioni: Processo di monitoraggio di Unified Service Desk
Eventlogs (cartella)	Cartella creata in caso di eccezioni irreversibili e non irreversibili. Contiene i registri eventi del sistema e delle applicazioni di Windows e i file di testo per la segnalazione degli errori.
ExitReport.txt	Registro di uscita creato in caso di eccezioni irreversibili e non irreversibili. Contiene informazioni sullo stato del processo, ad esempio il nome del computer, la versione di Unified Service Desk, l'ID 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, ad esempio il processore del computer, il sistema operativo, i dettagli del monitor, 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 di tutti i processi 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 testuale delle sottochiavi del Registro di sistema di Windows per Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_dateandtime.dmp	Creato solo in caso di un'eccezione irreversibile non gestita o quando viene attivato manualmente utilizzando la combinazione di tasti dell'opzione globale ManualDumpShortcut. Fornisce un file dump completo della memoria per UnifiedServiceDesk.exe. Si noti che, per visualizzare il file di dump, è necessario Visual Studio o un altro strumento di visualizzazione dei file di dump di Windows.

Configurare la segnalazione diagnostica degli errori

Accedi all'amministratore di Unified Service Desk.
Selezionare Controllo e diagnostica in Impostazioni avanzate.
Selezionare + Nuovo e quindi selezionare DiagnosticsConfiguration.
Selezionare o immettere i valori desiderati, ad esempio il rilevamento, il monitoraggio delle uscite e il percorso della cartella dei log di diagnostica. Ulteriori informazioni: Diagnostica
Selezionare Salva e chiudi.

Vedere anche

Configurare il controllo e la diagnostica in Unified Service Desk

Supporto per il debug in Unified Service Desk per la risoluzione dei problemi

Problemi di debug in Unified Service Desk