Cum puteți configura jurnalul de diagnostic al clientului

Articol
06/04/2024

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

Prin utilizarea unui Audit & Înregistrarea setărilor de diagnosticare care este creată și gestionată în zona Unified Service Desk a Microsoft Dataverse.
Modificând manual fișierul UnifiedServiceDesk.exe.config. Acest fișier trebuie apoi distribuit pe fiecare desktop unde doriți înregistrarea de diagnosticare a clientului Unified Service Desk.

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

Configurați înregistrarea de diagnosticare a clientului Unified Service Desk

Această secțiune descrie cum să configurați manual înregistrarea de diagnosticare î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. Mai multe informații: Configurați auditarea și diagnosticarea î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 jurnalizarea de diagnosticare bogată pentru controale personalizate găzduite. Mai multe informații: Configurați înregistrarea de diagnosticare îmbunătățită pentru comenzile găzduite personalizate

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

Puteți activa înregistrarea cu fișierul UnifiedServiceDesk.exe.config , care este disponibil în directorul de instalare a clientului Unified Service Desk de pe computer. Pentru a configura tipul de înregistrare ș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 de obicei disponibil la C:\Program Files\Microsoft Dynamics 365 Customer Engagement USD\USD.

Accesați secțiunea <switches> din 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țiunea <switches> , specificați o sursă de înregistrare (cum ar fi EventTopicSwitch), apoi specificați o valoare a nivelului de înregistrare (cum ar fi Error). Secțiunea <switches> controlează nivelurile de înregistrare pentru diverse surse. În mod implicit, înregistrarea în jurnal a erorilor este activată pentru toate comutatoarele.
- Pentru informații despre sursele de jurnal disponibile, consultați Surse de jurnal disponibile mai târziu în acest subiect.
- Pentru informații despre valorile pe care le puteți specifica pentru fiecare sursă de înregistrare, consultați Nivelurile de înregistrare mai târziu în acest subiect.

Pentru a configura locația, dimensiunea maximă a fișierului și comportamentul de transfer al fișierelor jurnal, accesați secțiunea <shareListeners> din 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 jurnalelor care sunt generate pentru Unified Service Desk. În mod implicit, fileListener va crea un fișier numit UnifiedServiceDesk.log în c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> director și USDDebugListener va crea evenimente în fila Debug output a controlului găzduit Debugger.

Dacă doriți să schimbați locația fișierului UnifiedServiceDesk.log , modificați valoarea parametrului Location .
În mod implicit, un nou jurnal Unified Service Desk este creat 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 ca cel mai vechi jurnal să fie șters, modificați valoarea parametrului MaxFileCount . Dacă se folosește zero (0), înregistrarea de transfer va fi dezactivată și toate jurnalele clientului 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, localizați sursa necesară în secțiunea <sources> și apoi modificați secțiunea <listeners> a sursei pentru a include ascultătorul dorit. .

De exemplu, pentru a adăuga înregistrarea evenimentelor pentru Unified Service Desk, adăugați ascultătorul de înregistrare 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>  
```
Acest lucru va raporta acum evenimente în jurnalul de evenimente Windows cu eticheta „USD”, în plus față de fișier și Debugger. Pentru mai multe informații despre ascultătorii de diagnosticare, consultați Ascultătorii de jurnal de diagnosticare mai târziu î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ă de înregistrare detaliată pentru integrarea interfeței utilizator (UII) pentru monitorizarea traficului de mesagerie din interiorul 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țiunile și evenimentele care sunt esențiale către Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Sursa de jurnal pentru cureaua de pornire și procesorul de încărcare Unified Service Desk. Această sursă va raporta acțiunile și evenimentele 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. Mai multe informații: Configurați memorarea în cache a clientului pentru aplicația dvs. agent

Puteți comuta fiecare dintre aceste surse de jurnal în mod independent pentru a sprijini 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 dintre 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 de diagnosticare 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 personalizați sunt creați prin derivarea unei clase din clasa abstractă MSDN:TraceListener . Puteți găsi o prezentare a procesului pe CodeGuru.com.

Vizualizarea fișierului jurnal de diagnosticare

În mod implicit, înregistrarea diagnosticelor este activată pentru aplicația client Unified Service Desk. Un fișier jurnal, UnifiedServiceDesk-<date>.log, este disponibil la c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> pe computer client pentru a înregistra erorile operaționale în aplicația client. 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 a Unified Service Desk (usdmp.exe) este un serviciu care monitorizează continuu starea de sănătate a Unified Service Desk și oprește, în mod implicit, după 5 secunde, orice instanță de proces de browser care nu răspunde și care face ca Unified Service Desk să nu mai răspundă. Dacă o instanță de proces de browser nu răspunde, dar Unified Service Desk răspunde, instanța de proces de browser nu va fi terminată. Pentru mai multe informații despre cum să modificați durata opțiunii globale ProcessTerminationThreshold pentru terminarea procesului de browser, consultați Gestionați opțiunile 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. Pe lângă înregistrarea standard de diagnosticare, raportarea diagnosticării erorilor înregistrează informații despre starea sistemului și a 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 de diagnosticare a erorilor creează un folder pe computerul local numit DiagnosticsLogs_data și ora, unde data și ora sunt sub forma year-month-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_dateandtime.log	Jurnal de diagnosticare standard care este creat și atașat atunci când clientul Unified Service Desk rulează. Fișierul conține informații de înregistrare pentru clientul Unified Service Desk (UnifiedServiceDesk.exe). Fișierele curente sunt mutate în folderul DiagnosticsLogs în cazul unei excepții.
UnifiedServiceDeskMonitoring_data.log	Jurnal de diagnosticare standard care este creat și atașat atunci când clientul Unified Service Desk rulează. Conține informații de înregistrare pentru procesul de monitorizare a Unified Service Desk (usdmp.exe), care este un proces care monitorizează starea de sănătate a clientului Unified Service Desk. Fișierele curente sunt mutate în folderul DiagnosticsLogs în cazul unei excepții. Mai multe informații: Procesul de monitorizare a Unified 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 de ieșire.
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 registru Windows pentru Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_dateandtime.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 de descărcare, aveți nevoie de Visual Studio sau alt instrument de vizualizare a fișierului de descărcare din Windows.

Configurați raportarea diagnosticelor pentru erori

Conectarea la administrator Unified Service Desk.
Selectați Audit și diagnosticare sub Setări avansate.
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. Mai multe informații: Diagnosticare
Selectați Salvare & Închide.

Consultați și

Configurați auditarea și diagnosticarea în Unified Service Desk

Asistență pentru depanare în Unified Service Desk pentru a depana problemele

Depanați problemele în Unified Service Desk

Partajați prin