Acerca dos ficheiros de registo no Configuration Manager
Aplica-se a: Configuration Manager (branch atual)
No Configuration Manager, os componentes do cliente e do servidor do site registam informações de processo em ficheiros de registo individuais. Pode utilizar as informações nestes ficheiros de registo para o ajudar a resolver problemas que possam ocorrer. Por predefinição, Configuration Manager ativa o registo para componentes de cliente e servidor.
Este artigo fornece informações gerais sobre os ficheiros de registo Configuration Manager. Inclui ferramentas a utilizar, como configurar os registos e onde os encontrar. Para obter mais informações sobre ficheiros de registo específicos, veja Referência de ficheiros de registo.
Como funciona
A maioria dos processos no Configuration Manager escrever informações operacionais num ficheiro de registo dedicado a esse processo. Os ficheiros de registo são identificados por .log
extensões de ficheiro ou .lo_
. Configuration Manager escreve num .log
ficheiro até que esse registo atinja o tamanho máximo. Quando o registo estiver cheio, o .log
ficheiro é copiado para um ficheiro com o mesmo nome, mas com a .lo_
extensão e o processo ou componente continua a escrever no .log
ficheiro. Quando o ficheiro atinge novamente o .log
tamanho máximo, o .lo_
ficheiro é substituído e o processo repete-se. Alguns componentes estabelecem um histórico de ficheiros de registo ao acrescentar um carimbo de data e hora ao nome do ficheiro de registo e ao manter a .log
extensão.
Ferramentas do visualizador de registos
Todos os Configuration Manager ficheiros de registo são de texto simples, pelo que pode vê-los com qualquer leitor de texto, como o Bloco de Notas. Os registos utilizam formatação exclusiva que é melhor visualizada com uma das seguintes ferramentas especializadas:
CMTrace
Para ver os registos, utilize a ferramenta de visualizador de registos Configuration Manager CMTrace. Está localizado na \SMSSetup\Tools
pasta do suporte de dados de origem Configuration Manager. A ferramenta CMTrace é adicionada a todas as imagens de arranque que são adicionadas à Biblioteca de Software. A ferramenta de visualização de registos CMTrace é instalada automaticamente juntamente com o cliente Configuration Manager.
Para obter mais informações, veja CMTrace.
OneTrace
O OneTrace é um visualizador de registos com o Centro de Suporte. Funciona da mesma forma que o CMTrace, com melhorias. Para obter mais informações, veja OneTrace do Centro de Suporte.
Visualizador de Ficheiros de Registo do Centro de Suporte
O Centro de Suporte inclui um visualizador de registos moderno. Esta ferramenta substitui o CMTrace e fornece uma interface personalizável com suporte para separadores e janelas ancoráveis. Tem uma camada de apresentação rápida e pode carregar ficheiros de registo grandes em segundos. Para obter mais informações, veja Visualizador de Ficheiros de Registo do Centro de Suporte.
Observação
O Visualizador de Ficheiros de Registo do Centro de Suporte e o OneTrace utilizam Windows Presentation Foundation (WPF). Este componente não está disponível no Windows PE. Continue a utilizar o CMTrace em imagens de arranque com implementações de sequência de tarefas.
Configurar opções de registo
Pode alterar a configuração dos ficheiros de registo, como o nível verboso, o tamanho e o histórico. Existem várias formas de alterar estas definições:
- Durante a instalação do cliente
- Utilizar Configuration Manager Service Manager
- Utilizar o Registo do Windows
- Na consola do Configuration Manager
Também pode utilizar o inventário de hardware para recolher as definições de registo dos clientes.
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. Utilize as seguintes propriedades:
- CCMENABLELOGGING
- CCMDEBUGLOGGING
- CCMLOGLEVEL
- CCMLOGMAXHISTORY
- CCMLOGMAXSIZE
Para obter mais informações, veja Propriedades de instalação do cliente.
Configurar opções de registo com Configuration Manager Service Manager
Pode alterar o local onde Configuration Manager armazena os ficheiros de registo e o respetivo tamanho.
Para modificar o tamanho dos ficheiros de registo, alterar o nome e a localização do ficheiro de registo ou para forçar vários componentes a escrever num único ficheiro de registo, efetue os seguintes passos:
Modificar o registo de um componente
Na consola do Configuration Manager, aceda à área de trabalho Monitorização, expanda Estado do Sistema e, em seguida, selecione o nó Estado do Site ou Estado do Componente.
No friso, selecione Iniciar e, em seguida, selecione Configuration Manager Service Manager.
Quando Configuration Manager Service Manager abrir, ligue-se ao site que pretende gerir. Se o site que pretende gerir não for apresentado, selecione Site, selecione Ligar e, em seguida, introduza o nome do servidor do site para o site correto.
Expanda o site e aceda a Componentes ou Servidores, consoante a localização dos componentes que pretende gerir.
No painel direito, selecione um ou mais componentes.
No menu Componente , selecione Registo.
Na caixa de diálogo Configuration Manager Registo de Componentes, conclua as opções de configuração disponíveis para a sua seleção.
Selecione OK para guardar a configuração.
Configurar opções de registo com o Registo do Windows
Utilize o Registo do Windows nos servidores ou clientes para alterar as seguintes opções de registo:
- Nível verboso
- Histórico máximo
- Tamanho máximo
Ao resolver um problema, pode ativar o registo verboso para Configuration Manager para escrever detalhes adicionais nos ficheiros de registo.
Aviso
A configuração incorreta destas definições pode fazer com que Configuration Manager registe grandes quantidades de informações ou nenhuma. Embora estes dados possam ser benéficos para a resolução de problemas, tenha cuidado ao alterar estes valores em sites de produção. Teste sempre estas alterações num ambiente de laboratório primeiro. Pode ocorrer um registo excessivo, o que pode dificultar a procura de informações relevantes nos ficheiros de registo.
Depois de fazer alterações a estas definições de registo, reinicie o componente:
- Se alterar as definições do cliente, reinicie o serviço Anfitrião do Agente de SMS (CcmExec).
- Se alterar as definições do servidor, reinicie o serviço SMS Executive .
As definições do registo variam consoante o componente:
Opções de registo de ponto de gestão e cliente
Para configurar opções de registo para todos os componentes num sistema de sites de ponto de gestão ou cliente, configure estes valores de REG_DWORD na seguinte chave do Registo do Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global
Nome | Valores | Descrição |
---|---|---|
Nível do Registo |
0 : Verboso1 : Predefinição2 : Avisos e erros3 : apenas erros |
O nível de detalhe a escrever em ficheiros de registo. |
LogMaxHistory | Qualquer número inteiro maior ou igual a zero, por exemplo:0 : sem histórico1 : Predefinição |
Quando um ficheiro de registo atinge o tamanho máximo, o cliente muda o nome do mesmo como uma cópia de segurança e cria um novo ficheiro de registo. Especifique quantas versões anteriores deve manter. |
LogMaxSize | Qualquer número inteiro maior ou igual a 10 000, por exemplo: 250000 |
O tamanho máximo do ficheiro de registo em bytes. Quando um registo aumenta para o tamanho especificado, o cliente muda o nome do mesmo como um ficheiro de histórico e cria um novo ficheiro. O valor predefinido é 250 000 bytes. |
Observação
Não altere outros valores que possam existir nesta chave de registo.
Para depuração avançada, também pode adicionar este valor de REG_SZ na seguinte chave do Registo do Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging
Nome | Valores | Descrição |
---|---|---|
Habilitado |
True : ativar registos de depuraçãoFalse : desativar os registos de depuração |
Ativa o registo de depuração para fins de resolução de problemas. |
Esta definição faz com que o cliente registe informações de baixo nível para resolução de problemas. Evite utilizar esta definição em sites de produção. Pode ocorrer um registo excessivo, o que pode dificultar a procura de informações relevantes nos ficheiros de registo. Certifique-se de que desativa esta definição depois de resolve o problema.
Opções de registo do servidor do site
Pode configurar as definições globalmente ou para um componente específico no Configuration Manager servidor do site.
Configure estes valores na seguinte chave do Registo do Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing
Nome | Values | Tipo | Descrição |
---|---|---|---|
SqlEnabled |
1 : ativar o rastreio de SQL Server0 : desativar o rastreio de SQL Server |
REG_DWORD | Adicione SQL Server registo de rastreio a todos os registos do servidor do site. |
ArchiveEnabled |
1 : ativar arquivos de registo0 : desativar arquivos de registo |
REG_DWORD | Arquivo servidor do site regista uma localização separada para preservação histórica. |
ArchivePath | Um caminho de pasta válido, por exemplo C:\Logs\Archive |
REG_SZ | O caminho para arquivar os registos do servidor do site. |
Ative apenas SQL Server rastreio para fins de resolução de problemas. Evite utilizá-lo em sites de produção. Pode ocorrer um registo excessivo, o que pode dificultar a procura de informações relevantes nos ficheiros de registo. Certifique-se de que desativa esta definição depois de resolve o problema.
Observação
Não altere outros valores que possam existir nesta chave de registo.
Para configurar as opções de registo para um componente de servidor específico, configure estes valores de REG_DWORD na seguinte chave do Registo do Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing\<ComponentName>
Nome | Valores | Descrição |
---|---|---|
LoggingLevel |
0 : Verboso1 : Predefinição2 : Avisos e erros3 : apenas erros |
O nível de detalhe a escrever em ficheiros de registo. |
LogMaxHistory | Qualquer número inteiro maior ou igual a zero, por exemplo:0 : sem histórico1 : Predefinição |
Quando um ficheiro de registo atinge o tamanho máximo, o servidor muda-lhe o nome como cópia de segurança e cria um novo ficheiro de registo. Especifique quantas versões anteriores deve manter. |
MaxFileSize | Qualquer número inteiro maior ou igual a 10 000, por exemplo: 250000 |
O tamanho máximo do ficheiro de registo em bytes. Quando um registo aumenta para o tamanho especificado, o cliente muda o nome do mesmo como um ficheiro de histórico e cria um novo ficheiro. O valor predefinido é 250 000 bytes. |
Registo de Depuração |
1 : ativar registos de depuração0 : desativar os registos de depuração |
Ativa o registo de depuração para fins de resolução de problemas. |
A definição Registo de Depuração faz com que o servidor registe informações de baixo nível para resolução de problemas. Evite utilizar esta definição em sites de produção. Pode ocorrer um registo excessivo, o que pode dificultar a procura de informações relevantes nos ficheiros de registo. Certifique-se de que desativa esta definição depois de resolve o problema.
Observação
Não altere outros valores que possam existir nesta chave de registo.
Opções de registo de funções do sistema de sites
Pode configurar definições globalmente ou para um componente específico num sistema de sites que aloja uma função de servidor Configuration Manager.
Para configurar as opções de registo para um componente de servidor específico, configure estes valores de REG_DWORD na seguinte chave do Registo 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 |
---|---|---|
Nível do Registo |
0 : Verboso1 : Predefinição2 : Avisos e erros3 : apenas erros |
O nível de detalhe a escrever em ficheiros de registo. |
LogMaxHistory | Qualquer número inteiro maior ou igual a zero, por exemplo:0 : sem histórico1 : Predefinição |
Quando um ficheiro de registo atinge o tamanho máximo, o servidor muda-lhe o nome como cópia de segurança e cria um novo ficheiro de registo. Especifique quantas versões anteriores deve manter. |
LogMaxSize | Qualquer número inteiro maior ou igual a 10 000, por exemplo: 250000 |
O tamanho máximo do ficheiro de registo em bytes. Quando um registo aumenta para o tamanho especificado, o servidor muda o nome do mesmo como um ficheiro de histórico e cria um novo ficheiro. O valor predefinido é 250 000 bytes. |
Observação
Não altere outros valores que possam existir nesta chave de registo.
Configuration Manager opções de registo da consola
Para alterar o nível verboso do AdminUI.log da consola do Configuration Manager, utilize o seguinte procedimento:
Abra o ficheiro de configuração da consola ,Microsoft.ConfigurationManagement.exe.config, num editor XML como o Bloco de Notas. O ficheiro de configuração predefinido encontra-se na seguinte localização:
C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config
No system.diagnóstico>origens>elemento source, altere o atributo switchValue de
Error
paraVerbose
. Por exemplo:Original:
<source name="SmsAdminUISnapIn" switchValue="Error">
Novo:<source name="SmsAdminUISnapIn" switchValue="Verbose" >
Guarde o ficheiro e reinicie a consola.
Configurar opções de registo na consola do Configuration Manager
Ative ou desative o registo verboso num cliente ou coleção a partir da consola do :
Na consola do Configuration Manager, aceda à área de trabalho Ativos e Compatibilidade, selecione o nó Dispositivos e escolha um dispositivo de destino.
No friso, no separador Base , no grupo Dispositivo , selecione Diagnóstico de Cliente. Escolha uma das ações disponíveis.
Para obter mais informações, veja Diagnóstico de cliente.
Inventário de hardware para definições de registo de cliente
A partir da versão 2107, pode ativar o inventário de hardware para recolher as definições do ficheiro de registo do cliente. Ative a classe de inventário de hardware, Diagnóstico de Cliente (CCM_ClientDiagnostics) e, em seguida, selecione os seguintes atributos:
- Registo de Depuração Ativado
- Registo Ativado
- Nível de Registo
- Contagem de Ficheiros do Histórico
- Tamanho Máximo do Ficheiro de Registo
Observação
Esta classe de inventário não está ativada por predefinição.
Para obter mais informações, veja Ativar ou desativar classes de inventário de hardware existentes.
Localizar ficheiros de registo
Configuration Manager e componentes dependentes armazenam ficheiros de registo em várias localizações. Estas localizações dependem do processo que cria o ficheiro de registo e da configuração do seu ambiente.
As seguintes localizações são as predefinições. Se tiver personalizado os diretórios de instalação no seu ambiente, os caminhos reais poderão variar.
- Cliente:
C:\Windows\CCM\logs
- Servidor:
C:\Program Files\Microsoft Configuration Manager\Logs
- Ponto de gestão:
C:\SMS_CCM\Logs
- Configuration Manager consola:
C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\AdminUILog
- IIS:
C:\inetpub\logs\logfiles\w3svc1
Localizações do registo da sequência de tarefas
A localização do ficheiro de registo da sequência de tarefas smsts.log varia consoante a fase da sequência de tarefas:
- No Windows PE antes do passo 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 o passo Formatar e Particionar Disco :
X:\smstslog\smsts.log
e, em seguida, copiado para quando aC:\_SMSTaskSequence\Logs\smstslog\smsts.log
unidade estiver pronta - No novo SO 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 só de leitura _SMSTSLogPath contém sempre o caminho do ficheiro de registo atual.