Konfigurere logføring af klientdiagnosticering i Unified Service Desk

Artikel
05/15/2017

Udgivet: november 2016

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

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 Dynamics 365.
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.

Dette emne indeholder

Konfigurere Unified Service Desk-klientlogføring af diagnosticering

Diagnosticeringslogkilder

Niveauer af logføring af diagnosticering

Diagnosticeringslogfil for lyttefunktion

Få vist diagnosticeringslogfilen

Unified Service Desk-overvågningsproces

Rapportering for fejldiagnostik

Konfigurere Unified Service Desk-klientlogføring af diagnosticering

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.Flere oplysninger: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. Yderligere oplysninger: MSDN: Konfigurere udvidet logføring af diagnosticering for brugerdefinerede tilknyttede kontrolelementer

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. Yderligere oplysninger: MSDN: 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:\Program Files\Microsoft Dynamics 365 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 Diagnosticeringslogkilder senere i dette emne.
- Du kan finde oplysninger om de værdier, du kan angive for hver logføringskilde, under Niveauer af logføring af diagnosticering 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:\Brugere\<Brugernavn>\AppData\Roaming\Microsoft\UnifiedServiceDesk\<Version>, og USDDebugListener opretter hændelser på fanen MSDN: fanen Fejlfindingsoutoput i fejlfindingsprogrammets tilknyttede kontrolelement.

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 til Dynamics 365. Denne kilde rapporterer generelle eller detaljerede diagnosticeringsoplysninger om logonproceduren.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Logkilde for alle Dynamics 365-interaktioner på dataniveau. Denne kilde rapporterer alle interaktioner med Dynamics 365, undtagelser og tidsindstillinger.
Microsoft.Xrm.Tooling.WebResourceUtility	Logkilde for anmodninger om webressourcedata via Dynamics 365-interface link.
Microsoft.Crm.UnifiedServiceDesk	Logkilde til kernefunktioner i Unified Service Desk. 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:Konfigurere klient cachelagring i Unified Service Desk

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.

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ærkning
ActivityTracing findes kun i 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:

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 klasse TraceListener. 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, findes på følgende placering på klientcomputeren c:\Users\<Brugernavn>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version>. Filen bruges til at registrere operationelle fejl 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.

Bemærkning
Den fejlhåndtering og logføring, der beskrives her, blev først introduceret i Unified Service Desk 2.2.1.

Her er et eksempel på undtagelsesdetaljer, der logges.

Microsoft.Crm.UnifiedServiceDesk.Dynamics	Fejl	2	27/12/2016 kl. 11:54:15  Oprindelse:AppdomianUnhandledException, IsFatal:True Kilde: DemoControl Mål: Void throwExceptionMethod()-undtagelse: Undtagelse i StackTrace for brugerdefineret kontrolelement: på DemoControl.USDControl.throwExceptionMethod() på System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback-tilbagekald, Object-tilstand, boolesk preserveSyncCtx) på System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback-tilbagekald, Object-tilstand, boolesk preserveSyncCtx) på System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback-tilbagekald, Object-tilstand) på 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.

Bemærkning
De funktioner til rapportering for fejldiagnosticering, der beskrives her, blev først introduceret i Unified Service Desk 2.2.2.

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.Flere oplysninger:Configure client diagnostic logging in Unified Service Desk
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:Unified Service Desk-overvågningsproces
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 Microsoft Visual Studio, eller et andet værktøj til visning af Windows-dumpfiler.

Konfigurere rapportering for fejldiagnosticering

I webprogrammet skal du gå til Indstillinger > Unified Service Desk > Indstillinger.
Klik på Ny, og vælg derefter DiagnosticsConfiguration.
Angiv en eller flere værdier, der er anført i tabellen nedenfor, adskilt med et semikolon (;).Flere oplysninger:Funktionsværdier for rapportering af fejldiagnosticering

F.eks. vil denne konfiguration ændre mappen til logfiler, reducere den maksimale størrelse på diagnosticeringslogmappe til 2 GB og ændre genvejstastekombinationen for at fremkalde et anmodet crashdump til CTRL+ALT+D.
Klik på Gem og luk.

Funktionsværdier for rapportering af fejldiagnosticering

Rapporteringsindstillinger for fejldiagnosticering konfigureres ved hjælp af den globale funktion DiagnosticsConfiguration. De tilgængelige værdier for DiagnosticsConfiguration er beskrevet her.

Værdinavn	Værditype	Beskrivelse
EnableExitMonitoring	true/false	Standardværdien er "true", og både diagnosticeringslogfiler og afslutningslogfiler indsamles i tilfælde af en undtagelse. Hvis værdien er angivet til false, bliver hverken diagnosticeringslogfiler eller afslutningslogfiler indsamlet under en undtagelse for Unified Service Desk-klienten.
EnableCrashMonitoring	true/false	Standardværdien er "true", og dumpfiler indsamles under en alvorlig undtagelser for Unified Service Desk-klienten. Hvis værdien er angivet til "false", indsamles der ingen dumpfiler under en undtagelse for Unified Service Desk-klienten. Hvis EnableCrashMonitoring er angivet til "false", og EnableExitMonitoring er angivet til "true", indsamles både diagnosticeringslogfiler og afslutningslogfiler, men dumpfilerne indsamles ikke.
LogsDirectory	streng	Angiver den fulde sti til den mappe, hvor diagnosticeringsfiler til undtagelser opbevares. Hvis stien er ugyldig eller utilgængelig, anvender Unified Service Desk standardmappen. Som standard er mappen %APPDATA%\Roaming\Microsoft\Microsoft Dynamics® 365 Unified Service Desk\<version>\Diagnostics\.
MaxDiagnosticLogsSize	heltal	Angiver maksimumstørrelsen i MB på den mappe, hvor diagnosticeringsfilerne opbevares. Standardstørrelsen er 5 GB (5000 MB). Når MaxDiagnosticLogsSize overskrides, slettes de ældste logfilmapper, indtil MaxDiagnosticLogsSize ikke længere er overskredet. Bemærk, at mappen til de nyeste logfiler ikke slettes, selvom den er større end MaxDiagnosticLogsSize.
ManualDumpShortcut	streng	Angiver den genvejstast, der bruges til at aktivere manuel oprettelse af en dumpfil. Standardtastekombinationen er CTRL+ALT+a. Hvis du vil ændre standardindstillingen, skal du bruge formularen tast1+tast2+tast3.

Se også

Konfigurere overvågning og diagnosticering i Unified Service Desk
Fejlfinding af Unified Service Desk
MSDN: Fejlfinding af problemer i Unified Service Desk

Unified Service Desk 2.0

Del via

Konfigurere logføring af klientdiagnosticering i Unified Service Desk

Dette emne indeholder

Konfigurere Unified Service Desk-klientlogføring af diagnosticering

Diagnosticeringslogkilder

Niveauer af logføring af diagnosticering

Diagnosticeringslogfil for lyttefunktion

Få vist diagnosticeringslogfilen

Unified Service Desk-overvågningsproces

Rapportering for fejldiagnostik

Mapper og filer, der er oprettet under en undtagelse

Konfigurere rapportering for fejldiagnosticering

Funktionsværdier for rapportering af fejldiagnosticering

Se også

Yderligere ressourcer