Comment activer le suivi dans Microsoft Dynamics CRM 2013 et 2011

  • Article

Cet article explique comment activer le suivi dans Microsoft Dynamics CRM.

S’applique à : Microsoft Dynamics CRM 2011, Microsoft Dynamics CRM 2013
Numéro de la base de connaissances d’origine : 907490

Importante

Cette section, méthode ou tâche contient des étapes vous indiquant comment modifier le Registre. Toutefois, des problèmes graves peuvent se produire si vous modifiez le Registre de façon incorrecte. Par conséquent, veillez à suivre ces étapes scrupuleusement. Pour une meilleure protection, sauvegardez le registre avant de le modifier. Vous pouvez alors le restaurer en cas de problème. Pour plus d’informations sur la procédure de sauvegarde et de restauration du Registre, consultez l’article Comment sauvegarder et restaurer le Registre dans Windows.

Microsoft Dynamics CRM vous permet de créer des fichiers de trace qui surveillent les actions effectuées par Microsoft Dynamics CRM. Les fichiers de trace sont utiles lorsque vous devez résoudre les messages d’erreur ou d’autres problèmes dans Microsoft Dynamics CRM.

Vous pouvez créer des fichiers de trace non managés et des fichiers de trace managés. Les informations contenues dans les fichiers de trace non managés et managés sont déterminées par les entrées de Registre obligatoires et facultatives que vous créez manuellement. Vous créez ces entrées de Registre sur le serveur Microsoft Dynamics CRM ou sur l’ordinateur qui exécute le client Microsoft Dynamics CRM pour Microsoft Office Outlook après avoir installé Microsoft Dynamics CRM ou le Microsoft Dynamics CRM client pour Outlook.

Dans Microsoft Dynamics CRM 2011 et 2013, vous pouvez également activer le suivi à l’aide d’applets Windows PowerShell. Pour plus d’informations, consultez la section Activer les paramètres de trace via Windows PowerShell.

Entrées de Registre requises

Voici les entrées de Registre requises. Pour plus d’informations sur l’emplacement de ces entrées de Registre, consultez la section Emplacements des entrées du Registre .

Nom Type Valeur des données Notes
TraceEnabled DWORD Valeur 0 ou 1 Si vous utilisez la valeur 0, le suivi est désactivé. Si vous utilisez la valeur 1, le suivi est activé.
TraceDirectory String C :\CRMTrace L’entrée de Registre TraceDirectory spécifie le répertoire des fichiers journaux de suivi. Le répertoire doit exister et l’utilisateur qui démarre Microsoft CRMAppPool doit avoir un contrôle total sur ce répertoire. Lorsque vous installez Microsoft Dynamics CRM, l’utilisateur par défaut est NT AUTHORITY\NETWORK SERVICE. Cette entrée n’est requise que pour Microsoft Dynamics CRM 3.0. Pour les versions ultérieures, le répertoire de trace est défini sur l’emplacement d’installation des fichiers programme Microsoft Dynamics CRM, C :\Program Files\Microsoft Dynamics CRM\Trace
TraceRefresh DWORD Nombre compris entre zéro et 99 Lorsque les données sont modifiées, les paramètres de trace dans les autres entrées de registre de suivi sont appliqués.

Entrées de Registre facultatives

Voici les entrées de Registre facultatives.

Nom Type Valeur des données Notes
TraceCategories String Category.Feature :TraceLevel L’entrée de Registre TraceCategories est une combinaison d’une catégorie, d’une fonctionnalité et d’un niveau de trace. Vous pouvez spécifier plusieurs catégories, fonctionnalités et niveaux de trace. Séparez chaque combinaison à l’aide d’un point-virgule. Pour obtenir la liste des catégories, des fonctionnalités et des niveaux de trace et pour obtenir des exemples de combinaisons valides, consultez la section Valeurs du niveau de trace.
TraceCallStack DWORD Valeur 0 ou 1 Si vous utilisez la valeur 0, la pile des appels n’est pas incluse dans le fichier de trace. Si vous utilisez la valeur 1, la pile des appels est incluse dans le fichier de trace.
TraceFileSizeLimit DWORD Taille comprise entre 1 Mo et 100 Mo L’entrée de Registre TraceFileSizeLimit spécifie la taille maximale des fichiers de trace. De nouveaux fichiers sont créés lorsque la limite est atteinte.

Si vous ne créez pas les entrées de Registre facultatives, les valeurs de données par défaut sont utilisées. Pour plus d’informations sur les valeurs de données par défaut, consultez la section Valeurs de données par défaut pour les entrées de Registre facultatives . Si vous créez les entrées de Registre, mais que vous ne spécifiez pas de valeurs de données pour les entrées du Registre, le suivi ne fonctionnera pas.

Activer les paramètres de trace via Windows PowerShell

Remarque

Ces modifications apportées dans Windows PowerShell ne mettent pas à jour le Registre. Ces modifications mettent à jour les tables DeploymentProperties et ServerSettingsProperties dans la base de données MSCRM_CONFIG.

Inscrire les applets de commande

  1. Connectez-vous au compte administrateur sur votre serveur Microsoft Dynamics CRM.
  2. Dans une fenêtre Windows PowerShell, tapez la commande : Add-PSSnapin Microsoft.Crm.PowerShell.

Cette commande ajoute le composant logiciel enfichable Microsoft Dynamics CRM Windows PowerShell à la session active. Le composant logiciel enfichable est inscrit lors de l’installation et de l’installation du serveur Microsoft Dynamics CRM.

Pour obtenir la liste des paramètres actuels, tapez la commande : Get-CrmSetting TraceSettings.

La sortie se présente comme suit :

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

Définir les paramètres de trace

  1. Tapez la commande : $setting = Get-CrmSetting TraceSettings.
  2. Tapez la commande pour activer le suivi : $setting.Enabled=$True.
  3. Tapez la commande pour définir les paramètres de trace : Set-CrmSetting $setting.
  4. Tapez la commande pour obtenir la liste actuelle des paramètres de trace : Get-CrmSetting TraceSettings.

Pour désactiver le suivi via Windows PowerShell, suivez ces mêmes étapes, à l’exception de la commande de l’étape 2 : $setting.Enabled=$False.

Remarque

Le format des exemples de commandes pour chaque valeur doit être le suivant :

  • $setting. Enabled= $EnabledValue ($True ou $False)
  • $setting. CallStack= $StackValue ($True ou $False)
  • $setting. Categories ="* :Verbose »
  • $setting. Répertoire ="C :\Program Files\Microsoft Dynamics CRM\Trace »
  • $setting. FileSize= 10

La sortie se présente comme suit :

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

emplacements des fichiers journaux de trace Microsoft Dynamics CRM 2011 et 2013

Lorsque vous créez une trace dans Microsoft Dynamics CRM, la clé de Registre Du répertoire de traces est ignorée. Pour le suivi sur le Microsoft Dynamics CRM, le fichier journal de trace est créé dans le dossier suivant :

Lecteur :\Program Files\Microsoft Dynamics CRM\Trace

Pour le suivi sur le client Microsoft Dynamics CRM 2011 ou 2013 pour Microsoft Office Outlook, le fichier journal de trace est créé dans le dossier suivant si vous avez installé le correctif cumulatif 7 ou une mise à jour cumulative ultérieure :

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

Emplacements des entrées de registre

Les entrées de Registre de suivi du serveur Microsoft Dynamics CRM se trouvent dans la sous-clé de Registre suivante :

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRM

Le client Microsoft Dynamics CRM pour les entrées de Registre de suivi Outlook se trouve dans la sous-clé de Registre suivante :

HKEY_CURRENT_USER\SOFTWARE\MICROSOFT\MSCRMClient

Les Microsoft Dynamics CRM entrées de Registre de suivi du connecteur de données SSRS se trouvent dans la sous-clé de Registre suivante :

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRMBidsExtensions

Les entrées de Registre de suivi du Gestionnaire de migration de données Microsoft Dynamics CRM se trouvent dans la sous-clé de Registre suivante :

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\DATA MIGRATION WIZARD

Liste complète des valeurs de catégorie pour l’entrée de Registre TraceCategories

Microsoft Dynamics CRM 2011 et 2013

  • ADUtility
  • Application
  • Application.Outlook
  • DataMigration
  • Déploiement
  • Deployment.Provisioning
  • Deployment.Sdk
  • Exception
  • Etm
  • Vivre
  • Live.AggregationDataExport
  • Live.PartnerInteraction
  • Live.Platform
  • Live.Portal
  • Live.Provisioning
  • Live.Support
  • Live.SyncDaemon
  • Analyse
  • NewOrgUtility
  • ObjectModel
  • ParameterFilter
  • Plateforme
  • Platform.Async
  • Platform.ImportExportPublish
  • Platform.Import
  • Platform.Metadata
  • Platform.Sdk
  • Platform.Soap
  • Platform.Sql
  • Platform.Workflow
  • Rapports
  • Bac à sable
  • Sandbox.AssemblyCache
  • Sandbox.LoadBalancer
  • Sandbox.CallReturn
  • Sandbox.EnterExit
  • Sandbox.StartStop
  • Sandbox.Performance
  • Sandbox.Monitoring
  • PlanningEngine
  • ServiceBus
  • Shared
  • SharePointCollaboration
  • Solutions
  • Unmanaged.Outlook
  • Unmanaged.Platform
  • Unmanaged.Sql
  • Visualisations

Valeurs de niveau de trace

Liste complète des valeurs de niveau de trace valides pour TraceLevel

  • Désactivé
  • Erreur
  • Avertissement
  • Info
  • Détaillé

Remarque

Un message est journalisé uniquement si le niveau de trace pour la catégorie est supérieur ou égal au niveau du message. Par exemple, un niveau de trace d’Avertissement journalise les messages qui ont un niveau d’avertissement et d’erreur. Un niveau de trace d’Informations journalise les messages qui ont un niveau d’informations, d’avertissement et d’erreur. Un niveau de trace de Verbose journalise tous les messages. Vous devez utiliser un niveau de trace de Verbose uniquement pour de courtes durées.

Exemples de combinaisons de niveaux de catégorie et de trace

  • *:Verbose

    Remarque

    La *:Verbose combinaison enregistre tous les messages de toutes les catégories. Vous devez utiliser la *:Verbose combinaison uniquement pour de courtes durées.

  • Application.*:Error

    Remarque

    La Application.*:Error combinaison journalise tous les messages qui ont un niveau d’erreur pour la Application.* catégorie.

  • Platform.*:Warning

    Remarque

    La Platform.*:Warning combinaison enregistre tous les messages qui ont un niveau d’avertissement ou d’erreur pour la Platform.* catégorie.

Valeurs de données par défaut pour les valeurs de Registre facultatives

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

suivi du service routeur de messagerie Microsoft Dynamics CRM

Pour plus d’informations, consultez Comment activer le suivi pour le routeur de messagerie Microsoft Dynamics CRM.

Comment activer le suivi planifié pour Microsoft Dynamics CRM Server

Pour plus d’informations, consultez Comment activer le suivi planifié pour Microsoft Dynamics CRM.

Comment activer le suivi pour le client Microsoft Dynamics CRM pour Outlook

Pour plus d’informations, voir Guide pratique pour activer le suivi pour le client Microsoft Dynamics CRM pour Outlook.