Hvordan du kan konfigurere klientdiagnoselogging

Artikkel
04/19/2023

Du kan konfigurere diagnoselogging av klient i Unified Service Desk på to måter:

Ved hjelp av en oppføring for innstilling for sporing av endringer og diagnose, som opprettes og administreres i Unified Service Desk-området i Microsoft Dataverse.
Ved å endre filen UnifiedServiceDesk.exe.config manuelt. Denne filen må deretter distribueres til hver stasjonære datamaskin der du vil ha diagnoselogging av klienten i Unified Service Desk.

I tillegg kan du konfigurere diagnoselogging spesielt for unntak som kan forekomme i Unified Service Desk-klienten.

Konfigurere diagnoselogging av Unified Service Desk-klient

Denne delen beskriver hvordan du konfigurerer diagnoselogging i Unified Service Desk. I stedet for å bruke fremgangsmåten som er beskrevet her, anbefaler vi du bruker funksjonen Innstillinger for sporing av endringer og diagnose som gir sentralisert administrasjon av diagnostikk og muligheten til å koble til en egendefinert lytter. Mer informasjon: Konfigurere sporing av endringer og diagnose i Unified Service Desk

Viktig

Den manuelt konfigurerte diagnostiseringen (som beskrevet her), vil ikke lenger fungere når du har aktivert en oppføring for Innstillinger for sporing av endringer og diagnose som er konfigurert for diagnostisering.
Unified Service Desk inneholder også en API som lar deg konfigurere rik diagnoselogging for egendefinerte driftede kontroller. Mer informasjon: Konfigurer forbedret diagnoselogging for egendefinerte driftede kontroller

Dette emnet beskriver hvordan du endrer egenskaper for logging av klienten.

Du kan aktivere logging med filen UnifiedServiceDesk.exe.config, som er tilgjengelig i installasjonsmappen for Unified Service Desk-klienten på datamaskinen. Slik konfigurerer du typen logging og plasseringen til loggfilen for Unified Service Desk:

Åpne filen UnifiedServiceDesk.exe.config for redigering. Hvis du har installert Unified Service Desk-klienten på standardplasseringen, er denne filen vanligvis tilgjengelig i C:\Programfiler\Microsoft Dynamics 365 Customer Engagement USD\USD.

Gå til <switches>-delen 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>

Angi en loggingskilde (for eksempel EventTopicSwitch) i <switches>-delen, og angi deretter en verdi for loggingsnivå (for eksempel Error). <switches>-delen styrer loggingsnivåene for ulike kilder. Feillogging er som standard aktivert for alle bryterne:
- Hvis du vil ha informasjon om tilgjengelige loggingskilder, kan du se Tilgjengelige loggkilder senere i dette emnet.
- Hvis du vil ha informasjon om verdiene du kan angi for hver loggingskilde, kan du se Loggingsnivåer senere i dette emnet.

Hvis du vil konfigurere plasseringen, den maksimale filstørrelse og byttevirkemåten til loggfilene, går du til <shareListeners>-delen 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>

<sharelisteners>-delen styrer plasseringen til og typen logger som genereres for Unified Service Desk. fileListener oppretter som standard en fil kalt UnifiedServiceDesk.log i mappen c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version>, og USDDebugListener oppretter hendelser i kategorien Feilsøk utdata i den driftede kontrollen Feilsøkingsprogram.

Hvis du vil endre plasseringen til filen UnifiedServiceDesk.log, endrer du verdien til parameteren Location.
Som standard opprettes en ny Unified Service Desk-logg etter at filstørrelsen på den gjeldende loggfilen overskrider 52,42 MB. Som standard vedlikeholdes opptil 10 loggfiler samtidig før den eldste loggfilen slettes.
- Hvis du vil endre den maksimale Unified Service Desk-loggfilstørrelsen, endrer du verdien, i byte, for parameteren MaxFileSize.
- Hvis du vil endre antall logger som vedlikeholdes før den eldste loggen slettes, kan du endre verdien for parameteren MaxFileCount. Hvis null (0) brukes, deaktiveres byttelogging og alle Unified Service Desk-klientlogger som er opprettet, vil bli lagret.
Fillogging og logging for feilsøkingsprogram er som standard aktivert for alle kilder. Hvis du vil legge til eller fjerne en lytter i en diagnosekilde, finner du den nødvendige kilden i <sources>-delen, og deretter endrer du <listeners>-delen i kilden ved å legge til ønsket lytter.

Hvis du for eksempel vil legge til hendelseslogging for Unified Service Desk, legger du til lytteren for hendelseslogging i 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>  
```
Nå rapporteres hendelser til hendelsesloggen for Windows med koden «USD», i tillegg til filen og feilsøkingsprogrammet. Hvis du vil ha mer informasjon om diagnoselyttere, kan du se Diagnoselogglyttere senere i dette emnet.

Diagnoseloggkilder

Vanlige kilder for feilsøkingslogg er oppført i tabellen nedenfor.

Kildenavn	Bekrivelse
EventTopicSwitch	Detaljert loggingskilde for UII (User Interface Integration) for overvåking av meldingstrafikk i UII.
Microsoft.Uii.Common.Logging	Generell UII-loggkilde for meldinger som rapporteres av UII.
Microsoft.Xrm.Tooling.CrmConnectControl	Loggkilde for påloggingsprosessen. Denne kilden rapporterer generell eller detaljert diagnoseinformasjon om fremgangsmåten for pålogging.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Loggkilde for alle Dataverse-interaksjoner på datanivå. Denne kilden rapporterer alle interaksjoner med Dataverse, unntak og tidsberegninger.
Microsoft.Xrm.Tooling.WebResourceUtility	Loggkilde for forespørsler om webressursdata via Dataverse-grensesnittkoblingen.
Microsoft.Crm.UnifiedServiceDesk	Loggkilde for kjernefunksjonaliteten til Unified Service Desk. Denne loggkilden rapporterer handlinger og hendelser som er i kjernen i Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Loggkilde for oppstarts- og innlastingsprosessoren for Unified Service Desk. Denne kilden rapporterer handlinger og hendelser som er en del av initialisering og oppstart av UII og Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Loggkilde for handlinger som kommuniserer med UserProfile-systemet. Dette er en del av hurtigbufringssystemet. Mer informasjon: Konfigurere klienthurtigbufring for agentprogrammet

Du kan veksle hver av disse loggkildene uavhengig av hverandre for å støtte feilsøking og isolering av problemer eller informasjon i Unified Service Desk.

Diagnoseloggingsnivåer

Det finnes flere ulike loggingsnivåer du kan bruke. Når du øker loggingsnivået, blir imidlertid mer data generert og lagret i loggfilene.

Loggnivå	Beskrivelse
Av	Deaktiverer alle hendelser fra denne kilden.
Feil	Rapporterer bare feilhendelser.
Advarsel!	Rapporter hendelser av typen feil og advarsel.
Informasjon	Rapporter hendelser av typen feil, advarsel og informasjon.
Detaljert	Rapporter hendelser av typen feil, advarsel, informasjon og detaljert.
ActivityTracing	Rapporterer hendelser av typen feil, advarsel, informasjon og detaljert samt aktivitetssporing (metodenavn). Obs! ActivityTracing er bare tilgjengelig i noen av kildene.
Alle	Rapporterer alle hendelser som utløses av systemet.

Diagnoselogglyttere

Diagnoselogglyttere brukes til å sende diagnoseloggutdataene til filer, hendelsesloggen eller andre kilder. Alle diagnosekilder er som standard knyttet til både standardlytteren (Feilsøkingsprogram) og fillytteren (tekst). Du kan konfigurere flere logglyttere for diagnoselogging for Unified Service Desk. Hvis du vil ha mer informasjon om standard .NET-lyttere, kan du se følgende:

MSDN:DefaultTraceListener
MSDN:EventLogTraceListener
MSDN:TextWriterTraceListener

Du kan også opprette egendefinerte lyttere for å sende diagnoselogger til en plassering du velger. Du oppretter egendefinerte lyttere ved å avlede en klasse fra den abstrakte klassen MSDN:TraceListener. Du kan finne en gjennomgang av fremgangsmåten på CodeGuru.com.

Vise diagnoseloggfilen

Diagnoselogging er som standard aktivert for Unified Service Desk-klientprogrammet. En loggfil, UnifiedServiceDesk-<date>.log, er tilgjengelig på c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> på klientdatamaskinen som brukes til å registrere driftsfeil i klientprogrammet. Loggfilen opprettes første gang det oppstår feil i klientprogrammet.

Når det oppstår en feil i en driftet kontroll, vil informasjonen i loggfilene gi detaljert informasjon om unntaket, for eksempel den opprinnelige driftede kontrollen som forårsaket unntaket samt unntaksdetaljer. Legg merke til at hele JavaScript-koden som forårsaket unntaket ikke er logget. Bare feilkoden og beskrivelsen av unntaket er logget.

Her er et eksepel på en unntaksdetalj som er logget.

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

Overvåkingsprosess i Unified Service Desk

Overvåkingsprosess (usdmp.exe) i Unified Service Desk er en tjeneste som kontinuerlig overvåker tilstanden til Unified Service Desk, og avslutter (som standard etter 5 sekunder) alle nettleserprosessforekomster som ikke svarer og fører til at Unified Service Desk ikke svarer. Hvis en leserprosessforekomst ikke svarer, men Unified Service Desk svarer, blir ikke leserprosessforekomsten avsluttet. Hvis du vil ha mer informasjon om hvordan du endrer varigheten for det globale alternativet ProcessTerminationThreshold for avslutning av leserprosessen, kan du se Administrere alternativer for Unified Service Desk.

Rapportering av feildiagnostikk

Detaljert og omfattende logging og rapportering som oppstår under en komponent-, program- eller systemfeil, kan bidra til å identifisere når og hvordan feilen oppstod. I tillegg til standardlogging av diagnostikk registrerer rapportering av feildiagnostikk informasjon om system- og programstatus i tilfelle det oppstår et unntak i Unified Service Desk-klienten. Du finner mer informasjon om unntak i Slik håndterer Unified Service Desk feil program- og systemfeil.

Mapper og filer som er opprettet under et unntak

Hvis det oppstår et unntak, oppretter rapportering av feildiagnostikk en mappe på den lokale datamaskinen med navnet DiagnosticsLogs_dato og klokkeslett, der dato og klokkeslett er i formatet år-måned-dato_klokkeslett, for eksempel DiagnosticLogs_20170322_173643. I mappen DiagnosticsLogs opprettes følgende mapper og filer.

Diagnosefil	Beskrivelse
UnifiedServiceDesk_dateandtime.log	Standard diagnoselogg som opprettes og legges ved når Unified Service Desk-klienten kjører. Filen inneholder loggingsinformasjon for Unified Service Desk-klienten (UnifiedServiceDesk.exe). Gjeldende filer flyttes til mappen DiagnosticsLogs hvis det oppstår et unntak.
UnifiedServiceDeskMonitoring_dato.log	Standard diagnoselogg som opprettes og legges ved når Unified Service Desk-klienten kjører. Inneholder loggingsinformasjon for Unified Service Desk-overvåkingsprosessen (usdmp.exe), som er en prosess som overvåker tilstanden til Unified Service Desk-klienten. Gjeldende filer flyttes til mappen DiagnosticsLogs hvis det oppstår et unntak. Mer informasjon: Overvåkingsprosess i Unified Service Desk
EventLogs (mappe)	Mappen som opprettes i tilfelle det oppstår et kritisk eller ikke-kritisk unntak. Inneholder Windows-system og programhendelseslogger og tekstfiler med feilrapportering.
ExitReport.txt	Avslutningslogg som opprettes i tilfelle det oppstår et kritisk eller ikke-kritisk unntak. Inneholder statusinformasjon for prosessen som maskinnavn, Unified Service Desk-versjon, prosess-id, avslutningskode og tidspunktet for avslutning.
MachineHealthReport.txt	Avslutningslogg som opprettes i tilfelle det oppstår et kritisk eller ikke-kritisk unntak. Inneholder informasjon om systemtilstand, for eksempel dataprosessor, operativsystem, detaljer for skjerm, språk og nettleserversjon.
ProcessReport.csv	Avslutningslogg som opprettes i tilfelle det oppstår et kritisk eller ikke-kritisk unntak. Gir en omfattende liste over alle prosesser som ble kjørt på systemet da unntaket oppstod.
RegistryLog.txt	Avslutningslogg som opprettes i tilfelle det oppstår et kritisk eller ikke-kritisk unntak. Inneholder en tekstbasert kopi av registerundernøklene i Windows for Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_dateandtimedmp	Opprettes bare hvis det oppstår et ubehandlet, kritisk unntak eller når den aktiveres manuelt ved hjelp av den globale tastekombinasjonen ManualDumpShortcut. Gir en fullstendig minnedumpfil for UnifiedServiceDesk.exe. Merk at hvis du vil vise dumpfilen, trenger du Visual Studio eller et annet visningsverktøy for Windows-dumpfiler.

Konfigurere rapportering av feildiagnostikk

Logg på Administrator for Unified Service Desk.
Velg Sporing av endringer og diagnose under Avanserte innstillinger.
Velg + Ny, og velg deretter DiagnosticsConfiguration.
Velg eller angi verdiene som du ønsker, for eksempel sporing, avslutt overvåking og plassering av diagnoseloggmappen. Mer informasjon: Diagnose
Velg Lagre og lukk.