Cum puteți configura jurnalul de diagnostic al clientului

Articol
01/15/2024

Există două moduri în care puteți configura înregistrarea în jurnal a diagnosticelor clientului Unified Service Desk:

Utilizând o înregistrare Setări de auditare și diagnosticare care este creată și gestionată în zona Unified Service Desk din Microsoft Dataverse.
Modificând manual fișierul UnifiedServiceDesk.exe.config. Acest fișier trebuie apoi distribuit pe fiecare desktop pe care doriți înregistrarea în jurnal a diagnosticelor clientului Unified Service Desk.

În plus, puteți configura înregistrarea în jurnal a diagnosticelor special pentru excepțiile care pot apărea în clientul Unified Service Desk.

Configurarea înregistrării în jurnal a diagnosticelor clientului Unified Service Desk

Această secțiune descrie cum se configurează manual înregistrarea în jurnal a diagnosticelor în Unified Service Desk. Mai degrabă decât să utilizați procedura descrisă aici, vă recomandăm să utilizați caracteristica Setări de auditare și diagnosticare care oferă o administrare centralizată de diagnosticare și capacitatea de conectare la un listener personalizat. Informații suplimentare: Configurarea auditării și diagnosticării în Unified Service Desk

Important

Diagnosticele configurate manual (după cum este descrisă aici) nu vor mai funcționa după ce activați o înregistrare Setări de auditare și diagnosticare configurată pentru diagnosticare.
Unified Service Desk oferă, de asemenea, un API care vă permite să configurați înregistrarea îmbogățită în jurnal a diagnosticelor pentru controalele găzduite particularizate. Informații suplimentare: Configurarea înregistrării îmbunătățite în jurnal a diagnosticelor pentru controalele găzduite particularizate

Acest subiect descrie cum se schimbă caracteristicile de înregistrare în jurnal ale clientului.

Puteți activa înregistrarea în jurnal cu fișierul UnifiedServiceDesk.exe.config , care este disponibil în directorul de instalare client Unified Service Desk de pe computer. Pentru a configura tipul de înregistrare în jurnal și locația fișierului jurnal Unified Service Desk:

Deschideți fișierul UnifiedServiceDesk.exe.config pentru editare. Dacă ați instalat clientul Unified Service Desk în locația implicită, acest fișier va fi disponibil în general la C:\Program Files\365 Customer Engagement USD\Microsoft Dynamics USD.

Accesați secțiunea din <switches> fișier:

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

În secțiune, specificați o sursă de <switches> înregistrare în jurnal (cum ar fi), apoi specificați o valoare a nivelului de înregistrare în jurnal (cum EventTopicSwitchError ar fi). Secțiunea <switches> controlează nivelurile de înregistrare în jurnal pentru diverse surse. În mod implicit, înregistrarea în jurnal a erorilor este activată pentru toate comutatoarele.
- Pentru informații despre sursele disponibile de înregistrare în jurnal, consultați Surse de jurnal disponibile mai jos în acest subiect.
- Pentru informații despre valorile pe care le puteți specifica pentru fiecare sursă de înregistrare în jurnal, consultați Niveluri de înregistrare în jurnal mai jos în acest subiect.

Pentru a configura locația, dimensiunea maximă a fișierului și comportamentul de răsturnare al fișierelor jurnal, accesați secțiunea din <shareListeners> fișier.

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

Secțiunea <sharelisteners> controlează locația și tipul de jurnale generate pentru Unified Service Desk. În mod implicit, fileListener va crea un fișier numit UnifiedServiceDesk.log în director și c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> va crea evenimente în USDDebugListenerfila de ieșire Debug a controlului găzduit de Depanator.

Dacă doriți să modificați locația fișierului UnifiedServiceDesk.log , modificați valoarea parametrului Location .
În mod implicit, se creează un nou jurnal Unified Service Desk după ce dimensiunea fișierului jurnal curent depășește 52,42 MB. În mod implicit, până la 10 fișiere jurnal sunt menținute la un moment dat, înainte ca fișierul jurnal cel mai vechi să fie eliminat.
- Pentru a modifica dimensiunea maximă a fișierului jurnal Unified Service Desk, modificați valoarea, în octeți, a parametrului MaxFileSize .
- Pentru a modifica numărul de jurnale menținute înainte de ștergerea celui mai vechi jurnal, modificați valoarea parametrului MaxFileCount . Dacă se utilizează zero (0), înregistrarea rollover va fi dezactivată și toate jurnalele de client Unified Service Desk create vor fi salvate.
În mod implicit, înregistrarea în jurnal a depanatoarelor și fișierelor este activată pentru toate sursele. Dacă doriți să adăugați sau să eliminați un ascultător dintr-o sursă de diagnosticare, găsiți sursa necesară în <sources> secțiune, apoi modificați <listeners> secțiunea sursei pentru a include ascultătorul dorit.

De exemplu, pentru a adăuga înregistrarea în jurnal a evenimentelor pentru Unified Service Desk, adăugați ascultătorul de înregistrare în jurnal a evenimentelor la Microsoft.Crm.UnifiedServiceDesk sursă.
```
<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>  
```
Aceasta va raporta acum evenimentele în jurnalul de evenimente Windows cu eticheta "USD", pe lângă fișier și depanator. Pentru mai multe informații despre ascultătorii diagnosticați, consultați Ascultătorii jurnalului de diagnosticare mai jos în acest subiect.

Sursele de înregistrare în jurnal a diagnosticelor

Sursele comune de înregistrare în jurnal a depanărilor sunt listate în următorul tabel.

Nume sursă	Descriere
EventTopicSwitch	Sursă detaliată de înregistrare a integrării interfeței cu utilizatorul (UII) pentru monitorizarea traficului de mesagerie în UII.
Microsoft.Uii.Common.Logging	Sursă generală de înregistrare în jurnal UII pentru mesaje raportate de UII.
Microsoft.Xrm.Tooling.CrmConnectControl	Sursă de înregistrare în jurnal pentru procesul de conectare. Această sursă va raporta informații generale sau detaliate de diagnosticare despre procedura de conectare.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Sursa de înregistrare în jurnal pentru toate interacțiunile Dataverse la nivel de date. Această sursă va raporta toate interacțiunile cu Dataverse, excepțiile și temporizările.
Microsoft.Xrm.Tooling.WebResourceUtility	Sursă de înregistrare în jurnal pentru resursa web prin intermediul linkului de interfață Dataverse.
Microsoft.Crm.UnifiedServiceDesk	Sursă de jurnal pentru funcționalitatea de bază Unified Service Desk. Această sursă de jurnal va raporta acțiuni și evenimente esențiale pentru Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Sursă de jurnal pentru cureaua de inițializare Unified Service Desk și procesorul de încărcare. Această sursă va raporta acțiuni și evenimente care fac parte din inițializarea și pornirea UII și Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Sursă de înregistrare în jurnal pentru acțiunile care interacționează cu sistemul UserProfile; face parte din sistemul de memorare în cache. Informații suplimentare: Configurarea memorării în cache a clientului pentru aplicația agent

Puteți comuta independent fiecare dintre aceste surse de jurnal pentru a accepta depanarea și izolarea problemelor sau informațiilor din Unified Service Desk.

Nivelurile de înregistrare în jurnal a diagnosticelor

Sunt disponibile pentru utilizare mai multe niveluri distincte de înregistrare în jurnal a diagnosticelor. Cu toate acestea, atunci când creșteți nivelul de înregistrare în jurnal, sunt generate și stocate mai multe date în fișiere jurnal.

Nivel jurnal	Descriere
Dezactivat	Dezactivează toate evenimentele din această sursă.
Eroare	Rapoarte numai evenimentele de eroare.
Avertisment	Raportează erorile și evenimentele de avertizare.
Informații	Raportează erorile, avertismentele și evenimentele de informare.
Detaliat	Raportează erorile, avertismentele, informațiile și evenimentele detaliate.
ActivityTracing	Raportează erorile, avertismentele, informațiile, evenimente detaliate și urmărirea activităților (nume de metodă). Notă: ActivityTracing este disponibil numai pentru unele surse.
Toate	Raportează toate evenimentele semnalate de sistem.

Ascultători jurnal diagnosticare

Ascultătorii de jurnale de diagnosticare sunt utilizați pentru a direcționa ieșirea de jurnal de diagnosticare la fișiere, jurnale de evenimente sau la alte surse. În mod implicit, toate sursele de diagnosticare sunt cablate atât la listenerii impliciți (depanatori), cât și la listenerii de fișiere (text). Puteți configura ascultători de jurnal suplimentari pentru înregistrarea în jurnal a diagnosticelor pentru Unified Service Desk. Pentru mai multe informații despre listenerii .NET impliciți, consultați:

MSDN:DefaultTraceListener
MSDN:EventLogTraceListener
MSDN:TextWriterTraceListener

Puteți crea, de asemenea, listeneri personalizați pentru a trimite jurnale de diagnostic la o locație aleasă de dvs. Ascultătorii particularizați sunt creați prin derivarea unei clase din clasa abstractă MSDN:TraceListener . Puteți găsi o prezentare generală a procesului pe CodeGuru.com.

Vizualizarea fișierului jurnal de diagnosticare

În mod implicit, înregistrarea în jurnal a diagnosticelor este activată pentru aplicația client Unified Service Desk. Un fișier jurnal, UnifiedServiceDesk-date.log, este disponibil pe<computerul client pentru a înregistra erorile operaționale în aplicația> client.c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> Fișierul jurnal este creat prima dată când întâmpinați orice erori în aplicația client.

Atunci când apare o eroare într-un control găzduit, informațiile înregistrate în fișierele jurnal furnizează informații detaliate despre excepție, cum ar fi controlul găzduit inițiator care a produs excepția, împreună cu detalii ale excepției. Observați că întregul cod JavaScript care a produs excepția nu este înregistrat în jurnal. Doar codul de eroare împreună cu descrierea excepției sunt înregistrate în jurnal.

Iată un exemplu de detaliu de excepție care este înregistrată în jurnal.

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

Procesul de monitorizare Unified Service Desk

Procesul de monitorizare Unified Service Desk (usdmp.exe) este un serviciu care monitorizează continuu starea Unified Service Desk și închide, în mod implicit, după 5 secunde, orice instanțe de proces ale browserului care nu răspund și care fac ca Unified Service Desk să nu mai răspundă. Dacă o instanță de proces a browserului nu răspunde, dar Unified Service Desk răspunde, instanța de proces a browserului nu va fi închisă. Pentru mai multe informații despre cum să modificați durata opțiunii globale ProcessTerminationThreshold pentru terminarea procesului browserului, consultați Gestionarea opțiunilor pentru Unified Service Desk.

Raportarea diagnosticelor pentru erori

Rapoartele și jurnalele detaliate și cuprinzătoare care apar în timpul unei erori de componentă, aplicați sau sistem pot ajuta la identificarea momentului și a modului în care s-a produs eroarea. În plus față de înregistrarea standard în jurnal a diagnosticelor, raportarea erorilor de raportare a înregistrărilor informații despre sistem și starea aplicației în cazul unei excepții în clientul Unified Service Desk. Mai multe informații despre excepții pot fi găsite în Cum gestionează Unified Service Desk erorile de aplicație și de sistem.

Folderele și fișierele create în cadrul unei excepții

În cazul unei excepții, raportarea diagnosticării erorilor creează un folder pe computerul local numit DiagnosticsLogs_dată și oră, unde data și ora sunt în forma an-lună-date_time, cum ar fi DiagnosticLogs_20170322_173643. În cadrul folderului DiagnosticsLogs, se creează următoarele foldere și fișiere.

Fișier de diagnosticare	Descriere
UnifiedServiceDesk_datăși oră.log	Jurnalul de diagnosticare standard care este creat și adăugat atunci când rulează clientul Unified Service Desk. Fișierul conține informații de înregistrare în jurnal pentru clientul Unified Service Desk (UnifiedServiceDesk.exe). Fișierele curente sunt mutate în folderul DiagnosticsLogs în cazul unei excepții.
UnifiedServiceDeskMonitoring_data.log	Jurnalul de diagnosticare standard care este creat și adăugat atunci când rulează clientul Unified Service Desk. Conține informații de înregistrare în jurnal pentru procesul de monitorizare Unified Service Desk (usdmp.exe), care este un proces care monitorizează starea clientului Unified Service Desk. Fișierele curente sunt mutate în folderul DiagnosticsLogs în cazul unei excepții. Informații suplimentare: Procesul unificat de monitorizare Service Desk
Eventlogs (folder)	Folderul creat în cazul unei excepții fatale sau neletale. Conține fișiere text de raportare a erorilor și jurnale eveniment pentru aplicații și pentru sistemul Windows.
ExitReport.txt	Jurnal de ieșire creat în cazul unei excepții fatale sau neletale. Conține informații despre starea procesului, cum ar fi numele mașinii, versiunea Unified Service Desk, ID-ul procesului, codul de ieșire și ora ieșirii.
MachineHealthReport.txt	Jurnal de ieșire creat în cazul unei excepții fatale sau neletale. Conține informații despre starea sistemului, cum ar fi procesorul computerului, sistemul de operare, detalii despre monitor, limba și versiunea browserului.
ProcessReport.csv	Jurnal de ieșire creat în cazul unei excepții fatale sau neletale. Oferă o listă completă a tuturor proceselor care rulau în sistem la momentul excepției.
RegistryLog.txt	Jurnal de ieșire creat în cazul unei excepții fatale sau neletale. Include o copie bazată pe text a subcheilor de registry Windows pentru Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_datăși oră.dmp	Creat numai în cazul unei excepții fatale netratate sau atunci când este invocat manual, folosind combinația de taste pentru opțiunea globală ManualDumpShortcut. Oferă un fișier dump de memorie completă pentru UnifiedServiceDesk.exe. Observați că, pentru a vizualiza fișierul dump, aveți nevoie Visual Studio sau de alt instrument de vizualizare a fișierelor dump Windows.

Configurați raportarea diagnosticelor pentru erori

Conectarea la administrator Unified Service Desk.
Selectați Auditare și diagnosticare sub Setări complexe.
Selectați + Nou, apoi selectați DiagnosticsConfiguration.
Selectați sau introduceți valorile dorite, cum ar fi urmărirea, monitorizarea ieșirii și locația folderului cu jurnalele de diagnosticare. Informații suplimentare: Diagnosticare
Selectați Salvare și închidere.