Sobre arquivos de log no Configuration Manager

  • Artigo

Aplica-se a: Gerenciador de Configurações (branch atual)

Em Configuration Manager, os componentes do servidor do cliente e do site registram informações do processo em arquivos de log individuais. Você pode usar as informações nesses arquivos de log para ajudá-lo a solucionar problemas que podem ocorrer. Por padrão, Configuration Manager habilita o registro em log para componentes do cliente e do servidor.

Este artigo fornece informações gerais sobre os arquivos de log Configuration Manager. Ele inclui ferramentas a serem usadas, como configurar os logs e onde encontrá-los. Para obter mais informações sobre arquivos de log específicos, consulte Referência de arquivos de log.

Como funciona

A maioria dos processos em Configuration Manager grava informações operacionais em um arquivo de log dedicado a esse processo. Os arquivos de log são identificados por .log ou .lo_ extensões de arquivo. Configuration Manager grava em um .log arquivo até que esse log atinja seu tamanho máximo. Quando o log está cheio, o .log arquivo é copiado para um arquivo de mesmo nome, mas com a .lo_ extensão, e o processo ou componente continua a ser gravado no .log arquivo. Quando o .log arquivo atinge novamente seu tamanho máximo, o .lo_ arquivo é substituído e o processo se repete. Alguns componentes estabelecem um histórico de arquivos de log acrescentando um carimbo de data e hora ao nome do arquivo de log e mantendo a .log extensão.

Ferramentas de visualizador de log

Todos os arquivos de log Configuration Manager são texto simples, para que você possa exibi-los com qualquer leitor de texto como Bloco de Notas. Os logs usam a formatação exclusiva que é melhor visualizada com uma das seguintes ferramentas especializadas:

CMTrace

Para exibir os logs, use a ferramenta de visualizador de log Configuration Manager CMTrace. Ele está localizado na \SMSSetup\Tools pasta do Configuration Manager mídia de origem. A ferramenta CMTrace é adicionada a todas as imagens de inicialização adicionadas à Biblioteca de Software. A ferramenta de exibição de log do CMTrace é instalada automaticamente junto com o cliente Configuration Manager. Para obter mais informações, consulte CMTrace.

OneTrace

O OneTrace é um visualizador de log com a Central de Suporte. Ele funciona de forma semelhante ao CMTrace, com melhorias. Para obter mais informações, consulte Centro de Suporte OneTrace.

Visualizador de arquivos de log do Centro de Suporte

O Centro de Suporte inclui um visualizador de log moderno. Essa ferramenta substitui o CMTrace e fornece uma interface personalizável com suporte para guias e janelas encaixadas. Ele tem uma camada de apresentação rápida e pode carregar arquivos de log grandes em segundos. Para obter mais informações, consulte Visualizador de arquivos de log do Centro de Suporte.

Observação

O Visualizador de Arquivos de Log do Centro de Suporte e o OneTrace usam Windows Presentation Foundation (WPF). Esse componente não está disponível no Windows PE. Continue a usar o CMTrace em imagens de inicialização com implantações de sequência de tarefas.

Configurar opções de log

Você pode alterar a configuração dos arquivos de log, como o nível, o tamanho e o histórico verbosos. Há várias maneiras de alterar essas configurações:

Você também pode usar o inventário de hardware para coletar configurações de log de clientes.

Configurar opções de log durante a instalação do cliente

Você pode definir a configuração dos arquivos de log do cliente durante a instalação. Use as seguintes propriedades:

  • CCMENABLELOGGING
  • CCMDEBUGLOGGING
  • CCMLOGLEVEL
  • CCMLOGMAXHISTORY
  • CCMLOGMAXSIZE

Para obter mais informações, consulte Propriedades de instalação do cliente.

Configurar opções de log usando Configuration Manager Service Manager

Você pode alterar onde Configuration Manager armazena os arquivos de log e o tamanho deles.

Para modificar o tamanho dos arquivos de log, altere o nome e o local do arquivo de log ou para forçar vários componentes a gravar em um único arquivo de log, faça as seguintes etapas:

Modificar o log para um componente

  1. No console Configuration Manager, acesse o workspace Monitoramento, expanda Status do Sistema e selecione o nó Status do Site ou Status do Componente.

  2. Na faixa de opções, selecione Iniciar e selecione Configuration Manager Service Manager.

  3. Quando Configuration Manager Service Manager for aberto, conecte-se ao site que você deseja gerenciar. Se o site que você deseja gerenciar não for mostrado, selecione Site, selecione Conectar e, em seguida, insira o nome do servidor do site para o site correto.

  4. Expanda o site e vá para Componentes ou Servidores, dependendo de onde os componentes que você deseja gerenciar estão localizados.

  5. No painel direito, selecione um ou mais componentes.

  6. No menu Componente , selecione Log.

  7. Na caixa de diálogo Configuration Manager Registro em Log de Componentes, conclua as opções de configuração disponíveis para sua seleção.

  8. Selecione OK para salvar a configuração.

Configurar opções de log usando o Registro do Windows

Use o Registro do Windows nos servidores ou clientes para alterar as seguintes opções de log:

  • Nível verboso
  • Histórico máximo
  • Tamanho máximo

Ao solucionar um problema, você pode habilitar o log verboso para Configuration Manager gravar detalhes adicionais nos arquivos de log.

Aviso

A configuração incorreta dessas configurações pode fazer com que Configuration Manager registre grandes quantidades de informações ou nenhuma. Embora esses dados possam ser benéficos para a solução de problemas, tenha cuidado ao alterar esses valores em sites de produção. Sempre teste essas alterações em um ambiente de laboratório primeiro. Pode ocorrer registro em log excessivo, o que pode dificultar a localização de informações relevantes nos arquivos de log.

Depois de fazer alterações nessas configurações de registro, reinicie o componente:

  • Se você alterar as configurações do cliente, reinicie o Serviço de Host do Agente SMS (CcmExec).
  • Se você alterar as configurações do servidor, reinicie o serviço executivo de SMS .

As configurações do registro variam dependendo do componente:

Opções de log de ponto de gerenciamento e cliente

Para configurar opções de log para todos os componentes em um sistema de site de ponto de gerenciamento ou cliente, configure esses valores REG_DWORD na seguinte chave do Registro do Windows:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global

Nome Valores Descrição
Loglevel 0:Verbose
1:Padrão
2: avisos e erros
3: somente erros		 O nível de detalhes a ser gravado em arquivos de log.
LogMaxHistory Qualquer inteiro maior ou igual a zero, por exemplo:
0: sem histórico
1:Padrão		 Quando um arquivo de log atinge o tamanho máximo, o cliente o renomeia como um backup e cria um novo arquivo de log. Especifique quantas versões anteriores manter.
LogMaxSize Qualquer inteiro maior ou igual a 10.000, por exemplo:
250000		 O tamanho máximo do arquivo de log em bytes. Quando um log aumenta para o tamanho especificado, o cliente o renomeia como um arquivo de histórico e cria um novo arquivo. O valor padrão é 250.000 bytes.

Observação

Não altere outros valores que possam existir nesta chave do registro.

Para depuração avançada, você também pode adicionar esse valor REG_SZ na seguinte chave do Registro do Windows:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging

Nome Valores Descrição
Habilitado True: habilitar logs de depuração
False: desabilitar logs de depuração		 Habilita o registro em log de depuração para fins de solução de problemas.

Essa configuração faz com que o cliente registre informações de baixo nível para solução de problemas. Evite usar essa configuração em sites de produção. Pode ocorrer registro em log excessivo, o que pode dificultar a localização de informações relevantes nos arquivos de log. Desative essa configuração depois de resolver o problema.

Opções de log do servidor de site

Você pode configurar configurações globalmente ou para um componente específico no servidor do site Configuration Manager.

Configure esses valores na seguinte chave do Registro do Windows:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing

Nome Valores Tipo Descrição
SqlEnabled 1: habilitar SQL Server rastreamento
0: desabilitar SQL Server rastreamento		 REG_DWORD Adicione SQL Server log de rastreamento a todos os logs do servidor do site.
ArchiveEnabled 1: habilitar arquivos de log
0: desabilitar arquivos de log		 REG_DWORD O servidor do site de arquivo registra logs em um local separado para preservação histórica.
ArchivePath Um caminho de pasta válido, por exemplo C:\Logs\Archive REG_SZ O caminho para arquivar logs do servidor do site.

Habilite apenas SQL Server rastreamento para fins de solução de problemas. Evite usá-lo em sites de produção. Pode ocorrer registro em log excessivo, o que pode dificultar a localização de informações relevantes nos arquivos de log. Desative essa configuração depois de resolver o problema.

Observação

Não altere outros valores que possam existir nesta chave do registro.

Para configurar opções de log para um componente de servidor específico, configure esses valores REG_DWORD na seguinte chave do Registro do Windows:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing\<ComponentName>

Nome Valores Descrição
LoggingLevel 0:Verbose
1:Padrão
2: avisos e erros
3: somente erros		 O nível de detalhes a ser gravado em arquivos de log.
LogMaxHistory Qualquer inteiro maior ou igual a zero, por exemplo:
0: sem histórico
1:Padrão		 Quando um arquivo de log atinge o tamanho máximo, o servidor o renomeia como um backup e cria um novo arquivo de log. Especifique quantas versões anteriores manter.
Maxfilesize Qualquer inteiro maior ou igual a 10.000, por exemplo:
250000		 O tamanho máximo do arquivo de log em bytes. Quando um log aumenta para o tamanho especificado, o cliente o renomeia como um arquivo de histórico e cria um novo arquivo. O valor padrão é 250.000 bytes.
Depurar Log 1: habilitar logs de depuração
0: desabilitar logs de depuração		 Habilita o registro em log de depuração para fins de solução de problemas.

A configuração Depurar Log faz com que o servidor registre informações de baixo nível para solução de problemas. Evite usar essa configuração em sites de produção. Pode ocorrer registro em log excessivo, o que pode dificultar a localização de informações relevantes nos arquivos de log. Desative essa configuração depois de resolver o problema.

Observação

Não altere outros valores que possam existir nesta chave do registro.

Opções de log de função do sistema de site

Você pode configurar configurações globalmente ou para um componente específico em um sistema de site que hospeda uma função de servidor Configuration Manager.

Para configurar opções de log para um componente de servidor específico, configure esses valores REG_DWORD na seguinte chave do Registro do Windows:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\<ComponentName>\Logging

Por exemplo, para a função de ponto de distribuição:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging

Nome Valores Descrição
Loglevel 0:Verbose
1:Padrão
2: avisos e erros
3: somente erros		 O nível de detalhes a ser gravado em arquivos de log.
LogMaxHistory Qualquer inteiro maior ou igual a zero, por exemplo:
0: sem histórico
1:Padrão		 Quando um arquivo de log atinge o tamanho máximo, o servidor o renomeia como um backup e cria um novo arquivo de log. Especifique quantas versões anteriores manter.
LogMaxSize Qualquer inteiro maior ou igual a 10.000, por exemplo:
250000		 O tamanho máximo do arquivo de log em bytes. Quando um log cresce para o tamanho especificado, o servidor o renomeia como um arquivo de histórico e cria um novo arquivo. O valor padrão é 250.000 bytes.

Observação

Não altere outros valores que possam existir nesta chave do registro.

Configuration Manager opções de log do console

Para alterar o nível verboso do AdminUI.log para o console Configuration Manager, use o seguinte procedimento:

  1. Abra o arquivo de configuração do console, Microsoft.ConfigurationManagement.exe.config, em um editor XML como o Bloco de Notas. O arquivo de configuração padrão está no seguinte local: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. No elemento deorigemsystem.diagnostics>sources>, altere o atributo switchValue de Error para Verbose. Por exemplo:

    Original: <source name="SmsAdminUISnapIn" switchValue="Error"> Novo: <source name="SmsAdminUISnapIn" switchValue="Verbose" >

  3. Salve o arquivo e reinicie o console.

Configurar opções de log no console Configuration Manager

Habilitar ou desabilitar o log verboso em um cliente ou coleção do console:

  1. No console Configuration Manager, acesse o workspace Ativos e Conformidade, selecione o nó Dispositivos e escolha um dispositivo de destino.

  2. Na faixa de opções, na guia Página Inicial , no grupo Dispositivo , selecione Diagnóstico do Cliente. Escolha uma das ações disponíveis.

Para obter mais informações, consulte Diagnóstico do cliente.

Inventário de hardware para configurações de log do cliente

A partir da versão 2107, você pode habilitar o inventário de hardware para coletar as configurações do arquivo de log do cliente. Habilite a classe de inventário de hardware, o Diagnóstico do Cliente (CCM_ClientDiagnostics)e selecione os seguintes atributos:

  • Depurar log habilitado
  • Log habilitado
  • Nível do Log
  • Contagem de arquivos de histórico
  • Tamanho máximo do arquivo de log

Observação

Essa classe de inventário não está habilitada por padrão.

Para obter mais informações, consulte Habilitar ou desabilitar classes de inventário de hardware existentes.

Localizando arquivos de log

Configuration Manager e componentes dependentes armazenam arquivos de log em vários locais. Esses locais dependem do processo que cria o arquivo de log e a configuração do seu ambiente.

Os locais a seguir são os padrões. Se você personalizou os diretórios de instalação em seu ambiente, os caminhos reais poderão variar.

  • Cliente: C:\Windows\CCM\logs
  • Servidor: C:\Program Files\Microsoft Configuration Manager\Logs
  • Ponto de gerenciamento: C:\SMS_CCM\Logs
  • Configuration Manager console:C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\AdminUILog
  • IIS: C:\inetpub\logs\logfiles\w3svc1

Locais de log de sequência de tarefas

O local do arquivo de log de sequência de tarefas smsts.log varia dependendo da fase da sequência de tarefas:

  • No Windows PE antes da etapa Formato e Disco de Partição : X:\Windows\temp\smstslog\smsts.log (X é a unidade de RAM do Windows PE)
  • No Windows PE após a etapa Formato e Disco de Partição : X:\smstslog\smsts.log, em seguida, copiado para quando a C:\_SMSTaskSequence\Logs\smstslog\smsts.log unidade está pronta
  • No novo sistema operacional Windows antes da instalação do cliente: C:\_SMSTaskSequence\Logs\smstslog\smsts.log
  • No Windows após a instalação do cliente: C:\Windows\CCM\Logs\smstslog\smsts.log
  • No Windows após a conclusão da sequência de tarefas: C:\Windows\CCM\Logs\smsts.log

Dica

A variável de sequência de tarefas somente leitura _SMSTSLogPath sempre contém o caminho do arquivo de log atual.

Próximas etapas