Aktivieren der Ablaufverfolgung in Microsoft Dynamics CRM 2013 und 2011

  • Artikel

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 ist es wichtig, bei der Ausführung der folgenden Schritte sorgfältig vorzugehen. Für zusätzlichen Schutz sichern Sie die Registrierung, bevor Sie sie ändern. Sie können die Registrierung wiederherstellen, wenn ein Problem auftritt. Weitere Informationen zum Sichern und Wiederherstellen der Registrierung finden Sie unter Sichern und Wiederherstellen der Registrierung in 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 nicht verwalteten und verwalteten Ablaufverfolgungsdateien 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 die Microsoft Dynamics CRM Client für Outlook.

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

Im Folgenden sind die erforderlichen Registrierungseinträge aufgeführt. Weitere Informationen zum Speicherort dieser Registrierungseinträge finden Sie im Abschnitt Speicherorte für Registrierungseinträge .

Name Typ Datenwert Anmerkungen
TraceEnabled 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 Microsoft CRMAppPool startet, muss die vollständige Kontrolle über dieses Verzeichnis haben. Wenn Sie Microsoft Dynamics CRM installieren, ist der Standardbenutzer NT AUTHORITY\NETWORK SERVICE. Dieser Eintrag ist nur für Microsoft Dynamics CRM 3.0 erforderlich. Bei höheren Versionen ist das Ablaufverfolgungsverzeichnis auf den Installationsspeicherort der Microsoft Dynamics CRM Programmdateien festgelegt: C:\Programme\Microsoft Dynamics CRM\Trace
TraceRefresh DWORD Eine Zahl zwischen 0 und 99 Wenn die Daten geändert werden, werden die Ablaufverfolgungseinstellungen in den anderen Registrierungseinträgen der Ablaufverfolgung angewendet.

Optionale Registrierungseinträge

Im Folgenden sind die optionalen Registrierungseinträge aufgeführt.

Name Typ Datenwert Anmerkungen
TraceCategories Zeichenfolge Category.Feature:TraceLevel Der Registrierungseintrag TraceCategories ist eine Kombination aus einer Kategorie, einem Feature und einer Ablaufverfolgungsebene. Sie können mehrere Kategorien, Features und Ablaufverfolgungsebenen angeben. Trennen Sie jede Kombination mithilfe eines Semikolons. Eine Liste der Kategorien, Features und Ablaufverfolgungsebenen sowie gültige Beispielkombinationen finden Sie im Abschnitt Werte der Ablaufverfolgungsebene .
TraceCallStack DWORD Ein Wert von 0 oder 1 Wenn Sie den Wert 0 verwenden, ist die Aufrufliste nicht in der Ablaufverfolgungsdatei enthalten. Wenn Sie den Wert 1 verwenden, ist die Aufrufliste in der Ablaufverfolgungsdatei enthalten.
TraceFileSizeLimit DWORD Eine Größe zwischen 1 MB und 100 MB Der Registrierungseintrag TraceFileSizeLimit gibt die maximale Größe von Ablaufverfolgungsdateien an. Neue Dateien werden erstellt, wenn der Grenzwert erreicht ist.

Wenn Sie die optionalen Registrierungseinträge nicht erstellen, werden die Standarddatenwerte verwendet. Weitere Informationen zu den Standarddatenwerten 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 Ablaufverfolgungseinstellungen über Windows PowerShell

Hinweis

Diese In Windows PowerShell vorgenommenen Änderungen aktualisieren die Registrierung nicht. Diese Änderungen aktualisieren die Tabellen DeploymentProperties und ServerSettingsProperties in der datenbank MSCRM_CONFIG.

Registrieren der Cmdlets

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

Dieser Befehl fügt der aktuellen Sitzung das Microsoft Dynamics CRM Windows PowerShell-Snap-In hinzu. Das Snap-In wird während der Installation und Einrichtung des Microsoft Dynamics CRM Servers registriert.

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

Die Ausgabe sieht wie folgt aus:

CallStack : True Categories : *:Error Directory : c:\crmdrop\logs Enabled : False FileSize : 10 ExtensionData : System.Runtime.Serialization.ExtensionDataObject

Festlegen der Ablaufverfolgungseinstellungen

  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 Ablaufverfolgungseinstellungen festzulegen: Set-CrmSetting $setting.
  4. Geben Sie den Befehl ein, um eine aktuelle Liste der Ablaufverfolgungseinstellungen abzurufen: Get-CrmSetting TraceSettings.

Führen Sie zum Deaktivieren der Ablaufverfolgung über Windows PowerShell die gleichen Schritte aus, mit ausnahme des Befehls in Schritt 2: $setting.Enabled=$False.

Hinweis

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

  • $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 sieht wie folgt aus:

CallStack : True Categories : *:Error Directory : c:\crmdrop\logs Enabled : True FileSize : 10 ExtensionData : System.Runtime.Serialization.ExtensionDataObject

Speicherorte der Microsoft Dynamics CRM 2011- und 2013-Ablaufverfolgungsprotokolldateien

Wenn Sie eine Ablaufverfolgung in Microsoft Dynamics CRM erstellen, wird der Registrierungsschlüssel des Ablaufverfolgungsverzeichnisses ignoriert. Für die Ablaufverfolgung auf dem Microsoft Dynamics CRM wird die Ablaufverfolgungsprotokolldatei im folgenden Ordner erstellt:

Laufwerk:\Programme\Microsoft Dynamics CRM\Trace

Für die Ablaufverfolgung auf dem Microsoft Dynamics CRM 2011- oder 2013-Client für Microsoft Office Outlook wird die Ablaufverfolgungsprotokolldatei im folgenden Ordner erstellt, wenn Updaterollup 7 oder ein späteres kumulatives Update installiert ist:

DriveName:\ InstallingUser \Local Settings\Application Data\Microsoft\MSCRM\Traces

Speicherorte für Registrierungseinträge

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

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRM

Die Microsoft Dynamics CRM Client für Outlook-Ablaufverfolgungsregistrierungseinträge befinden sich im folgenden Registrierungsunterschlüssel:

HKEY_CURRENT_USER\SOFTWARE\MICROSOFT\MSCRMClient

Die Microsoft Dynamics CRM SSRS-Datenconnector-Ablaufverfolgungsregistrierungseinträge befinden sich im folgenden Registrierungsunterschlüssel:

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRMBidsExtensions

Die Microsoft Dynamics CRM Data Migration Manager-Ablaufverfolgungsregistrierungseinträge 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
  • App
  • Application.Outlook
  • DataMigration
  • Bereitstellung)
  • Deployment.Provisioning
  • Deployment.Sdk
  • Ausnahme
  • Etm
  • Live
  • Live.AggregationDataExport
  • Live.PartnerInteraction
  • Live.Platform
  • Live.Portal
  • Live.Provisioning
  • Live.Support
  • Live.SyncDaemon
  • Überwachung
  • NewOrgUtility
  • ObjectModel
  • ParameterFilter
  • Plattform
  • Platform.Async
  • Platform.ImportExportPublish
  • Platform.Import
  • Platform.Metadata
  • Platform.Sdk
  • Platform.Soap
  • Platform.Sql
  • Platform.Workflow
  • Berichte
  • Sandbox
  • Sandbox.AssemblyCache
  • Sandbox.LoadBalancer
  • Sandbox.CallReturn
  • Sandbox.EnterExit
  • Sandbox.StartStop
  • Sandbox.Performance
  • Sandbox.Monitoring
  • SchedulingEngine
  • ServiceBus
  • Shared
  • SharePointCollaboration
  • Lösungen
  • Unmanaged.Outlook
  • Unmanaged.Platform
  • Unmanaged.Sql
  • Visualisierungen

Werte auf Ablaufverfolgungsebene

Vollständige Liste der gültigen Werte auf Ablaufverfolgungsebene für TraceLevel

  • Aus
  • Error
  • Warnung
  • Informationen
  • Ausführlich

Hinweis

Eine Nachricht wird nur protokolliert, wenn die Ablaufverfolgungsebene für die Kategorie gleich oder größer als die Ebene der Nachricht ist. Beispielsweise protokolliert eine Ablaufverfolgungsebene von Warnungen Meldungen mit den Ebenen Warnung und Fehler. Eine Ablaufverfolgungsebene von Info protokolliert Meldungen mit der Ebene "Info", "Warnung" und "Fehler". Eine Ablaufverfolgungsebene von Ausführlich protokolliert alle Nachrichten. Sie sollten die Ablaufverfolgungsebene Ausführlich nur für kurze Zeiträume verwenden.

Kombinationen aus Beispielkategorie und Ablaufverfolgungsebene

  • *:Verbose

    Hinweis

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

  • Application.*:Error

    Hinweis

    Die Application.*:Error Kombination protokolliert alle Meldungen mit der Ebene Fehler für die Application.* Kategorie.

  • Platform.*:Warning

    Hinweis

    Die Platform.*:Warning Kombination protokolliert alle Meldungen mit der Ebene Warnung oder Fehler für die Platform.* Kategorie.

Standardwerte für optionale Registrierungswerte

  • TraceCategories: *:Error
  • TraceCallStack: 0
  • TraceFileSizeLimit: 5

Ablaufverfolgung des Microsoft Dynamics CRM-E-Mail-Routerdiensts

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

Aktivieren der geplanten Ablaufverfolgung für Microsoft Dynamics CRM Server

Weitere Informationen finden Sie unter Aktivieren der geplanten 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 den Outlook-Client.