Включение трассировки в Microsoft Dynamics CRM 2013 и 2011

  • Статья

В этой статье описывается включение трассировки в Microsoft Dynamics CRM.

Область применения: Microsoft Dynamics CRM 2011, Microsoft Dynamics CRM 2013
Оригинальный номер базы знаний: 907490

Важно!

В этот раздел, описание метода или задачи включены действия, содержащие указания по изменению параметров реестра. Однако неправильное изменение параметров реестра может привести к возникновению серьезных проблем. Поэтому следует в точности выполнять приведенные инструкции. Для дополнительной защиты создайте резервную копию реестра, прежде чем редактировать его. Так вы сможете восстановить реестр, если возникнет проблема. Для получения дополнительной информации о том, как создать резервную копию и восстановить реестр, см. статью Сведения о резервном копировании и восстановлении реестра Windows.

Microsoft Dynamics CRM позволяет создавать файлы трассировки, отслеживающие действия, выполняемые Microsoft Dynamics CRM. Файлы трассировки полезны при устранении неполадок с сообщениями об ошибках или других проблемах в Microsoft Dynamics CRM.

Можно создавать неуправляемые файлы трассировки и управляемые файлы трассировки. Сведения в неуправляемых и управляемых файлах трассировки определяются обязательными и необязательными записями реестра, созданными вручную. Эти записи реестра создаются на сервере Microsoft Dynamics CRM или на компьютере с клиентом Microsoft Dynamics CRM для Microsoft Office Outlook после установки Microsoft Dynamics CRM или Microsoft Dynamics CRM клиент для Outlook.

В Microsoft Dynamics CRM 2011 и 2013 годах можно также включить трассировку с помощью Windows PowerShell апплетов. Дополнительные сведения см. в разделе Включение параметров трассировки с помощью Windows PowerShell.

Обязательные записи реестра

Ниже приведены необходимые записи реестра. Дополнительные сведения о расположении этих записей реестра см. в разделе Расположения записей реестра .

Имя Тип Значение данных Примечания
TraceEnabled DWORD Значение 0 или 1 Если используется значение 0, трассировка отключена. Если используется значение 1, трассировка включена.
TraceDirectory String C:\CRMTrace Запись реестра TraceDirectory указывает каталог для файлов журнала трассировки. Каталог должен существовать, и пользователь, запускающий Microsoft CRMAppPool, должен иметь полный контроль над этим каталогом. При установке Microsoft Dynamics CRM по умолчанию используется NT AUTHORITY\NETWORK SERVICE. Эта запись требуется только для Microsoft Dynamics CRM 3.0. Для более поздних версий в каталоге трассировки устанавливается расположение установки файлов программы Microsoft Dynamics CRM C:\Program Files\Microsoft Dynamics CRM\Trace.
TraceRefresh DWORD Число от нуля до 99 При изменении данных применяются параметры трассировки в других записях реестра трассировки.

Необязательные записи реестра

Ниже приведены необязательные записи реестра.

Имя Тип Значение данных Примечания
Категории трассировки String Category.Feature:TraceLevel Запись реестра TraceCategories представляет собой сочетание категории, компонента и уровня трассировки. Можно указать несколько категорий, компонентов и уровней трассировки. Разделите каждую комбинацию с помощью точки с запятой. Список категорий, компонентов и уровней трассировки, а также примеры допустимых сочетаний см. в разделе Значения уровня трассировки .
TraceCallStack DWORD Значение 0 или 1 Если используется значение 0, стек вызовов не включается в файл трассировки. Если используется значение 1, стек вызовов включается в файл трассировки.
TraceFileSizeLimit DWORD Размер от 1 МБ до 100 МБ Запись реестра TraceFileSizeLimit указывает максимальный размер файлов трассировки. При достижении ограничения создаются новые файлы.

Если необязательные записи реестра не создаются, используются значения данных по умолчанию. Дополнительные сведения о значениях данных по умолчанию см. в разделе Значения данных по умолчанию для необязательных записей реестра . Если вы создаете записи реестра, но не указываете значения данных для записей реестра, трассировка не будет работать.

Включение параметров трассировки с помощью Windows PowerShell

Примечание.

Эти изменения, внесенные в Windows PowerShell, не обновляют реестр. Эти изменения обновляют таблицы DeploymentProperties и ServerSettingsProperties в базе данных MSCRM_CONFIG.

Регистрация командлетов

  1. Войдите в учетную запись администратора на сервере Microsoft Dynamics CRM.
  2. В окне Windows PowerShell введите команду : Add-PSSnapin Microsoft.Crm.PowerShell.

Эта команда добавляет оснастку Microsoft Dynamics CRM Windows PowerShell в текущий сеанс. Оснастка регистрируется во время установки и установки сервера Microsoft Dynamics CRM.

Чтобы получить список текущих параметров, введите команду : Get-CrmSetting TraceSettings.

Выходные данные будут выглядеть следующим образом:

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

Настройка параметров трассировки

  1. Введите команду : $setting = Get-CrmSetting TraceSettings.
  2. Введите команду , чтобы включить трассировку: $setting.Enabled=$True.
  3. Введите команду , чтобы задать параметры трассировки: Set-CrmSetting $setting.
  4. Введите команду , чтобы получить текущий список параметров трассировки: Get-CrmSetting TraceSettings.

Чтобы отключить трассировку с помощью Windows PowerShell, выполните те же действия, за исключением команды на шаге 2: $setting.Enabled=$False.

Примечание.

Формат примеров команд для каждого значения должен быть следующим:

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

Выходные данные будут выглядеть следующим образом:

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

расположения файлов журналов трассировки Microsoft Dynamics CRM 2011 и 2013

При создании трассировки в Microsoft Dynamics CRM раздел реестра Trace Directory игнорируется. Для трассировки в Microsoft Dynamics CRM файл журнала трассировки создается в следующей папке:

Диск:\Program Files\Microsoft Dynamics CRM\Trace

Для трассировки в клиенте Microsoft Dynamics CRM 2011 или 2013 для Microsoft Office Outlook файл журнала трассировки создается в следующей папке при наличии накопительного пакета обновления 7 или более поздней версии накопительного пакета обновления:

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

Расположения записей реестра

Записи реестра Microsoft Dynamics CRM трассировки сервера находятся в следующем подразделе реестра:

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRM

Записи реестра Microsoft Dynamics CRM клиента для трассировки Outlook находятся в следующем подразделе реестра:

HKEY_CURRENT_USER\SOFTWARE\MICROSOFT\MSCRMClient

Записи реестра трассировки соединителя данных SSRS Microsoft Dynamics CRM находятся в следующем подразделе реестра:

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRMBidsExtensions

Записи реестра трассировки диспетчера миграции данных Microsoft Dynamics CRM находятся в следующем подразделе реестра:

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\DATA MIGRATION WIZARD

Полный список значений категорий для записи реестра TraceCategories

Microsoft Dynamics CRM 2011 и 2013

  • ADUtility
  • Приложение
  • Application.Outlook
  • DataMigration
  • Развертывание
  • Deployment.Provisioning
  • Deployment.Sdk
  • Exception
  • Etm
  • Жить
  • Live.AggregationDataExport
  • Live.PartnerInteraction
  • Live.Platform
  • Live.Portal
  • Live.Provisioning
  • Live.Support
  • Live.SyncDaemon
  • Мониторинг
  • NewOrgUtility
  • ObjectModel
  • ParameterFilter
  • Платформа
  • Platform.Async
  • Platform.ImportExportPublish
  • Platform.Import
  • Platform.Metadata
  • Platform.Sdk
  • Platform.Soap
  • Platform.Sql
  • Platform.Workflow
  • Отчеты
  • Песочница
  • Sandbox.AssemblyCache
  • Sandbox.LoadBalancer
  • Sandbox.CallReturn
  • Sandbox.EnterExit
  • Sandbox.StartStop
  • Песочница.Производительность
  • Песочница.Мониторинг
  • ПланированиеEngine
  • ServiceBus
  • Shared
  • SharePointCollaboration
  • Решения
  • Неуправляемый.Outlook
  • Неуправляемая.Платформа
  • Unmanaged.Sql
  • Визуализации

Значения уровня трассировки

Полный список допустимых значений уровня трассировки для TraceLevel

  • Выкл.
  • Error
  • Предупреждение
  • Информация
  • Подробный

Примечание.

Сообщение регистрируется только в том случае, если уровень трассировки для категории равен или превышает уровень сообщения. Например, уровень трассировки предупреждения регистрирует сообщения с уровнем Предупреждения и Ошибки. Уровень трассировки сообщений Info регистрирует в журнале, которые имеют уровень "Информация", "Предупреждение" и "Ошибка". Уровень трассировки подробно регистрирует все сообщения. Уровень трассировки следует использовать только в течение короткого периода времени.

Примеры сочетаний категорий и уровней трассировки

  • *:Verbose

    Примечание.

    Сочетание *:Verbose регистрирует все сообщения во всех категориях. Сочетание следует использовать только в течение короткого *:Verbose периода времени.

  • Application.*:Error

    Примечание.

    Сочетание Application.*:Error регистрирует все сообщения с уровнем Error для Application.* категории.

  • Platform.*:Warning

    Примечание.

    Сочетание Platform.*:Warning регистрирует все сообщения с уровнем Предупреждения или Ошибки для Platform.* категории.

Значения данных по умолчанию для необязательных значений реестра

  • Категории трассировки: *:Error
  • TraceCallStack: 0
  • TraceFileSizeLimit: 5

трассировка службы маршрутизатора электронной почты Microsoft Dynamics CRM

Дополнительные сведения см. в разделе Включение трассировки для маршрутизатора электронной почты Microsoft Dynamics CRM.

Включение запланированной трассировки для сервера Microsoft Dynamics CRM

Дополнительные сведения см. в разделе Включение запланированной трассировки для Microsoft Dynamics CRM.

Включение трассировки для клиента Microsoft Dynamics CRM outlook

Дополнительные сведения см. в статье Включение трассировки для Microsoft Dynamics CRM для клиента Outlook.