Konfigurieren von Client-Diagnoseprotokollierungen am vereinheitlichen Servicedesk

Artikel
05/15/2017

Veröffentlicht: November 2016

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Es gibt zwei Möglichkeiten, den Unified Service Desk-Client für diagnostisches Protokollieren zu konfigurieren:

Durch Verwendung eines Überwachungs- und Diagnosen-Einstellungsdatensatzes, der im Bereich Unified Service Desk von Microsoft Dynamics 365 erstellt und verwaltet wird.
Durch manuelle Änderungen an der UnifiedServiceDesk.exe.config-Datei. Diese Datei muss dann an alle Desktops verteilt werden, an denen der Unified Service Desk-Client eine Diagnoseprotokollierung durchführen soll.

Darüber hinaus können Sie jedoch Diagnoseprotokolle für Ausnahmen konfigurieren, die möglicherweise im Unified Service Desk-Client auftreten.

In diesem Thema

Die Unified Service Desk-Diagnoseprotokollierung für den Client konfigurieren

Diagnoseprotokollquellen

Diagnose-Protokollierungsebenen

Diagnoseprotokoll-Listeners

Anzeigen der Diagnoseprotokolldatei

Unified Service Desk-Überwachungsprozess

Fehlerberichterstattung

Die Unified Service Desk-Diagnoseprotokollierung für den Client konfigurieren

In diesem Thema wird beschrieben, wie die Diagnoseprotokollierung in Unified Service Desk manuell konfiguriert wird. Anstelle die hier beschriebene Prozedur zu verwenden, empfehlen wir Ihnen die Verwendung der Audit- und Diagnoseeinstellungen, die die zentrale Administration der Diagnosen und die Verbindung zu einem benutzerdefinierten Listener ermöglichen.Weitere Informationen:Konfigurieren der Überwachung und Diagnose in Unified Service Desk

Wichtig

Die manuell-konfigurierte Diagnose (wie hier beschrieben) wird nach dem Aktivieren eines Überwachungs- und Diagnose-Einstellungsdatensatz, der für Diagnosen konfiguriert ist, nicht mehr funktionieren.
Unified Service Desk bietet zudem eine umfangreiche API, die Sie zur Diagnoseprotokollierung für die benutzerdefinierte Steuerelemente konfigurieren können. Weitere Informationen: MSDN: Konfigurieren der die Diagnoseprotokollierung für die benutzerdefinierte Steuerelemente

In diesem Thema wird beschrieben, wie die Clientprotokollierungseigenschaften geändert werden.

Sie können die Protokollierung aktivieren, indem Sie die Datei UnifiedServiceDesk.exe.config in Unified Service Desk verwenden, die im Installationsverzeichnis Ihres Clientcomputers verfügbar ist. So konfigurieren Sie die Protokollierung und den Ort der Unified Service Desk-Protokolldatei:

Öffnen Sie die Datei UnifiedServiceDesk.exe.config zum Bearbeiten. Wenn Sie den Unified Service Desk-Client am Standardspeicherort installiert haben, befindet sich diese Datei normalerweise unter C:\Program Files\Microsoft Dynamics 365 USD\USD.

Navigieren Sie zum Abschnitt <switches> in der Datei:

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

Geben Sie im Abschnitt <switches> eine Protokollquelle an (wie etwa EventTopicSwitch), und geben Sie dann einen Wert für die Protokollebene an (wie etwa Error). Der Abschnitt <switches> steuert Protokollierungsebenen für verschiedene Quellen. Standardmäßig ist für alle Switches die Diagnoseprotokollierung aktiviert.
- Informationen zu den verfügbaren Protokollierungsquellen finden Sie unter Diagnoseprotokollquellen weiter unten in diesem Thema.
- Informationen über die Werte, die Sie für jede Protokollierungsquelle angeben können, finden Sie unter Diagnose-Protokollierungsebenen weiter unten in diesem Thema.

Um den Speicherort, maximale Dateigröße und Rolloververhalten der Protokolldateien konfigurieren möchten, gehen Sie zum Abschnitt <shareListeners> in der Datei.

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

Der Abschnitt <sharelisteners> steuert den Ort und den Typ der Protokolle, die für Unified Service Desk generiert werden. Standardmäßig erstellt fileListener eine Datei UnifiedServiceDesk.log in c:\Users\<UserName>\AppData\Roaming\Microsoft\UnifiedServiceDesk\<Version> Verzeichnis und USDDebugListener erstellt Ereignisse im MSDN: Debug Output-Registerkarte des gehosteten Debugger Steuerelements.

Wenn Sie den Speicherort der Datei UnifiedServiceDesk.log ändern möchten, ändern Sie den Wert des Parameters Location.
Standardmäßig wird ein neuer Unified Service Desk Datensatz erstellt, nachdem die Dateigröße die aktuelle Protokolldatei 52,42 MB übersteigt. Standardmäßig werden bis zu 10 Protokolldateien gleichzeitig verwaltet, bevor die älteste Protokolldatei gelöscht wird.
- Um die maximale Protokolldateigröße Unified Service Desk zu ändern, ändern Sie den Wert in Bytes im Parameter MaxFileSize.
- Um die Anzahl der gespeicherten Protokolle zu ändern, bevor der älteste Datensatz gelöscht wird, ändern Sie den Wert des Parameters MaxFileCount. Wenn Null (0) verwendetet wird, wird die Rolloverprotokollierung deaktiviert und alle erstellten Unified Service Desk Client-Protokolle werden gespeichert.
Standardmäßig ist die Datei- und Debuggerprotokollierung für alle Quellen aktiviert. Wenn Sie einen Listener zu einer Diagnosequelle hinzufügen oder daraus entfernen möchten, suchen Sie die gewünschte Quelle im Abschnitt <sources>, und ändern Sie dann den Abschnitt <listeners> der Quelle so, dass der gewünschte Listener enthalten ist.

Zum Beispiel: Um die Ereignisprotokollierung für Unified Service Desk hinzuzufügen, fügen Sie den Ereignisprotokollierungslistener Microsoft.Crm.UnifiedServiceDesk der Quelle hinzu:
```
<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>
```
Dies wird nun Ereignisse für das Windows-Ereignisprotokoll mit dem Tag "USD", zusätzlich zu Datei und Debugger, berichten. Weitere Informationen zu Diagnose-Listeners finden Sie unter Diagnoseprotokoll-Listeners weiter unten in diesem Thema.

Diagnoseprotokollquellen

Allgemeine Problembehandlungsprotokollquellen sind in der folgenden Tabelle aufgeführt.

Quellenname	Beschreibung
EventTopicSwitch	Detaillierte User Interface Integration (UII)-Protokollierquelle zur Überwachung des Messagingdatenverkehrs innerhalb des UII.
Microsoft.Uii.Common.Logging	Allgemeine UII-Protokollquelle für UII-Meldungen.
Microsoft.Xrm.Tooling.CrmConnectControl	Protokollquelle für den Anmeldungsprozess bei Dynamics 365. Diese Quelle bietet allgemeine oder detaillierte Diagnoseinformationen zum Anmeldevorgang.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Protokollquelle für alle Dynamics 365-Interaktionen auf Datenebene. Die Quelle berichtet über alle Interaktionen mit Dynamics 365, Ausnahmen und Timings.
Microsoft.Xrm.Tooling.WebResourceUtility	Protokollquelle für Webressourcedaten über den Dynamics 365-Schnittstellenlink.
Microsoft.Crm.UnifiedServiceDesk	Protokollquelle für zentrale Unified Service Desk-Funktionen. Diese Protokollquelle berichtet über zentrale Aktionen und Ereignisse in Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Protokollquelle für Unified Service Desk-Bootstrap und Loading Processor. Diese Quelle berichtet über Ereignisse und Aktionen, die zur Initialisierung und zum Start der UII und von Unified Service Desk gehören.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Protokollquelle für Aktionen, die mit dem Benutzerprofilsystem interagieren; dies gehört zum Cachingsystem.Weitere Informationen:Konfiguration des Client-Cashings im Unified Service Desk

Sie können zwischen allen diesen Protokollquellen unabhängig wechseln, um die Problembehebung oder die Isolierung von Problemen oder Informationen innerhalb von Unified Service Desk zu unterstützen.

Diagnose-Protokollierungsebenen

Es gibt verschiedene Protokollierungsebenen, die für die Verwendung verfügbar sind. Wenn Sie die Protokollierungsebene erhöhen, werden jedoch mehr Daten generiert und in den Protokolldateien gespeichert.

Protokoll-Ebene	Beschreibung
Aus	Deaktiviert alle Ereignisse aus dieser Quelle.
Fehler	Berichtet nur über Fehlerereignisse.
Warnung	Berichtet über Fehler- und Warnungen.
Informationen	Berichtet über Fehler-, Warnungs- und Informationsereignisse.
Ausführlich	Berichtet über Fehler-, Warnungs-, Informations- und ausführliche Ereignisse.
ActivityTracing	Berichtet über Fehler-, Warnungs-, Informations- und ausführliche Ereignisse sowie Aktivitätsnachverfolgung (Methodennamen). Hinweis ActivityTracing ist nur für einige der Quellen verfügbar.
Alle	Berichtet über alle vom System erstellten Ereignisse.

Diagnoseprotokoll-Listeners

Diagnosenprotokoll-Listeners werden verwendet, um die Ausgabe des Diagnoseprotokolls auf Dateien, das Ereignisprotokoll oder andere Quellen auszurichten. Standardmäßig werden alle Diagnosequellen mit dem Standard- (Debugger) und Datei- (Text) Listener verknüpft. Sie können zusätzliche Protokoll-Listeners für die Diagnoseprotokollierung für Unified Service Desk konfigurieren. Weitere Informationen zu den Standard-.NET-Listenern finden Sie unter:

Sie können auch benutzerdefinierte Listener erstellen, um Diagnoseprotokolle an einen Ort Ihrer Wahl zu senden. Benutzerdefinierte Listener werden erstellt, indem aus der abstrakten KlasseTraceListener eine Klasse abgeleitet wird. Eine ausführliche Erläuterung dieses Vorgangs finden Sie unter CodeGuru.com.

Anzeigen der Diagnoseprotokolldatei

Standardmäßig ist die Unified Service Desk-Client-Anwendung für die Diagnoseprotokollierung aktiviert. Die Protokolldatei, UnifiedServiceDesk-<Datum>.log ist unter c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> auf dem Clientcomputer gespeichert. Die Protokolldatei wird erstellt, wenn zum ersten Mal Fehler in der Client-Anwendung auftreten.

Wenn ein Fehler in einem gehosteten Steuerelement auftritt, bieten die Informationen in den Protokolldateien detaillierte Informationen zum gehosteten Steuerelement, das die Ausnahme ausgelöst hat sowie Details. Beachten Sie, dass der gesamte JavaScript-Code der Ausnahme nicht protokolliert wird. Nur der fehlerhafte Code und die Ausnahmebeschreibung werden protokolliert.

Hinweis

Die Fehlerbehandlungsfunktionen und Protokollierung wurde zuerst in Unified Service Desk 2.2.1 eingeführt.

Hier ein, das Beispielausnahmedetail:

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

Der Unified Service Desk Überwachungs-Prozess (usdmp.exe) ist ein Dienst, der kontinuierlich den Status von Unified Service Desk überwacht und standardmäßig nach 5 Sekunden alle Browserprozessinstanzen, die nicht reagieren und Unified Service Desk inaktiv werden, zu beenden. Wenn eine Browserprozessinstanz nicht reagiert, Unified Service Desk jedoch reagiert, wird die Browserprozessinstanz nicht beendet. Weitere Informationen dazu, wie Sie den Wert der globalen Option ProcessTerminationThreshold für Browserprozessbeendigung ändern, finden Sie unter Verwalten der Optionen für Unified Service Desk.

Fehlerberichterstattung

Eine detaillierte und vollständige Berichterstellung, die bei einer Komponente, einer Anwendung oder einem Systemfehler erfolgt, hilft dabei zu identifizieren, wann und wie der Fehler auftrat. Zusätzlich zur Standarddiagnosenprotokollierung meldet die Fehlerdiagnose Datensystem- und Anwendungsstatusinformationen im Falle von einer Ausnahme beim Unified Service Desk Client. Weitere Informationen zu Ausnahmen finden Sie unter Wie Unified Service Desk Anwendungs- und Systemfehler behandelt.

Hinweis

Die Diagnoseberichtsfunktionen, die hier beschriebene wurden, werden zuerst in Unified Service Desk 2.2.2 eingeführt.

Ordner und Dateien erstellt während einer Ausnahme

Im Falle einer Ausnahme stellt die Fehlerdiagnoseberichterstellung einen Ordner auf dem lokalen Computer mit Namen DiagnosticsLogs_Datum und Uhrzeit bereit, wobei "Datum und Uhrzeit" im Formular Jahr-Monat-Datum-Zeit sind, wie DiagnosticLogs_20170322_173643. Innerhalb des DiagnosticsLogs-Ordners werden die folgenden Ordner und Dateien erstellt.

Diagnosetatei	Beschreibung
UnifiedServiceDesk_dateandtime.log	Standarddiagnoseprotokoll, das erstellt und angehängt wird, wenn Unified Service Desk Client ausgeführt wird. Die Datei enthält Protokollierungsinformationen für den Unified Service Desk Client (UnifiedServiceDesk.exe). Die aktuelle Datei wird nun in den Ordner DiagnosticsLogs im Fall einer Ausnahme verschoben.Weitere Informationen:Configure client diagnostic logging in Unified Service Desk
UnifiedServiceDeskMonitoring_date.log	Standarddiagnoseprotokoll, das erstellt und angehängt wird, wenn Unified Service Desk Client ausgeführt wird. Enthält Protokollierungsinformationen für den Unified Service Desk Überwachungsprozess (usdmp.exe ). Es handelt sich um einen Prozess, der den Status des Unified Service Desk - Clients überwacht. Die aktuelle Datei wird nun in den Ordner DiagnosticsLogs im Fall einer Ausnahme verschoben.Weitere Informationen:Unified Service Desk-Überwachungsprozess
Eventlogs (Ordner)	Ordner erstellt im Fall einer fatalen oder nicht-fatalen Ausnahme. Enthält Windows-System- und Anwendungsereignisprotokolle und Fehlerberichterstattungstextdateien.
ExitReport.txt	Exit-Protokoll im Fall einer fatalen oder nicht-fatalen Ausnahme. Enthält Prozesszustandsinformationen wie Computername, Unified Service Desk Version, Prozess-ID, xitcode und Uhrzeit des Exits.
MachineHealthReport.txt	Exit-Protokoll im Fall einer fatalen oder nicht-fatalen Ausnahme. Enthält Systemzustandsinformationen wie Computerprozessor, Betriebssystem, Bildschirmdetails, Sprache und die Browserversion.
ProcessReport.csv	Exit-Protokoll im Fall einer fatalen oder nicht-fatalen Ausnahme. Stellt eine vollständige Liste aller Prozesse dar, die auf dem System zur Zeit der Ausnahme ausgeführt wurden.
RegistryLog.txt	Exit-Protokoll im Fall einer fatalen oder nicht-fatalen Ausnahme. Enthält eine textbasierte Kopie der Windows-Registrierungsunterschlüssel für Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_dateandtime.dmp	Wird nur im Falle einer nicht behandelten fatalen Ausnahme erstellt oder wenn anuell ausgelöst mithilfe derManualDumpShortcut globalen Tastaturkombinationsoption. Stellt eine vollständige Speicherabbilddatei für UnifiedServiceDesk.exe bereit. Beachten Sie, dass Sie zum Anzeigen der Abbilddatei oder anderer Windows-Abbilddateien Microsoft Visual Studio benötigen.

Fehlerdiagnoseberichterstattung konfigurieren

Wechseln Sie in der Webanwendung zu Einstellungen > Unified Service Desk > Optionen.
Klicken Sie auf Neu und dann auf DiagnosticsConfiguration.
Geben Sie mindestens einen Wert ein, der in folgenden Tabelle aufgeführt ist, getrennt durch Semikolon (;).Weitere Informationen:Fehlerdiagnoseberichtsoptionswerte

Beispielsweise ändert diese Konfiguration das Protokolldateiverzeichnis, reduziert die maximale Diagnoseprotokoll-Ordnergröße auf 2 GB und ändert die Tastenkombination, um ein bedarfsgesteuertes Absturzabbild zu CTRL+ALT+D. aufzurufen.
Klicken Sie auf Speichern und schließen.

Fehlerdiagnoseberichtsoptionswerte

Fehlerdiagnoseberichterstellungseinstellungen werden mithilfe der globlaen Option DiagnosticsConfiguration konfiguriert. Die verfügbaren DiagnosticsConfiguration-Werte werden hier beschrieben.

Wertname	Werttyp	Beschreibung
EnableExitMonitoring	True / False.	Der Standardwert ist True und beide Diagnoseprotokolle und Beendigungsprotokolle werden im Fall einer Ausnahme erfasst. Wenn Sie False festlegen, werden die Diagnoseprotokolle und die Beendigungsprotokolle nicht während einer Ausnahme des Unified Service Desk Clients gesammelt.
EnableCrashMonitoring	True / False.	Der Standardwert ist True für Abbilddateien, die während einer fatalen Ausnahme des Unified Service Desk-Clients erfasst werden. Wenn Sie False festlegen, werden Abbilddateien während einer Unified Service Desk-Clientausnahme nicht gesammelt werden. Wenn EnableCrashMonitoring auf False gesetzt ist und EnableExitMonitoring auf True festgelegt ist, werden beide Diagnoseprotokolle und Beendigungsprotokolle gesammelt, jedoch Abbilddateien nicht.
LogsDirectory	Zeichenfolge	Gibt den vollständigen Pfad zum Ordner an, in dem Diagnosendateien für Ausnahmen gespeichert werden. Wenn der Pfad ungültig oder nicht verfügbar ist, wird Unified Service Desk den Standardordner verwenden. Standardmäßig ist der Ordner %APPDATA%\Roaming\Microsoft\Microsoft Dynamics® 365 Unified Service Desk\<version>\Diagnostics\.
MaxDiagnosticLogsSize	integer	Gibt die maximale Größe des Ordners in Megabytes an, wenn Diagnosendateien gespeichert werden. Die Standardgröße ist 5 GB (5000 MB). Wenn MaxDiagnosticLogsSize überschritten wird, werden die ältesten Protokollordner gelöscht, bis MaxDiagnosticLogsSize nicht mehr überschritten wird. Beachten Sie, dass der neueste Protokollordner nicht gelöscht wird, selbst wenn er MaxDiagnosticLogsSize übersteigt.
ManualDumpShortcut	Zeichenfolge	Gibt die Tastenkombination an, die verwendet wird, um das manuelle Erstellen einer Abbilddatei auszulösen. Die Standardtastenkombination ist. CTRL+ALT+a. Um den Standard zu ändern, nutzen Sie das Formular key1+key2+key3.

Siehe auch

Konfigurieren der Überwachung und Diagnose in Unified Service Desk
Unified Service Desk-Probleme beheben
MSDN: Debuggen von Problemen in Unified Service Desk

Unified Service Desk 2.0

Freigeben über

Konfigurieren von Client-Diagnoseprotokollierungen am vereinheitlichen Servicedesk

In diesem Thema

Die Unified Service Desk-Diagnoseprotokollierung für den Client konfigurieren

Diagnoseprotokollquellen

Diagnose-Protokollierungsebenen

Diagnoseprotokoll-Listeners

Anzeigen der Diagnoseprotokolldatei

Unified Service Desk-Überwachungsprozess

Fehlerberichterstattung

Ordner und Dateien erstellt während einer Ausnahme

Fehlerdiagnoseberichterstattung konfigurieren

Fehlerdiagnoseberichtsoptionswerte

Siehe auch

Zusätzliche Ressourcen