Freigeben über

So aktivieren Sie die Ablaufverfolgung in Microsoft Dynamics CRM 2013 und 2011

In diesem Artikel wird beschrieben, wie Sie die Ablaufverfolgung in Microsoft Dynamics CRM aktivieren.

Gilt für: Microsoft Dynamics CRM 2011, Microsoft Dynamics CRM 2013
Ursprüngliche KB-Nummer: 907490

Wichtig

Dieser Abschnitt, diese Methode bzw. diese Aufgabe enthält eine Beschreibung der Schritte zum Bearbeiten der Registrierung. Durch die falsche Bearbeitung der Registrierung können schwerwiegende Probleme verursacht werden. Daher müssen Sie sicherstellen, dass Sie diese Schritte sorgfältig ausführen. Für weiteren Schutz sichern Sie die Registrierung, bevor Sie sie ändern. Anschließend können Sie die Registrierung wiederherstellen, wenn ein Problem auftritt. Weitere Informationen zum Sichern und Wiederherstellen der Registrierung finden Sie unter: Sichern und Wiederherstellen der Registrierung Windows.

Mit Microsoft Dynamics CRM können Sie Ablaufverfolgungsdateien erstellen, die die Aktionen überwachen, die von Microsoft Dynamics CRM ausgeführt werden. Ablaufverfolgungsdateien sind hilfreich, wenn Sie Fehlermeldungen oder andere Probleme in Microsoft Dynamics CRM beheben müssen.

Sie können nicht verwaltete Ablaufverfolgungsdateien und verwaltete Ablaufverfolgungsdateien erstellen. Die Informationen in den unverwalteten und verwalteten Protokolldateien werden durch erforderliche und optionale Registrierungseinträge bestimmt, die Sie manuell erstellen. Sie erstellen diese Registrierungseinträge auf dem Microsoft Dynamics CRM-Server oder auf dem Computer, auf dem der Microsoft Dynamics CRM-Client für Microsoft Office Outlook ausgeführt wird, nachdem Sie Microsoft Dynamics CRM oder den Microsoft Dynamics CRM-Client für Outlook installiert haben.

In Microsoft Dynamics CRM 2011 und 2013 können Sie die Ablaufverfolgung auch mithilfe von Windows PowerShell-Applets aktivieren. Weitere Informationen finden Sie im Abschnitt "Aktivieren von Ablaufverfolgungseinstellungen über Windows PowerShell ".

Erforderliche Registrierungseinträge

Nachfolgend sind die erforderlichen Registrierungseinträge aufgeführt. Weitere Informationen zum Speicherort dieser Registrierungseinträge finden Sie im Abschnitt "Registrierungseintragsspeicherorte ".

Name Typ Datenwert Hinweise
ProtokollierungAktiviert DWORD Ein Wert von 0 oder 1 Wenn Sie den Wert 0 verwenden, ist die Ablaufverfolgung deaktiviert. Wenn Sie den Wert 1 verwenden, ist die Ablaufverfolgung aktiviert.
TraceDirectory Zeichenfolge C:\CRMTrace Der Registrierungseintrag TraceDirectory gibt das Verzeichnis für die Ablaufverfolgungsprotokolldateien an. Das Verzeichnis muss vorhanden sein, und der Benutzer, der das Microsoft CRMAppPool startet, muss die vollständige Kontrolle über dieses Verzeichnis haben. Wenn Sie Microsoft Dynamics CRM installieren, lautet der Standardbenutzer NT AUTHORITY\NETWORK SERVICE. Dieser Eintrag ist nur für Microsoft Dynamics CRM 3.0 erforderlich. Für spätere Versionen wird das Protokollverzeichnis auf den Installationsspeicherort der Microsoft Dynamics CRM-Programmdateien, C:\Programme\Microsoft Dynamics CRM\Trace, gesetzt.
TraceRefresh DWORD Eine Zahl zwischen Null und 99 Wenn die Daten geändert werden, werden die Ablaufverfolgungseinstellungen der anderen Registrierungseinträge angewendet.

Optionale Registrierungseinträge

Nachfolgend sind die optionalen Registrierungseinträge aufgeführt.

Name Typ Datenwert Hinweise
Spurkategorien Zeichenfolge Kategorie.Funktion:TraceLevel Der Registrierungseintrag „TraceCategories“ ist eine Kombination aus einer Kategorie, einem Feature und einer Protokollierungsebene. Sie können mehrere Kategorien, Funktionen und Ablaufverfolgungsebenen angeben. Trennen Sie jede Kombination durch ein Semikolon. Eine Liste der Kategorien, Funktionen und Ablaufverfolgungsstufen sowie gültige Beispielkombinationen finden Sie im Abschnitt "Ablaufverfolgungsebenen-Werte".
TraceCallStack DWORD Ein Wert von 0 oder 1 Wenn Sie einen Wert von 0 verwenden, ist der Aufrufstapel nicht in der Ablaufverfolgungsdatei enthalten. Wenn Sie einen Wert von 1 verwenden, ist der Call Stack in der Ablaufverfolgungsdatei enthalten.
Protokolldateigrößenlimit DWORD Eine Größe zwischen 1 MB und 100 MB Der Registrierungseintrag "TraceFileSizeLimit" gibt die maximale Größe von Protokolldateien an. Neue Dateien werden erstellt, wenn der Grenzwert erreicht wird.

Wenn Sie die optionalen Registrierungseinträge nicht erstellen, werden die Standardwerte verwendet. Weitere Informationen zu den Standardwerten finden Sie im Abschnitt "Standardwerte für optionale Registrierungseinträge" . Wenn Sie die Registrierungseinträge erstellen, aber keine Datenwerte für die Registrierungseinträge angeben, funktioniert die Ablaufverfolgung nicht.

Aktivieren von Einstellungen für die Ablaufverfolgung über Windows PowerShell

Notiz

Diese änderungen, die in Windows PowerShell vorgenommen wurden, aktualisieren die Registrierung nicht. Diese Änderungen aktualisieren die Tabellen DeploymentProperties und ServerSettingsProperties in der MSCRM_CONFIG-Datenbank.

Cmdlets registrieren

  1. Melden Sie sich beim Administratorkonto auf Ihrem Microsoft Dynamics CRM-Server an.
  2. Geben Sie in einem Windows PowerShell-Fenster den Befehl ein: Add-PSSnapin Microsoft.Crm.PowerShell.

Mit diesem Befehl wird das Microsoft Dynamics CRM Windows PowerShell-Snap-In zur aktuellen Sitzung hinzugefügt. Das Snap-In wird während der Installation und Einrichtung des Microsoft Dynamics CRM-Servers registriert.

Um eine Liste der aktuellen Einstellungen zu erhalten, geben Sie den Befehl ein: Get-CrmSetting TraceSettings.

Die Ausgabe ähnelt der folgenden:

CallStack : True Kategorien : *:Fehler Verzeichnis : c:\crmdrop\logs Aktiviert : False Dateigröße : 10 Erweiterungsdaten : System.Runtime.Serialization.ExtensionDataObject

Einstellungen für die Ablaufverfolgung festlegen

  1. Geben Sie den Befehl ein: $setting = Get-CrmSetting TraceSettings.
  2. Geben Sie den Befehl ein, um die Ablaufverfolgung zu aktivieren: $setting.Enabled=$True.
  3. Geben Sie den Befehl ein, um die Tracing-Einstellungen festzulegen: Set-CrmSetting $setting.
  4. Geben Sie den Befehl ein, um eine momentane Liste der Trace-Einstellungen abzurufen: Get-CrmSetting TraceSettings.

Führen Sie zum Deaktivieren der Ablaufverfolgung über Windows PowerShell die gleichen Schritte aus, außer dass Sie den Befehl in Schritt 2 verwenden: $setting.Enabled=$False.

Notiz

Das Format der Beispielbefehle für jeden Wert sollte wie folgt sein:

  • $setting.Enabled= $EnabledValue ($True oder $False)
  • $setting.CallStack= $StackValue ($True oder $False)
  • $setting.Categories ="*:Verbose"
  • $setting.Directory="C:\Programme\Microsoft Dynamics CRM\Trace"
  • $setting.FileSize = 10

Die Ausgabe ähnelt der folgenden:

CallStack : Wahr Kategorien : *:Fehler Verzeichnis : c:\crmdrop\logs Aktiviert : Wahr Dateigröße : 10 ExtensionData : System.Runtime.Serialization.ExtensionDataObject

Speicherorte von Microsoft Dynamics CRM 2011- und 2013-Logdateien

Wenn Sie eine Protokollierung in Microsoft Dynamics CRM erstellen, wird der Registrierungsschlüssel "Trace Directory" ignoriert. Für die Ablaufverfolgung im Microsoft Dynamics CRM wird die Ablaufverfolgungsprotokolldatei im folgenden Ordner erstellt:

Laufwerk:\Programme\Microsoft Dynamics CRM\Trace

Für die Protokollierung auf dem Microsoft Dynamics CRM 2011- oder 2013-Client für Microsoft Office Outlook wird die Protokolldatei im folgenden Ordner erstellt, falls das Updaterollup 7 oder ein späteres kumulatives Updatepaket installiert ist.

DriveName:\ InstallingUser \Lokale Einstellungen\Application Data\Microsoft\MSCRM\Traces

Speicherorte von Registrierungseinträgen

Die Registrierungseinträge der Microsoft Dynamics CRM-Serverablaufverfolgung befinden sich im folgenden Registrierungsunterschlüssel:

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRM

Die Registrierungseinträge zur Ablaufverfolgung des Microsoft Dynamics CRM-Clients für Outlook befinden sich im folgenden Registrierungsunterschlüssel:

HKEY_CURRENT_USER\SOFTWARE\MICROSOFT\MSCRMClient

Die Registrierungseinträge für die Ablaufverfolgung von Microsoft Dynamics CRM SSRS Data Connector befinden sich im folgenden Registrierungsunterschlüssel:

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRMBidsExtensions

Die Registrierungseinträge für die Ablaufverfolgung von Microsoft Dynamics CRM Data Migration Manager befinden sich im folgenden Registrierungsunterschlüssel:

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\DATA MIGRATION WIZARD

Vollständige Liste der Kategoriewerte für den Registrierungseintrag "TraceCategories"

Microsoft Dynamics CRM 2011 und 2013

  • ADUtility
  • Anwendung
  • Application.Outlook
  • Datenmigration
  • Bereitstellung
  • Bereitstellung. Vorkonfiguration
  • Deployment.Sdk
  • Ausnahme
  • Etm
  • Leben
  • Live.AggregationDatenausgabe
  • Live.PartnerInteraction
  • Live.Platform
  • Live.Portal
  • Live.Bereitstellung
  • Live.Support
  • Live.SyncDaemon
  • Überwachung
  • NewOrgUtility
  • ObjectModel
  • Parameterfilter
  • Plattform
  • Platform.Asynchron
  • Platform.ImportExportPublish
  • Plattform.Import
  • Platform.Metadata
  • Platform.SDK
  • Platform.Soap
  • Platform.Sql
  • Platform.Workflow
  • Berichte
  • Sandkasten
  • Sandbox.AssemblyCache
  • Sandbox.Lastenausgleich
  • Sandbox.Rückruf
  • Sandbox.EnterExit
  • Sandbox.StartStop
  • Sandbox.Leistung
  • Sandkasten-Überwachung
  • Planungsmaschine
  • ServiceBus
  • Geteilt
  • SharePointCollaboration
  • Lösungen
  • Nicht verwaltet.Outlook
  • Unverwaltet.Plattform
  • Unmanaged.Sql
  • Visualisierungen

Trace-Level-Werte

Vollständige Liste der gültigen Werte für die Protokollebene von TraceLevel

  • Aus
  • Fehler
  • Warnung
  • Info
  • Ausführlich

Notiz

Eine Nachricht wird nur protokolliert, wenn die Protokollebene für die Kategorie gleich oder höher als die Ebene der Nachricht ist. Beispielsweise protokolliert eine Ablaufverfolgungsebene von Warnmeldungen, die eine Warnungsstufe und einen Fehler aufweisen. Eine Ablaufverfolgungsebene von Infoprotokollen protokolliert Nachrichten, die eine Ebene von Informationen, Warnungen und Fehler aufweisen. Die Verbosity-Level der Ablaufverfolgung protokolliert alle Nachrichten. Sie sollten eine Protokollierungsebene von "Ausführlich" nur für kurze Zeiträume verwenden.

Beispielkombinationen für Kategorie und Protokollebene

  • *:Verbose

    Notiz

    Die *:Verbose Kombination protokolliert alle Nachrichten in allen Kategorien. Sie sollten die *:Verbose Kombination nur für kurze Dauer verwenden.

  • Application.*:Error

    Notiz

    Mit der Application.*:Error Kombination werden alle Nachrichten der Application.* Kategorie protokolliert, die den Fehlerlevel aufweisen.

  • Platform.*:Warning

    Notiz

    In der Platform.*:Warning Kombination werden alle Nachrichten protokolliert, die die Stufe Warnung oder Fehler für die Platform.* Kategorie aufweisen.

Standardwerte für optionale Registrierungswerte

  • TraceCategories: *:Fehler
  • TraceCallStack: 0
  • TraceDateigrößenlimit: 5

Microsoft Dynamics CRM-E-Mail-Router-Dienstablaufverfolgung

Weitere Informationen finden Sie unter Aktivieren der Ablaufverfolgung für den Microsoft Dynamics CRM-E-Mail-Router.

Wie man die geplante Ablaufverfolgung für den Microsoft Dynamics CRM Server aktiviert

Weitere Informationen finden Sie unter So aktivieren Sie die geplante Ablaufverfolgung für Microsoft Dynamics CRM.

Aktivieren der Ablaufverfolgung für den Microsoft Dynamics CRM für Outlook-Client

Weitere Informationen finden Sie unter Aktivieren der Ablaufverfolgung für den Microsoft Dynamics CRM für Outlook-Client.