Procedure voor het configureren van diagnostische logboekregistratie voor clients

Artikel
01/22/2025

U kunt logboekregistratie van cliëntdiagnose in Unified Service Desk op twee manieren configureren:

Door gebruik te maken van een Controle- en diagnose-instellingenrecord die is gemaakt en wordt beheerd in het Unified Service Desk-gebied van Microsoft Dataverse.
Door handmatig wijzigingen aan te brengen aan het UnifiedServiceDesk.exe.config-bestand. Dit bestand moet dan naar elk bureaublad worden gedistribueerd waar u logboekregistratie van cliëntdiagnose in Unified Service Desk wilt uitvoeren.

Daarnaast kunt u registratie in diagnoselogboek specifiek configureren voor uitzonderingen die zich in de Unified Service Desk-client kunnen voordoen.

Diagnostische registratie voor Unified Service Desk-client configureren

In deze sectie wordt beschreven hoe u registratie in diagnoselogboek in Unified Service Desk handmatig kunt configureren. In plaats van de hier beschreven procedure te gebruiken, raden we u aan om de functie controle- en diagnose-instellingen te gebruiken die gecentraliseerd beheer van diagnostiek en de mogelijkheid om een aangepaste listener te koppelen biedt. Meer informatie: Controle en diagnostiek configureren in Unified Service Desk

Belangrijk

De handmatig geconfigureerde diagnostiek (zoals hier beschreven) werkt niet meer nadat u een controle- en diagnose-instellingen-record hebt ingeschakeld die voor diagnostiek is geconfigureerd.
Unified Service Desk biedt ook een API waarmee u rijke diagnostische logboekregistratie kunt configureren voor aangepaste gehoste besturingselementen. Meer informatie: Uitgebreide diagnostische logboekregistratie configureren voor aangepaste gehoste besturingselementen

In dit onderwerp wordt beschreven hoe u de kenmerken van de clientlogboekregistratie kunt wijzigen.

U kunt de logboekregistratie inschakelen met het bestand UnifiedServiceDesk.exe.config, dat u vindt in de directory van de Unified Service Desk-clientinstallatie op uw computer. Het type logboekregistratie en de locatie van het logbestand van Unified Service Desk configureren:

Open het bestand UnifiedServiceDesk.exe.config voor bewerking. Als u de Unified Service Desk-client op de standaardlocatie hebt geïnstalleerd, is dit bestand doorgaans beschikbaar in C:\Program Files\Microsoft Dynamics 365 Customer Engagement USD\USD.

Ga naar de sectie <switches> in het bestand:

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

Geef in het gedeelte <switches> logboekregistratiebron op (zoals EventTopicSwitch) en geef vervolgens de waarde voor het registratieniveau, zoals Error. Het gedeelte <switches> bepaalt registratieniveaus voor verschillende bronnen. Foutregistratie is standaard ingeschakeld voor alle schakelopties:
- Voor informatie over de beschikbare logboekregistratiebronnen raadpleegt u Beschikbare logboekbronnen verderop in dit onderwerp.
- Voor informatie over de waarden die u voor elke logboekregistratiebron kunt opgeven, raadpleegt u Logboekniveaus verderop in dit onderwerp.

Om de locatie, de maximale bestandsgrootte en het rollover-gedrag van de logboekbestanden te configureren, gaat u naar de sectie <shareListeners> in het bestand.

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

De sectie <sharelisteners> bepaalt de locatie en het type van de logboeken die voor Unified Service Desk worden gegenereerd. Standaard maakt fileListener een bestand genaamd UnifiedServiceDesk.log in de map c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> en maakt USDDebugListener gebeurtenissen op het tabblad Debug output van het gehoste besturingselement Debugger.

Als u de locatie van het bestand UnifiedServiceDesk.log wilt wijzigen, wijzigt u de waarde van de parameter Location.
Standaard wordt een nieuw Unified Service Desk-logboek gemaakt nadat het huidige logboekbestand groter wordt dan 52,42 MB. Standaard worden maximaal 10 logboekbestanden gelijktijdig bewaard voordat het oudste logboekbestand wordt verwijderd.
- Als u de maximale grootte van Unified Service Desk-logboekbestanden wilt wijzigen, wijzigt u de waarde (in bytes) van de parameter MaxFileSize.
- Als u het aantal logboekbestanden wilt aanpassen dat wordt bewaard voordat het oudste bestand wordt verwijderd, wijzigt u de waarde van de parameter MaxFileCount. Als u de waarde nul (0) gebruikt, wordt de rollover-logboekregistratie uitgeschakeld en worden alle gemaakte Unified Service Desk-clientlogboeken bewaard.
Standaard is bestands- en debuggerregistratie ingeschakeld voor alle bronnen. Als u een listener wilt toevoegen of verwijderen uit een diagnostische bron, zoekt u de vereiste bron in de sectie <sources> en wijzigt u vervolgens de sectie <listeners> van de bron door de gewenste listener op te nemen.

Bijvoorbeeld, om logboekregistratie voor Unified Service Desk toe te voegen, voegt u de logboekregistratielistener aan de bron Microsoft.Crm.UnifiedServiceDesk toe.
```
<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>  
```
Nu worden naast bestand- en debuggerregistratie ook gebeurtenissen in het Windows-gebeurtenislogboek gerapporteerd met de code "USD". Voor meer informatie over diagnostische listeners raadpleegt Diagnostische Logboeklisteners verderop in dit onderwerp.

Diagnostische logboekbronnen

Veelgebruikte bronnen van het probleemoplossingregistratie worden vermeld in de volgende tabel.

Bronnaam	Omschrijving
EventTopicSwitch	Gedetailleerde User Interface Integration (UII) registratiebron voor het volgen van berichtenverkeer binnen UII.
Microsoft.Uii.Common.Logging	Algemene UII-logboekbron voor berichten die door UII worden gerapporteerd.
Microsoft.Xrm.Tooling.CrmConnectControl	De logboekbron voor het aanmeldproces. Deze bron rapporteert algemene of gedetailleerde diagnostische informatie over de aanmeldprocedure.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Logboekbron voor alle interacties op het niveau van Dataverse-gegevens. Deze bron rapporteert alle interacties met Dataverse, uitzonderingen en timings.
Microsoft.Xrm.Tooling.WebResourceUtility	Logboekbron voor aanvragen voor Webresourcegegevens via de Dataverse-interfacekoppeling.
Microsoft.Crm.UnifiedServiceDesk	Logboekbron voor kernfunctionaliteit van Unified Service Desk. Deze logboekbron rapporteert acties en evenementen die essentieel zijn voor Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Logboekbron voor Unified Service Desk bootstrap en laadprocessor. Deze bron rapporteert acties en evenementen die onderdeel vormen van het initialiseren van en het starten van UII en Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Logboekbron voor acties die communiceren met het UserProfile-systeem. Dit is een onderdeel van het cachesysteem. Meer informatie: Clientcaching configureren voor uw agenttoepassing

U kunt elk van deze logboekbronnen onafhankelijk in- of uitschakelen ter ondersteuning van probleemoplossing en isolatie van problemen of informatie binnen Unified Service Desk.

Diagnostische registratieniveaus

Er zijn verschillende logboekregistratieniveaus beschikbaar voor gebruik. Wanneer u het registratieniveau verhoogt, worden echter meer gegevens gegenereerd en in de logboekbestanden opgeslagen.

Logboekniveau	Beschrijving
Uit	Schakelt alle gebeurtenissen van deze bron uit.
Fout	Rapporteert alleen foutgebeurtenissen.
Waarschuwing	Rapporteert fouten en waarschuwingsgebeurtenissen.
Informatie	Rapporteert fouten, waarschuwingen, en informatiegebeurtenissen.
Uitgebreid	Rapporteert fouten, waarschuwingen, informatie en uitgebreide gebeurtenissen.
ActivityTracing	Rapporteert fouten, waarschuwingen, informatie en uitgebreide gebeurtenissen, en activiteittracering (methodenamen). Opmerking: ActivityTracing is alleen beschikbaar voor een aantal bronnen.
Alle	Rapporteert alle gebeurtenissen die door het systeem zijn geactiveerd.

Diagnostische logboeklisteners

Diagnostische logboeklisteners worden gebruikt om de diagnostische logboekuitvoer naar bestanden, het gebeurtenislogboek of andere bronnen te sturen. Standaard zijn alle diagnostische bronnen gekoppeld aan zowel de standaardlistener (Debugger) als de bestandslistener (tekst). U kunt aanvullende logboeklisteners configureren voor diagnostische logboekregistratie voor Unified Service Desk. Zie voor meer informatie over de .NET-standaardlisteners:

MSDN:DefaultTraceListener
MSDN:EventLogTraceListener
MSDN:TextWriterTraceListener

U kunt ook aangepaste listeners maken om diagnostische logboeken naar een locatie van uw keuze te sturen. Aangepaste listeners worden gemaakt door een klasse uit de abstracte klasse MSDN: TraceListener af te leiden. Een walkthrough van het proces vindt u op CodeGuru.com.

Het diagnostische logboekbestand weergeven

Diagnostische logboekregistratie is standaard ingeschakeld voor de Unified Service Desk-clienttoepassing. Een logbestand, UnifiedServiceDesk-<datum>.log, is beschikbaar in c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> op de clientcomputer om operationele fouten in de clienttoepassing te registreren. Het logboekbestand wordt gemaakt de eerste keer dat er fouten in de clienttoepassing optreden.

Wanneer er een fout in een gehost besturingselement optreedt, bevat de informatie die wordt vastgelegd in de logboekbestanden gedetailleerde informatie over de uitzondering, zoals het oorspronkelijke gehoste besturingselement dat de uitzondering heeft veroorzaakt en de uitzonderingsdetails. De volledige JavaScript-code die de uitzondering heeft veroorzaakt, wordt niet geregistreerd. Alleen de foutieve code samen met de uitzonderingbeschrijving wordt geregistreerd.

Hier volgen de details van de voorbeelduitzondering die worden vastgelegd.

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

Bewakingsproces van Unified Service Desk

Het bewakingsproces van Unified Service Desk (usdmp.exe) is een service die continu de toestand van Unified Service Desk bewaakt. Dit proces sluit standaard na 5 seconden alle exemplaren van het browserproces af die niet meer reageren en ertoe leiden dat Unified Service Desk ook niet meer reageert. Als een element van het browserproces niet reageert, maar Unified Service Desk wel reageert, wordt het element van het browserproces niet beëindigd. Voor meer informatie over hoe u de duur van de algemene optie ProcessTerminationThreshold voor beëindiging van het browserproces wijzigt, raadpleegt u Opties beheren voor Unified Service Desk.

Rapportage voor foutdiagnose

Met gedetailleerde en uitgebreide logboekregistratie en rapportage, die word uitgevoerd wanneer een storing optreedt bij een onderdeel, toepassing of systeem is het makkelijker om te bepalen wanneer en hoe dit kon gebeuren. Naast standaardlogboekregistratie voor diagnostiek, kan met foutdiagnostiekrapportage informatie over de toestand van systeem en toepassing worden vastgelegd wanneer in de Unified Service Desk-client een uitzondering optreedt. Meer informatie over uitzonderingen vindt u in Hoe Unified Service Desk toepassings- en systeemfouten afhandelt.

Mappen en bestanden die bij een uitzondering worden aangemaakt

In het geval van een uitzondering maakt de functie voor foutdiagnostiekrapportage een map aan op de lokale computer met de naam DiagnosticsLogs_datum-en-tijd, met de datum en tijd in de notatie jaar-maand-datum_tijd (bijvoorbeeld DiagnosticLogs_20170322_173643). In de DiagnosticsLogs-map worden de volgende map en bestanden gemaakt.

Diagnosebestand	Beschrijving
UnifiedServiceDesk_datumentijd.log	Standaarddiagnostieklogboek dat wordt gemaakt en aangevuld terwijl de Unified Service Desk-client wordt uitgevoerd. Dit bestand bevat logboekinformatie voor de Unified Service Desk-client (UnifiedServiceDesk.exe). De huidige bestanden worden verplaatst naar de DiagnosticsLogs-map wanneer een uitzondering optreedt.
UnifiedServiceDeskMonitoring_datum.log	Standaarddiagnostieklogboek dat wordt gemaakt en aangevuld terwijl de Unified Service Desk-client wordt uitgevoerd. Bevat logboekinformatie voor het bewakingsproces van Unified Service Desk (usdmp.exe), dat een proces is dat de status van de Unified Service Desk-client bewaakt. De huidige bestanden worden verplaatst naar de DiagnosticsLogs-map wanneer een uitzondering optreedt. Meer informatie: Bewakingsproces voor Unified Service Desk
Eventlogs (map)	Map die wordt aangemaakt bij een fatale of niet-fatale uitzondering. Bevat systeem- en toepassingsgebeurtenislogboeken en tekstbestanden met foutrapportage van Windows.
ExitReport.txt	Afsluitlogboek dat wordt aangemaakt bij een fatale of niet-fatale uitzondering. Bevat processtatusgegevens zoals de computernaam, Unified Service Desk-versie, proces-id, afsluitcode en tijd waarop de toepassing werd afgesloten.
MachineHealthReport.txt	Afsluitlogboek dat wordt aangemaakt bij een fatale of niet-fatale uitzondering. Bevat de systeemstatusgegevens zoals CPU, besturingssysteem, monitordetails, taal en de browserversie.
ProcessReport.csv	Afsluitlogboek dat wordt aangemaakt bij een fatale of niet-fatale uitzondering. Geeft een uitgebreide lijst van alle processen die op het systeem werden uitgevoerd op het moment van de uitzondering.
RegistryLog.txt	Afsluitlogboek dat wordt aangemaakt bij een fatale of niet-fatale uitzondering. De bevat een op tekst gebaseerde kopie van de Windows-registerregistersubsleutels voor Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_datumentijd.dmp	Wordt alleen gemaakt bij een niet-verwerkte fatale uitzondering, of wanneer handmatig aangeroepen via toetscombinatie voor de algemene optie ManualDumpShortcut. Maakt een bestand met een volledige geheugendump voor UnifiedServiceDesk.exe. Houd er rekening mee dat u Visual Studio of een andere tool voor het weergeven van Windows-dumpbestanden nodig hebt om het bestand te kunnen weergeven.

Foutdiagnoserapportage configureren

Meld u aan bij Unified Service Desk-beheerder.
Selecteer onder Geavanceerde instellingen de optie Controle en diagnose.
Selecteer + Nieuw en vervolgens DiagnosticsConfiguration.
Selecteer of typ de waarden die u wilt, zoals bijhouden, controle van afsluiten en de locatie van de diagnostische logboekmap. Meer informatie: Diagnostiek
Selecteer Opslaan en sluiten.

Zie ook

Controle en diagnostiek configureren in Unified Service Desk

Het debuggen van ondersteuning in Unified Service Desk om problemen op te lossen

Problemen oplossen in Unified Service Desk

Delen via