Sobre ficheiros de registo no Configuration Manager

  • 11/29/2019
  • 10 minutos para ler
    • a
    • d

Candidata-se a: Configuration Manager (ramo atual)

No Configuration Manager, os componentes do cliente e do servidor do site registram informações do processo em arquivos de log individuais. Você pode usar as informações nesses arquivos de log para ajudar a solucionar problemas que possam ocorrer. Por padrão, o Configuration Manager permite o registro para os componentes do cliente e do servidor.

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

Como funciona

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

Ferramentas do visualizador de log

Todos os arquivos de log do Gerenciador de Configuração são texto simples, assim você pode vê-los com qualquer leitor de texto como o Bloco de Notas. Os logs usam formatação única que é melhor visualizada com uma das seguintes ferramentas especializadas:

  • CMTrace
  • OneTrace
  • Support Center log viewer

CMTrace

Para visualizar os logs, use a ferramenta de visualização de logs do Configuration Manager CMTrace. Ela está localizada na pasta \SMSSetup\Tools da mídia de origem do Gerenciador de Configurações. A ferramenta CMTrace é adicionada a todas as imagens de inicialização que são adicionadas à Biblioteca de Software. A ferramenta de visualização de log CMTrace é instalada automaticamente junto com o cliente Configuration Manager. Para mais informações, veja CMTrace.

OneTrace

Iniciar na versão 1906, o OneTrace é um novo visualizador de logs com o Support Center. Ele funciona de forma similar ao CMTrace, com melhorias. Para mais informações, veja Support Center OneTrace.

Support Center log viewer

Support Center inclui um moderno visualizador de logs. Esta ferramenta substitui o CMTrace e fornece uma interface personalizável com suporte para abas e janelas acopláveis. Ele tem uma camada de apresentação rápida, e pode carregar grandes arquivos de log em segundos. Para mais informações, veja a referência do Support Center Log Viewer.

Nota

Support Center e OneTrace usam o Windows Presentation Foundation (WPF). Este componente não está disponível no Windows PE. Continue a usar o CMTrace em imagens de inicialização com implementações de sequência de tarefas.

Configurar opções de registro

Você pode alterar a configuração dos arquivos de registro, tais como o nível de verbosidade, tamanho e histórico. Existem várias formas de alterar estas definições:

  • Durante a instalação do cliente
  • Using Configuration Manager Service Manager
  • Using the Windows Registry
  • Na consola do Configuration Manager

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

Pode definir a configuração dos ficheiros de registo do cliente durante a instalação. Use as seguintes propriedades:

  • CCMENABLELOGGING
  • CCMDEBUGLOGGING
  • CCMLOGLEVEL
  • CCMLOGMAXHISTORY
  • CCMLOGMAXSIZE

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

Configure as opções de registo usando o Configuration Manager Service Manager

Pode alterar onde o Configuration Manager guarda os ficheiros de registo, e o seu tamanho.

Para modificar o tamanho dos ficheiros de registo, alterar o nome e localização do ficheiro de registo, ou forçar vários componentes a escrever num único ficheiro de registo, faça os seguintes passos:

Modificar o registo para um componente

  1. Na consola do Configuration Manager, vá para a área de trabalho Monitorização, expanda o Estado do Sistema e depois seleccione o nó Estado do Local ou Estado do Componente.

  2. Na fita, selecione Iniciar e depois selecione Configuration Manager Service Manager.

  3. Quando o Configuration Manager Service Manager abrir, conecte-se ao site que você deseja gerenciar. Se o site que você deseja gerenciar não for mostrado, selecione Site, selecione Connect, e então digite o nome do servidor do site para o site correto.

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

  5. >

  6. No menu Componente, selecione Logging.

  7. >

  8. >

  9. >

    >Na caixa de diálogo Configuration Manager Component Logging, complete as opções de configuração disponíveis para sua seleção.

    >

  10. >

  11. >

    Selecione OK para salvar a configuração.

Configure as opções de registo usando o Registo do Windows

Utilize o Registo do Windows nos servidores ou clientes para alterar as seguintes opções de registo:

  • Verbose level
  • Maximum history
  • Maximum size

Quando solucionar um problema, você pode habilitar o registro verbose para o Configuration Manager para escrever detalhes adicionais nos arquivos de registro.

Aviso

Misconfiguração destas configurações pode fazer com que o Configuration Manager registe grandes quantidades de informação, ou nenhuma. Embora estes dados possam ser benéficos para a resolução de problemas, seja cauteloso ao alterar estes valores nos locais de produção. Teste sempre estas alterações primeiro em um ambiente de laboratório. Pode ocorrer um registro excessivo, o que pode dificultar encontrar informações relevantes nos arquivos de registro.

Após fazer alterações nessas configurações de registro, reinicie o componente:

  • Se você alterar as configurações do cliente, reinicie o serviço SMS Agent Host (CcmExec).
  • Se você alterar as configurações do servidor, reinicie o serviço SMS Executive.

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

  • Cliente e ponto de gestão
  • Site server
  • Site system role
  • Console do gerenciador de configuração

Opções de registro de cliente e ponto de gestão

Para configurar as opções de registro de todos os componentes em um sistema cliente ou ponto de gestão, configure estes valores REG_DWORD sob a seguinte chave de registro do Windows:

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

Nome Valores Descrição
LogLevel 0: Verbose
1: Por defeito
2: Avisos e erros
3: Somente erros
: O nível de detalhe para escrever em arquivos de log.
>LogMaxHistory Um número inteiro maior ou igual a zero, por exemplo:
0: Sem história
1: Padrão
Quando um arquivo de log atinge o tamanho máximo, o cliente renomeia-o como backup e cria um novo arquivo de log. Especifique quantas versões anteriores manter.
LogMaxSize Um número 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 cliente renomeia-o como um arquivo de histórico, e cria um novo arquivo. O valor padrão é 250.000 bytes.

Nota

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

Para depuração avançada, também pode adicionar este valor REG_SZ sob a seguinte chave de registo do Windows:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging

Nome Valores Descrição
Ativado True: habilitar logs de depuração
>False: desabilitar logs de depuração
> habilitar logs de depuração para fins de resolução de problemas.

Esta configuração faz com que o cliente registre informações de baixo nível para a resolução de problemas. Evite usar esta configuração em locais de produção. Pode ocorrer um registro excessivo, o que pode dificultar encontrar informações relevantes nos arquivos de registro. Certifique-se de desligar esta configuração após resolver o problema.

Opções de registro no servidor do site

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

Configure estes valores sob a seguinte chave de registro do Windows:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing

Nome Valores Tipo Descrição
SqlEnabled 1: activar SQL Server tracing
0: desactivar SQL Server tracing
REG_DWORD Adicionar SQL Server trace log a todos os registos do servidor do site.
ArquivoAtivado 1: habilitar arquivos de log
0: desabilitar arquivos de log
REG_DWORD Arquivar logs do servidor do site em um local separado para preservação do histórico.
ArquivePath Um caminho de pasta válido, por exemplo C:\Logs\Archive REG_SZ >O caminho para arquivar os logs do servidor do site.

Apenas habilitar o rastreamento do SQL Server para fins de resolução de problemas. Evite usá-lo em sites de produção. Logs excessivos podem ocorrer, o que pode tornar difícil encontrar informações relevantes nos arquivos de log. Certifique-se de desligar esta configuração depois de resolver o problema.

Nota

Não altere outros valores que possam existir nesta chave de registo.

Para configurar opções de registo para um componente específico do servidor, configure estes valores REG_DWORD sob a seguinte chave de registo do Windows:

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

Nome Valores Descrição
LoggingLevel 0: Verbose
1: Por defeito
2: Avisos e erros
3: Somente erros
: Nível de detalhe para escrever em arquivos de log.
>LogMaxHistory Um número inteiro maior ou igual a zero, por exemplo:
0: Sem história
1: Padrão
Quando um arquivo de log atinge o tamanho máximo, o servidor renomeia-o como um backup e cria um novo arquivo de log. Especifique quantas versões anteriores manter.
MaxFileSize Um número 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 cliente renomeia-o como um arquivo de histórico, e cria um novo arquivo. O valor padrão é 250.000 bytes.
DebugLogging 1: enable debug logs
0: disable debug logs
Enables debug logging for troubleshooting purposes.

A configuração DebugLogging faz com que o servidor registre informações de baixo nível para resolução de problemas. Evite usar essa configuração em locais de produção. O registro excessivo pode ocorrer, o que pode tornar difícil encontrar informações relevantes nos arquivos de registro. Certifique-se de desligar esta configuração após resolver o problema.

Nota

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

Opções de registro de funções do sistema do site

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

Para configurar opções de registo para um componente específico do servidor, configure estes valores REG_DWORD sob a seguinte chave de registo do Windows:

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

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

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging

Nome Valores Descrição
LogLevel 0: Verbose
1: Por defeito
2: Avisos e erros
3: Somente erros
: O nível de detalhe para escrever em arquivos de log.
>LogMaxHistory Um número inteiro maior ou igual a zero, por exemplo:
0: Sem história
1: Padrão
Quando um arquivo de log atinge o tamanho máximo, o servidor renomeia-o como um backup e cria um novo arquivo de log. Especifique quantas versões anteriores manter.
LogMaxSize Um número 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 renomeia-o como um arquivo de histórico, e cria um novo arquivo. O valor padrão é 250.000 bytes.

Nota

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

Opções de registro do console do Configuration Manager

Para alterar o nível verboso do AdminUI.log para o console do 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 Notepad. O arquivo de configuração padrão está no seguinte local: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

    Importante

    Iniciar na versão 1910, este caminho mudou para usar a pasta Microsoft Endpoint Manager. Certifique-se de não usar uma versão antiga do arquivo que possa existir em outra pasta.

  2. >De acordo com o system.diagnostics > sources > source element, altere o atributo switchValue de Error para Verbose. Por exemplo:

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

  3. Guardar o ficheiro, e reiniciar o console.

Configurar opções de registo no console do Configuration Manager

Iniciar na versão 1910, activar ou desactivar o registo verbal num cliente ou colecção a partir do console:

  1. >

    No console do Configuration Manager, vá para o espaço de trabalho Assets and Compliance, seleccione o nó Devices, e escolha um dispositivo alvo.

  2. Na fita, na guia Home, no grupo Dispositivo, selecione Client Diagnostics. Escolha uma das ações disponíveis.

Para mais informações, veja Client diagnostic.

Locating log files

Configuration Manager and dependent components store log files in various locations. Estas localizações dependem do processo que cria o ficheiro de log e da configuração do seu ambiente.

As seguintes localizações são as predefinições. Se você personalizou os diretórios de instalação em seu ambiente, os caminhos reais podem variar.

  • Cliente: C:\Windows\CCM\logs
  • Servidor: C:\Program Files\Microsoft Configuration Manager\Logs
  • Ponto de gestão: C:\SMS_CCM\Logs
  • Configuração do console do Gerenciador: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\AdminUILog
  • IIS: C:\inetpub\logs\logfiles\w3svc1

Localizações do log da sequência de tarefas

A localização do ficheiro smsts.log da sequência de tarefas varia dependendo da fase da sequência de tarefas:

  • No Windows PE antes do passo Formatar e Disco de Partição: X:\Windows\temp\smstslog\smsts.log (X é a unidade RAM do Windows PE)
  • No Windows PE depois do passo Formatar e Disco de partição: X:\smstslog\smsts.log, depois copiado para C:\_SMSTaskSequence\Logs\smstslog\smsts.log quando a unidade estiver pronta
  • No novo SO Windows antes de o cliente ser instalado: 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 sequência de tarefas estar completa: C:\Windows\CCM\Logs\smsts.log

Tip

A variável de sequência de tarefas só de leitura _SMSTSLogPath contém sempre o caminho do ficheiro de registo actual.

Ver também

Deixe uma resposta

O seu endereço de email não será publicado.