Como habilitar o rastreamento em Microsoft Dynamics CRM 2013 e 2011

  • Artigo

Este artigo descreve como habilitar o rastreamento em Microsoft Dynamics CRM.

Aplica-se a: Microsoft Dynamics CRM 2011, Microsoft Dynamics CRM 2013
Número original do KB: 907490

Importante

Esta seção, método ou tarefa contém etapas que descrevem como modificar o Registro. Entretanto, sérios problemas poderão ocorrer caso você modifique o Registro incorretamente. Portanto, siga essas etapas cuidadosamente. Para mais proteção, faça o backup do registro antes de modificá-lo. Em seguida, você poderá restaurar o registro se ocorrer um problema. Para saber mais sobre como fazer o backup e restaurar o registro, consulte Como fazer o backup e restaurar o registro no Windows.

Microsoft Dynamics CRM permite criar arquivos de rastreamento que monitoram as ações executadas por Microsoft Dynamics CRM. Os arquivos de rastreamento são úteis quando você precisa solucionar problemas de mensagens de erro ou outros problemas no Microsoft Dynamics CRM.

Você pode criar arquivos de rastreamento não gerenciados e arquivos de rastreamento gerenciados. As informações nos arquivos de rastreamento não gerenciados e não gerenciados são determinadas por entradas de registro necessárias e opcionais que você cria manualmente. Você cria essas entradas de registro no servidor Microsoft Dynamics CRM ou no computador que está executando o cliente Microsoft Dynamics CRM para o Microsoft Office Outlook depois de instalar Microsoft Dynamics CRM ou o Microsoft Dynamics CRM cliente do Outlook.

Em Microsoft Dynamics CRM 2011 e 2013, você também pode habilitar o rastreamento usando Windows PowerShell applets. Consulte a seção Habilitar configurações de rastreamento por meio de Windows PowerShell para obter mais informações.

Entradas de registro necessárias

A seguir estão as entradas de registro necessárias. Para obter mais informações sobre o local dessas entradas de registro, consulte a seção Locais de entrada do Registro .

Nome Tipo Valor de dados Observações
TraceEnabled DWORD Um valor de 0 ou 1 Se você usar um valor de 0, o rastreamento será desabilitado. Se você usar um valor de 1, o rastreamento será habilitado.
TraceDirectory Cadeia de caracteres C:\CRMTrace A entrada do registro TraceDirectory especifica o diretório para os arquivos de log de rastreamento. O diretório deve existir e o usuário que inicia o Microsoft CRMAppPool deve ter controle total sobre esse diretório. Quando você instala Microsoft Dynamics CRM, o usuário padrão é NT AUTHORITY\NETWORK SERVICE. Essa entrada é necessária apenas para Microsoft Dynamics CRM 3.0. Para versões posteriores, o diretório de rastreamento é definido como o local de instalação dos arquivos do programa Microsoft Dynamics CRM, C:\Arquivos do Programa\Microsoft Dynamics CRM\Trace
TraceRefresh DWORD Um número entre zero e 99 Quando os dados são alterados, as configurações de rastreamento nas outras entradas do registro de rastreamento são aplicadas.

Entradas opcionais do registro

A seguir estão as entradas opcionais do registro.

Nome Tipo Valor de dados Observações
TraceCategories Cadeia de caracteres Category.Feature:TraceLevel A entrada do registro TraceCategories é uma combinação de uma categoria, um recurso e um nível de rastreamento. Você pode especificar várias categorias, recursos e níveis de rastreamento. Separe cada combinação usando um ponto e vírgula. Para obter uma lista de categorias, recursos e níveis de rastreamento e para combinações de exemplo válidas, consulte a seção Valores de nível de rastreamento.
TraceCallStack DWORD Um valor de 0 ou 1 Se você usar um valor de 0, a pilha de chamadas não será incluída no arquivo de rastreamento. Se você usar um valor de 1, a pilha de chamadas será incluída no arquivo de rastreamento.
TraceFileSizeLimit DWORD Um tamanho entre 1 MB e 100 MB A entrada do registro TraceFileSizeLimit especifica o tamanho máximo dos arquivos de rastreamento. Novos arquivos são criados quando o limite é atingido.

Se você não criar as entradas opcionais do registro, os valores de dados padrão serão usados. Para obter mais informações sobre os valores de dados padrão, consulte a seção Valores de dados padrão para entradas de registro opcionais . Se você criar as entradas do registro, mas não especificar valores de dados para as entradas do registro, o rastreamento não funcionará.

Habilitar configurações de rastreamento por meio de Windows PowerShell

Observação

Essas alterações feitas no Windows PowerShell não atualizam o Registro. Essas alterações atualizam as tabelas DeploymentProperties e ServerSettingsProperties no banco de dados MSCRM_CONFIG.

Registrar os cmdlets

  1. Entre na conta de administrador em seu servidor Microsoft Dynamics CRM.
  2. Em uma janela Windows PowerShell, digite o comando: Add-PSSnapin Microsoft.Crm.PowerShell.

Esse comando adiciona o snap-in Microsoft Dynamics CRM Windows PowerShell à sessão atual. O snap-in é registrado durante a instalação e instalação do servidor Microsoft Dynamics CRM.

Para obter uma lista das configurações atuais, digite o comando: Get-CrmSetting TraceSettings.

A saída se assemelhará ao seguinte:

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

Definir as configurações de rastreamento

  1. Digite o comando: $setting = Get-CrmSetting TraceSettings.
  2. Digite o comando para habilitar o rastreamento: $setting.Enabled=$True.
  3. Digite o comando para definir as configurações de rastreamento: Set-CrmSetting $setting.
  4. Digite o comando para obter uma lista atual das configurações de rastreamento: Get-CrmSetting TraceSettings.

Para desabilitar o rastreamento por meio de Windows PowerShell, siga estas mesmas etapas, exceto usar o comando na etapa 2: $setting.Enabled=$False.

Observação

O formato dos comandos de exemplo para cada valor deve ser o seguinte:

  • $setting. Habilitado= $EnabledValue ($True ou $False)
  • $setting. CallStack= $StackValue ($True ou $False)
  • $setting. Categorias ="*:Verbose"
  • $setting. Diretório ="C:\Arquivos do Programa\Microsoft Dynamics CRM\Rastreamento"
  • $setting. FileSize= 10

A saída se assemelhará ao seguinte:

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

Microsoft Dynamics CRM locais de arquivo de log de rastreamento de 2011 e 2013

Quando você cria um rastreamento no Microsoft Dynamics CRM, a chave do registro do Trace Directory é ignorada. Para rastreamento no Microsoft Dynamics CRM, o arquivo de log de rastreamento é criado na seguinte pasta:

Drive:\Program Files\Microsoft Dynamics CRM\Trace

Para rastreamento no cliente Microsoft Dynamics CRM 2011 ou 2013 para o Microsoft Office Outlook, o arquivo de log de rastreamento será criado na pasta a seguir se você tiver a Atualização Rollup 7 ou uma atualização cumulativa posterior instalada:

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

Locais de entrada do Registro

As entradas do registro de rastreamento do servidor Microsoft Dynamics CRM estão localizadas na subchave do registro a seguir:

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRM

O cliente Microsoft Dynamics CRM para as entradas de registro de rastreamento do Outlook está localizado na subchave de registro a seguir:

HKEY_CURRENT_USER\SOFTWARE\MICROSOFT\MSCRMClient

As entradas do registro de rastreamento do Conector de Dados do SSRS Microsoft Dynamics CRM estão localizadas na seguinte subchave de registro:

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRMBidsExtensions

As entradas do registro de rastreamento do Gerenciador de Migração de Dados Microsoft Dynamics CRM estão localizadas na subchave do registro a seguir:

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\DATA MIGRATION WIZARD

Lista completa de valores de categoria para a entrada do registro TraceCategories

Microsoft Dynamics CRM 2011 e 2013

  • ADUtility
  • Application
  • Application.Outlook
  • DataMigration
  • Implantação
  • Deployment.Provisioning
  • Deployment.Sdk
  • Exception
  • Etm
  • Viver
  • Live.AggregationDataExport
  • Live.PartnerInteraction
  • Live.Platform
  • Live.Portal
  • Live.Provisioning
  • Live.Support
  • Live.SyncDaemon
  • Monitoramento
  • NewOrgUtility
  • ObjectModel
  • ParameterFilter
  • Plataforma
  • Platform.Async
  • Platform.ImportExportPublish
  • Platform.Import
  • Platform.Metadata
  • Platform.Sdk
  • Platform.Soap
  • Platform.Sql
  • Platform.Workflow
  • Relatórios
  • Área restrita
  • Sandbox.AssemblyCache
  • Sandbox.LoadBalancer
  • Sandbox.CallReturn
  • Sandbox.EnterExit
  • Sandbox.StartStop
  • Sandbox.Performance
  • Sandbox.Monitoring
  • SchedulingEngine
  • Servicebus
  • Compartilhados
  • SharePointCollaboration
  • Soluções
  • Não gerenciado.Outlook
  • Unmanaged.Platform
  • Não gerenciado.Sql
  • Visualizações

Valores de nível de rastreamento

Lista completa de valores de nível de rastreamento válidos para TraceLevel

  • Desligado
  • Erro
  • Aviso
  • Informação
  • Detalhado

Observação

Uma mensagem será registrada somente se o nível de rastreamento da categoria for igual ou maior que o nível da mensagem. Por exemplo, um nível de rastreamento de mensagens de logs de aviso que têm um nível de Aviso e de Erro. Um nível de rastreamento de mensagens de logs de informações que têm um nível de Informações, de Aviso e de Erro. Um nível de rastreamento de Verbose registra todas as mensagens. Você deve usar um nível de rastreamento de Verbose apenas para durações curtas.

Combinações de categoria de exemplo e nível de rastreamento

  • *:Verbose

    Observação

    A *:Verbose combinação registra todas as mensagens em todas as categorias. Você só deve usar a *:Verbose combinação para durações curtas.

  • Application.*:Error

    Observação

    A Application.*:Error combinação registra todas as mensagens que têm um nível de Erro para a Application.* categoria.

  • Platform.*:Warning

    Observação

    A Platform.*:Warning combinação registra todas as mensagens que têm um nível de Aviso ou Erro para a Platform.* categoria.

Valores de dados padrão para valores opcionais do registro

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

rastreamento do serviço roteador de email Microsoft Dynamics CRM

Para obter mais informações, consulte Como habilitar o rastreamento para o roteador de email Microsoft Dynamics CRM.

Como habilitar o rastreamento agendado para Microsoft Dynamics CRM Server

Para obter mais informações, consulte Como habilitar o Rastreamento Agendado para Microsoft Dynamics CRM.

Como habilitar o rastreamento do Microsoft Dynamics CRM para o cliente do Outlook

Para obter mais informações, consulte Como habilitar o rastreamento para o Microsoft Dynamics CRM para o cliente do Outlook.