Sådan konfigureres logføring af klientdiagnosticering

Artikel
04/19/2023

Der er to måder, du kan konfigurere Unified Service Desk-klientlogføring af diagnosticering på:

Ved hjælp af en post til Indstillinger for overvågning og diagnose, der oprettes og administreres i Unified Service Desk-området til Microsoft Dataverse.
Ved manuelt at foretage ændringe i filen UnifiedServiceDesk.exe.config. Denne fil skal derefter distribueres til hver enkelt computer, hvor du ønsker Unified Service Desk-klientlogføringen af diagnosticering.

Derudover kan du konfigurere diagnostisk logføring kun for undtagelser, der kan opstå på Unified Service Desk-klienten.

Konfigurere logføring af klientdiagnosticering i Unified Service Desk

Dette afsnit beskriver, hvordan du manuelt konfigurerer diagnostisk logføring i Unified Service Desk. I stedet for at bruge den fremgangsmåde, der er beskrevet her, anbefaler vi at du bruger funktionen Indstillinger for overvågning og diagnose, som giver centraliseret administration af diagnosticering og muligheden for at oprette forbindelse til en brugerdefineret lytter. More information: Konfigurere overvågning og diagnosticering i Unified Service Desk

Vigtigt

Den manuelt konfigurerede diagnosticering (som beskrevet her), fungerer ikke længere, når du har aktiveret en Indstillinger for overvågning og diagnose-post, der er konfigureret til diagnosticering.
Unified Service Desk indeholder også en API, så du kan konfigurere omfattende logføring af diagnosticering for brugerdefinerede tilknyttede kontrolelementer. Flere oplysninger: Konfigurere udvidet logføring af diagnosticering for brugerdefinerede tilknyttede kontrolelementer

Dette emne beskriver, hvordan du kan ændre egenskaber for logføring af klienten.

Du kan aktivere logføring ved hjælp af UnifiedServiceDesk.exe.config-filen, der findes i Unified Service Desk-klientinstallationsmappen på computeren. Sådan konfigurerer du typen af logføring og placeringen af Unified Service Desk-logfilen:

Åbn UnifiedServiceDesk.exe.config-filen til redigering. Hvis du har installeret Unified Service Desk-klienten på standardplaceringen, vil denne fil typisk kunne findes i C:\Programmer\Microsoft Dynamics 365 Customer Engagement USD\USD.

Gå til afsnittet <switches> i filen:

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

I afsnittet <switches> skal du angive en kilde til logføring (f.eks. EventTopicSwitch) og derefter angive en værdi for logføring (f.eks. Error). Afsnittet <switches> styrer logføringsniveauer for forskellige kilder. Logføring af fejl er som standard aktiveret for alle switches.
- Du kan finde oplysninger om de tilgængelige logføringskilder under Tilgængelige logkilder senere i dette emne.
- Du kan finde oplysninger om de værdier, du kan angive for hver logføringskilde, under Logføringsniveauer senere i dette emne.

Hvis du vil konfigurere lokationen, den maksimale filstørrelse og funktionsmåde i overgange for logfilerne, skal du gå til afsnittet <shareListeners> i filen.

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

Afsnittet <sharelisteners> styrer placeringen og typen af logfiler, der oprettes for Unified Service Desk. Som standard opretter fileListener en fil kaldet UnifiedServiceDesk.log i biblioteket c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version>, og USDDebugListener opretter hændelser under fanen Fejlfindingsoutput i det tilknyttede fejlfindingskontrolelement.

Hvis du vil ændre placeringen af UnifiedServiceDesk.log-filen, skal du ændre værdien af Location-parameteren.
Som standard oprettes der en ny Unified Service Desk-logfil, når størrelsen på den aktuelle logfil overskrider 52,42 MB. Som standard bevares op til 10 logfiler på én gang, inden den ældste logfil slettes.
- Hvis du vil ændre den maksimale størrelse på Unified Service Desk-logfilen, skal du ændre værdien i byte for parameteren MaxFileSize.
- Hvis du vil ændre antallet af logfiler, der bevares, før den ældste logfil bliver slettet, skal du ændre værdien for parameteren MaxFileCount. Hvis nul (0) bruges, bliver logføring af overgange deaktiveret, og alle oprettede Unified Service Desk-klientlogfiler gemmes.
Som standard aktiveres logføring af fil og fejlfinding for alle kilder. Hvis du vil tilføje eller fjerne en lyttefunktion fra en diagnosticeringskilde, skal du finde den ønskede kilde i afsnittet <sources> og derefter redigere afsnittet <listeners> i kilden for at medtage den ønskede lyttefunktion.

For at tilføje logføring af hændelser for Unified Service Desk skal du f.eks. tilføje lyttefunktionen for logføring af hændelsen til kilden 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>  
```
Dette vil nu rapportere hændelser til Windows-hændelsesloggen med koden "USD" ud over filen og fejlfindingsprogrammet. Du kan finde flere oplysninger om diagnostiske lyttefunktioner under Diagnosticeringslogfil for lyttefunktion senere i dette emne.

Diagnosticeringslogkilder

Almindelig fejlfinding af logkilder er angivet i følgende tabel.

Kildenavn	Beskrivelse
EventTopicSwitch	Detaljeret User Interface Integration (UII)-kilde til logføring for at overvåge chattrafik i UII.
Microsoft.Uii.Common.Logging	Generel UII-logkilde for meddelelser, der er rapporteret af UII.
Microsoft.Xrm.Tooling.CrmConnectControl	Logkilde for logonprocessen. Denne kilde rapporterer generelle eller detaljerede diagnosticeringsoplysninger om logonproceduren.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Logkilde for alle Dataverse-interaktioner på dataniveau. Denne kilde rapporterer alle interaktioner med Dataverse, undtagelser og tidsindstillinger.
Microsoft.Xrm.Tooling.WebResourceUtility	Logkilde for anmodninger om webressourcedata via Dataverse-interfacelink.
Microsoft.Crm.UnifiedServiceDesk	Logfil for core Unified Service Desk-funktionalitet. Denne logkilde rapporterer handlinger og hændelser, der er centrale for Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Logkilde for Unified Service Desk-bootstrap og indlæsning af processoren. Denne kilde rapporterer handlinger og hændelser, der er en del af initialisering og start af UII og Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Logkilde for handlinger, der interagerer med systemet UserProfile. Dette er en del af caching-systemet. Flere oplysninger: Konfigurer klient-cachelagring for Helpdesk medarbejderprogrammet

Du kan skifte til hver af disse logkilder uafhængigt til understøttelse af fejlfinding og isolering af problemer eller oplysninger i Unified Service Desk.

Niveauer af logføring af diagnosticering

Der er flere forskellige logføringsniveauerne til brug. Efterhånden som du øger logføringsniveauet, oprettes der flere data, som gemmes i logfilerne.

Logføringsniveau	Beskrivelse
Fra	Deaktiverer alle hændelser fra denne kilde.
Fejl	Rapporterer kun fejlhændelser.
Advarsel!	Rapporterer fejl- og advarselshændelser.
Oplysninger	Rapporterer hændelser om fejl, advarsler og oplysninger.
Detaljeret	Rapporterer hændelser om fejl, advarsler, oplysninger og detaljer.
ActivityTracing	Rapporterer hændelser om fejl, advarsler, oplysninger og detaljer og sporing af aktivitet (metodenavne). Bemærk! ActivityTracing findes kun på nogle af kilderne.
Alle	Rapporterer alle hændelser, der udløses af systemet.

Diagnosticeringslogfil for lyttefunktion

Diagnosticeringslogfil for lyttefunktion bruges til at målrette outputtet for diagnosticeringslogfilen til filer, hændelseslogfilen eller andre kilder. Som standard er alle diagnosticeringskilder forbundet til både den traditionelle lyttefunktion (fejlfinding) og fillyttefunktionen (tekst). Du kan konfigurere yderligere logfiler for lyttefunktionen til logføring af diagnosticering for Unified Service Desk. Du kan finde flere oplysninger om .NET standardlyttefunktioner under:

MSDN:DefaultTraceListener
MSDN:EventLogTraceListener
MSDN:TextWriterTraceListener

Du kan også oprette brugerdefinerede lyttefunktioner for at sende diagnosticeringslogfiler til en placering, du vælger. Brugerdefinerede lyttefunktioner oprettes ved at aflede en klasse fra den abstrakte MSDN:TraceListener-klasse. Du kan finde en gennemgang af processen på CodeGuru.com.

Få vist diagnosticeringslogfilen

Diagnostisk logføring er som standard aktiveret for Unified Service Desk.-klientprogrammet. En logfil, UnifiedServiceDesk-<dato>.log, er tilgængelig på c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> på klientcomputeren, hvor den registrerer driftsfejl i klientprogrammet. Logfilen oprettes, første gang du har fejl i klientprogrammet.

Når der opstår en fejl i et tilknyttet kontrolelement, indeholder de oplysninger, der er logget i logfilerne, detaljerede oplysninger om undtagelsen, f.eks. det oprindelige tilknyttede kontrolelement, der forårsagede undtagelsen, sammen med detaljer om undtagelsen. Bemærk, at ikke hele den JavaScript-kode, der forårsagede undtagelsen, er logget. Kun den fejlbehæftede kode sammen med beskrivelsen af undtagelsen logges.

Her er et eksempel på undtagelsesdetaljer, der logges.

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

Unified Service Desk-overvågningsproces

Unified Service Desk-overvågningsprocessen (usdmp.exe) er en tjeneste, der løbende overvåger tilstanden for Unified Service Desk og som standard afslutter alle browserens procesforekomster efter fem sekunder, hvis de ikke svarer og bevirker, at Unified Service Desk ikke svarer. Hvis en forekomst af en browserproces ikke svarer, men Unified Service Desk svarer, bliver forekomsten af browserprocessen ikke afsluttet. Du kan finde flere oplysninger om, hvordan du kan ændre varigheden af den globale indstilling for ProcessTerminationThreshold for browserprocessens afbrydelse, i Administrere indstillinger for Unified Service Desk.

Rapportering for fejldiagnostik

Detaljerede og omfattende logføring og rapportering, der opstår under en komponentprogram- eller systemfejl, kan hjælpe med at identificere, hvornår og hvordan fejlen opstod. Ud over standardlogføring af diagnosticering registrerer fejldiagnosticeringsrapporter system- og programtilstandsoplysninger i tilfælde af en undtagelse i Unified Service Desk-klienten. Du kan finde flere oplysninger om undtagelser i Sådan håndterer Unified Service Desk program- og systemfejl.

Mapper og filer, der er oprettet under en undtagelse

I tilfælde af en undtagelse opretter rapportering for fejldiagnosticering en mappe på den lokale computer med navnet DiagnosticsLogs_dato og klokkeslæt for, hvor dato og klokkeslæt har formen år-måned-dato_klokkeslæt, f.eks. DiagnosticLogs_20170322_173643. I mappen DiagnosticsLogs oprettes i følgende mappe og filer.

Diagnosticeringsfil	Beskrivelse
UnifiedServiceDesk_dateandtime.log	Standarddiagnosticeringslogfil, der er oprettet og tilføjet, når Unified Service Desk-klienten kører. Filen indeholder oplysninger om logføring for Unified Service Desk-klienten (UnifiedServiceDesk.exe). De aktuelle filer flyttes til mappen DiagnosticsLogs i tilfælde af en undtagelse.
UnifiedServiceDeskMonitoring_dato.log	Standarddiagnosticeringslogfil, der er oprettet og tilføjet, når Unified Service Desk-klienten kører. Indeholder oplysninger om logføring for Unified Service Desk-overvågningsprocessen (usdmp.exe), som er en proces, der overvåger tilstanden for Unified Service Desk-klienten. De aktuelle filer flyttes til mappen DiagnosticsLogs i tilfælde af en undtagelse. Flere oplysninger: Overvågningsproces til Unified Service Desk
EventLogs (mappe)	Mappe, der oprettes i tilfælde af en alvorlig eller ikke-alvorlig undtagelse. Indeholder hændelses- og fejlrapporteringens tekstfiler for Windows-systemet og -programmet.
ExitReport.txt	Afslutningslogfil, der oprettes i tilfælde af en alvorlig eller ikke-alvorlig undtagelse. Indeholder procestilstandsoplysninger som f.eks. computernavnet, Unified Service Desk-version, proces-id, afslutningskode og tidspunktet for afslutningen.
MachineHealthReport.txt	Afslutningslogfil, der oprettes i tilfælde af en alvorlig eller ikke-alvorlig undtagelse. Indeholder systemtilstandsoplysninger som f.eks. computerens processor, operativsystem, skærmoplysninger, sprog og browserversion.
ProcessReport.csv	Afslutningslogfil, der oprettes i tilfælde af en alvorlig eller ikke-alvorlig undtagelse. Indeholder en omfattende liste over alle processer, der kørte på systemet, samtidig med undtagelsen.
RegistryLog.txt	Afslutningslogfil, der oprettes i tilfælde af en alvorlig eller ikke-alvorlig undtagelse. Indeholder en tekstbaseret kopi af undernøgler for Windows-registreringsdatabasen i Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_datoogklokkeslæt.dmp	Oprettes kun i tilfælde af en alvorlig undtagelse, der ikke er håndteret, eller når den fremkaldes manuelt ved hjælp af den globale tastaturkombination for funktionen ManualDumpShortcut. Indeholder en dumpfil til lagring af hele hukommelsen for UnifiedServiceDesk.exe. Bemærk, at du kan få vist den dumpfil, du har brug for Visual Studio, eller et andet værktøj til visning af Windows-dumpfiler.

Konfigurere rapportering for fejldiagnosticering

Log på Unified Service Desk Administrator.
Vælg Overvågning og diagnosticering under Avancerede indstillinger.
Vælg + Ny, og vælg derefter DiagnosticsConfiguration.
Vælg eller angiv de værdier, du vil, f.eks. sporing, afslut overvågning og placeringen af mappen med diagnosticeringslogfiler. Flere oplysninger: -analyse
Vælg Gem og luk.