Cum puteți configura jurnalul de diagnostic al clientului

Articol
02/03/2022
10 minute de lectură

Există două modalități de a configura înregistrarea în jurnal a diagnosticelor de client Unified Service Desk:

Folosind o înregistrare Setări de auditare și diagnosticare creată și gestionată în zona Unified Service Desk din Microsoft Dataverse.
Modificând manual fișierul UnifiedServiceDesk.exe.config. Acest fișier trebuie distribuit pe fiecare desktop în care doriți înregistrarea în jurnal a diagnosticelor de client 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: Configurați auditarea și diagnosticele în Unified Service Desk

Wichtig

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ă și un API care vă permite să configurați înregistrări bogate în jurnalul de diagnosticare pentru controalele particularizate găzduite. Informații suplimentare: Configurare înregistrare îmbunătățită în jurnal a diagnosticării pentru controalele particularizate găzduite

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

Puteți să activați înregistrarea în jurnal cu fișierul UnifiedServiceDesk.exe.config, care este disponibil în directorul de instalare client Unified Service Desk 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 la locația implicită, acest fișier va fi disponibil de obicei 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 în jurnal (cum ar fi EventTopicSwitch), apoi specificați o valoare de nivel de înregistrare în jurnal (cum ar fi Error). 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 jurnale disponibile mai departe în acest subiect.
- Pentru informații despre valorile pe care le puteți specifica pentru fiecare sursă de înregistrare în jurnal, consultați Nivelurile de înregistrare mai departe în acest subiect.

Pentru a configura locația, dimensiunea maximă de fișier și comportamentul de revenire 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 din jurnale generate pentru Unified Service Desk. În mod implicit, fileListener va crea un fișier numit UnifiedServiceDesk.log în directorul c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> și USDDebugListener va crea evenimente în fila rezultat Depanare a controlului găzduit de Depanator.

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 schimba dimensiunea maximă a fișierelor jurnal Unified Service Desk, modificați valoarea în baiți a parametrului MaxFileSize.
- Pentru a modifica numărul de jurnale menținute înainte ca jurnalul cel mai vechi să fie șters, modificați valoarea parametrului MaxFileCount. Dacă se utilizează valoarea zero (0), înregistrarea în jurnal de revenire va fi dezactivată și toate jurnalele 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 listener la/de la o sursă de diagnosticare, găsiți sursa necesară în secțiunea <sources>, apoi modificați secțiunea <listeners> a sursei pentru a include listenerul pe care îl doriți.

De exemplu, pentru a adăuga înregistrarea în jurnal a evenimentelor pentru Unified Service Desk, adăugați listenerul de înregistrare în jurnal a evenimentelor la sursa 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>  
```
Acest lucru va raporta acum evenimentele la jurnalul de evenimente Windows cu eticheta "USD", pe lângă fișier și depanator. Pentru informații suplimentare despre listenerele de diagnosticare, consultați Listenerele jurnalelor 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ă detaliată de înregistrare în jurnal User Interface Integration (UII) pentru monitorizarea traficului de mesaje în 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 înregistrare în jurnal pentru funcționalitatea Unified Service Desk de bază. Această sursă de înregistrare în jurnal va raporta acțiuni și evenimente care sunt de bază pentru Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Sursă de înregistrare în jurnal pentru secvența de inițializare și procesorul de încărcare Unified Service Desk. Această sursă va raporta acțiunile și evenimentele care face fac parte din inițializarea și pornirea UII și din 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: Configurați memorarea în cache a clientului pentru aplicația de agent

Puteți să comutați fiecare dintre aceste surse de jurnal în mod independent pentru a accepta depanarea și izolarea problemelor sau informațiilor în interiorul 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ă: Urmărirea activităților este disponibilă doar 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 listeneri 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. Listenerele personalizate sunt create prin derivarea unei clase de la 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 în jurnal a 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 computerul client pentru a înregistra erori 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 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țe de proces de browser care nu răspund și determină Unified Service Desk să nu răspundă. În cazul în care o instanță de proces a browserului nu răspunde, dar Unified Service Desk răspunde, instanța de proces a browserului nu va fi încheiată. Pentru mai multe informații despre cum se schimbă durata opțiunii globale ProcessTerminationThreshold pentru încheierea proceselor de browser, 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. Pe lângă înregistrarea în jurnal standard a diagnosticelor, raportarea diagnosticelor de eroare înregistrează informațiile despre starea sistemului și a aplicațiilor, î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 diagnosticelor de eroare creează un folder pe computerul local numit DiagnosticsLogs_ data și ora, unde data și ora au forma an-lună-dată_oră, de exemplu 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, creat și adăugat atunci când rulează clientul Unified Service Desk. Fișierul conține informații de jurnal 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, creat și adăugat atunci când rulează clientul Unified Service Desk. Conține informații de jurnal pentru procesul de monitorizare Unified Service Desk (usdmp.exe), 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 de monitorizare 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 dispozitivului, 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_ 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 dump, aveți nevoie de Visual Studio sau 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 avansate.
Selectați + Nou și 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: Diagnostic
Selectați Salvare și închidere.

Consultați și

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

Suport pentru depanare în Unified Service Desk pentru depanarea problemelor

Depanarea problemelor din Unified Service Desk

Hinweis

Ne puteți spune care preferințele dvs. lingvistice pentru documentație? Răspundeți la un chestionar scurt. (rețineți că acest chestionar este în limba engleză)

Chestionarul va dura aproximativ șapte minute. Nu sunt colectate date personale (angajament de respectare a confidențialității).