Sobre ficheiros de registo no Gestor de Configuração
Aplica-se a: Configuration Manager (ramo atual)
No Gestor de Configuração, os componentes do servidor de clientes e de servidor de site registam informações de processo em ficheiros de registo individuais. Pode utilizar as informações nestes ficheiros de registo para ajudá-lo a resolver problemas que possam ocorrer. Por predefinição, o Gestor de Configuração permite o registo de componentes de clientes e servidores.
Este artigo fornece informações gerais sobre os ficheiros de registo do Gestor de Configuração. Inclui ferramentas para usar, como configurar os registos e onde encontrá-los. Para obter mais informações sobre ficheiros de registo específicos, consulte a referência de ficheiros de registo.
Como funciona
A maioria dos processos no Gestor de Configuração escreve informações operacionais para um ficheiro de registo dedicado a esse processo. Os ficheiros de registo são identificados por .log ou .lo_ extensões de ficheiros. O Gestor de Configuração escreve para um .log ficheiro até que esse registo atinja o seu tamanho máximo. Quando o registo está 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 para o .log ficheiro. Quando o .log ficheiro volta a atingir o seu tamanho máximo, o ficheiro é substituído e o processo .lo_ repete-se. Alguns componentes estabelecem um histórico de registo, anexando uma data e carimbo de hora ao nome do ficheiro de registo e mantendo a .log extensão.
Ferramentas de visualização de registo
Todos os ficheiros de registo do Gestor de Configuração são texto simples, para que possa vê-los com qualquer leitor de texto como Bloco de notas. Os troncos usam formatação única que é melhor vista com uma das seguintes ferramentas especializadas:
CMTrace
Para visualizar os registos, utilize a ferramenta de visualização de registo de registo do Gestor de Configuração CMTrace. Está localizado na \SMSSetup\Tools pasta dos meios de origem do Gestor de Configuração. A ferramenta CMTrace é adicionada a todas as imagens de arranque adicionadas à Biblioteca de Software. A ferramenta de visualização de registos CMTrace é automaticamente instalada juntamente com o cliente Gestor de Configuração. Para mais informações, consulte a CMTrace.
OneTrace
OneTrace é um visualizador de registo com Centro de Suporte. Funciona da mesma forma que a CMTrace, com melhorias. Para mais informações, consulte o Centro de Suporte OneTrace.
Visualização de ficheiros de registo de registo do centro de suporte
O Support Center inclui um visualizador de registo moderno. Esta ferramenta substitui o CMTrace e fornece uma interface personalizável com suporte para separadores e janelas descaídas. Tem uma camada de apresentação rápida, e pode carregar grandes ficheiros de registo em segundos. Para obter mais informações, consulte o Visualizador de Ficheiros do Registo do Centro de Suporte.
Nota
Support Center Log File Viewer e OneTrace use Windows Presentation Foundation (WPF). Este componente não está disponível em Windows PE. Continue a utilizar CMTrace em imagens de arranque com implementações de sequência de tarefas.
Opções de configure de registo
Pode alterar a configuração dos ficheiros de registo, como o nível, tamanho e histórico verboso. Existem várias formas de alterar estas definições:
- Durante a instalação do cliente
- Utilizando o Gestor de Serviços de Gestor de Configuração
- Utilização do Registo Windows
- Na consola Do Gestor de Configuração
Também pode utilizar o inventário de hardware para recolher as definições de registo dos clientes.
Configure as 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 mais informações, consulte as propriedades de instalação do Cliente.
Configure as opções de registo utilizando o Gestor de Serviços de Gestor de Configuração
Pode alterar onde o Gestor de Configuração armazena os ficheiros de registo e o seu tamanho.
Para modificar o tamanho dos ficheiros de registo, alterar o nome e a 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 a sessão de registo de um componente
Na consola 'Gestor de Configuração', vá ao espaço de trabalho de monitorização, expanda o Estado do Sistema e, em seguida, selecione o nó de Estado do Site ou componente.
Na fita, selecione Iniciar e, em seguida, selecione O Gestor de Serviço de Configuração.
Quando o Gestor de Serviços de Configuração abrir, ligue-se ao site que pretende gerir. Se o site que pretende gerir não for mostrado, selecione Site, selecione Ligação e, em seguida, insira o nome do servidor do site para o site correto.
Expanda o site e vá para Componentes ou Servidores, dependendo de onde estão localizados os componentes que pretende gerir.
No painel direito, selecione um ou mais componentes.
No menu Componente, selecione Registar.
Na caixa de diálogo Registo de Componente do Configuration Manager, preencha as opções de configuração disponíveis para a sua seleção.
Selecione OK para guardar a configuração.
Configure as opções de registo através da utilização do Registo Windows
Utilize o Registo Windows nos servidores ou clientes para alterar as seguintes opções de registo:
- Nível verboso
- História máxima
- Tamanho máximo
Ao resolver um problema, pode permitir que o registo verboso para o Gestor de Configuração escreva detalhes adicionais nos ficheiros de registo.
Aviso
A configuração errada destas definições pode fazer com que o Gestor de Configuração 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 em locais de produção. Teste sempre estas mudanças num ambiente de laboratório primeiro. Pode ocorrer uma sessão de registo excessivo, o que pode dificultar a procura de informações relevantes nos ficheiros de registo.
Depois de escamar as alterações nestas definições de registo, reinicie o componente:
- Se alterar as definições do cliente, reinicie o serviço de anfitrião do agente SMS (CcmExec).
- Se alterar as definições do servidor, reinicie o serviço SMS Executive.
As definições de registo variam consoante o componente:
- Ponto de cliente e gestão
- Servidor do site
- Função do sistema de sites
- Consola do Configuration Manager
Opções de registo de pontos de cliente e gestão
Para configurar opções de registo de todos os componentes num sistema de site de cliente ou de ponto de gestão, configuure estes valores REG_DWORD ao abrigo da seguinte chave de registo Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global
| Name | Valores | Descrição |
|---|---|---|
| Nível de Registo | 0: Verbose1: Predefinição2: Advertências e erros3: Apenas erros |
O nível de detalhe para escrever para registar ficheiros. |
| LogMaxHistory | Qualquer inteiro maior ou igual a zero, por exemplo:0: Sem história1: Predefinição |
Quando um ficheiro de registo atinge o tamanho máximo, o cliente rebatiza-o como uma cópia de segurança e cria um novo ficheiro de registo. Especifique quantas versões anteriores manter. |
| LogMaxSize | Qualquer inteiro maior ou igual a 10.000, por exemplo: 250000 |
O tamanho máximo do ficheiro de registo em bytes. Quando um registo cresce para o tamanho especificado, o cliente renomea-o como um ficheiro de histórico e cria um novo ficheiro. O valor predefinido é de 250.000 bytes. |
Nota
Não altere outros valores que possam existir nesta chave de registo.
Para depurar avançado, também pode adicionar este valor REG_SZ sob a seguinte chave de registo Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging
| Name | Valores | Descrição |
|---|---|---|
| Ativado | True: permitir registos de depuradosFalse: desativar registos de depuração |
Permite a depuração de registo para efeitos 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 locais de produção. Pode ocorrer uma sessão de registo excessivo, o que pode dificultar a procura de informações relevantes nos ficheiros de registo. Certifique-se de que desliga esta definição depois de resolver o problema.
Opções de registo de servidores de site
Pode configurar as definições globalmente ou para um componente específico no servidor do site do Gestor de Configuração.
Configure estes valores ao abrigo da seguinte chave de registo Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing
| Name | Valores | Tipo | Description |
|---|---|---|---|
| SqlEnabled | 1: permitir SQL Server rastreio0: desativar o rastreio SQL Server |
REG_DWORD | Adicione SQL Server rastreio de registo em todos os registos do servidor do site. |
| ArchiveEnabled | 1: ativar os arquivos de registos0: desativar os arquivos de registos |
REG_DWORD | Arquivar registos de servidores de site para 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 registos de servidores do site. |
Apenas permita SQL Server rastreio para efeitos de resolução de problemas. Evite usá-lo em locais de produção. Pode ocorrer uma sessão de registo excessivo, o que pode dificultar a procura de informações relevantes nos ficheiros de registo. Certifique-se de que desliga esta definiçã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 de um componente específico do servidor, configuure estes valores REG_DWORD na seguinte chave Windows registo:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing\<ComponentName>
| Name | Valores | Descrição |
|---|---|---|
| LoggingLevel | 0: Verbose1: Predefinição2: Advertências e erros3: Apenas erros |
O nível de detalhe para escrever para registar ficheiros. |
| LogMaxHistory | Qualquer inteiro maior ou igual a zero, por exemplo:0: Sem história1: Predefinição |
Quando um ficheiro de registo atinge o tamanho máximo, o servidor rebatiza-o como uma cópia de segurança e cria um novo ficheiro de registo. Especifique quantas versões anteriores manter. |
| MaxFileSize | Qualquer inteiro maior ou igual a 10.000, por exemplo: 250000 |
O tamanho máximo do ficheiro de registo em bytes. Quando um registo cresce para o tamanho especificado, o cliente renomea-o como um ficheiro de histórico e cria um novo ficheiro. O valor predefinido é de 250.000 bytes. |
| Depuração | 1: permitir registos de depurados0: desativar registos de depuração |
Permite a depuração de registo para efeitos de resolução de problemas. |
A definição 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 locais de produção. Pode ocorrer uma sessão de registo excessivo, o que pode dificultar a procura de informações relevantes nos ficheiros de registo. Certifique-se de que desliga esta definição depois de resolver o problema.
Nota
Não altere outros valores que possam existir nesta chave de registo.
Opções de registo de função do sistema de site
Pode configurar definições globalmente ou para um componente específico num sistema de site que hospeda uma função de servidor do Gestor de Configuração.
Para configurar opções de registo de um componente específico do servidor, configuure estes valores REG_DWORD na seguinte chave Windows registo:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\<ComponentName>\Logging
Por exemplo, para a função ponto de distribuição:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging
| Name | Valores | Descrição |
|---|---|---|
| Nível de Registo | 0: Verbose1: Predefinição2: Advertências e erros3: Apenas erros |
O nível de detalhe para escrever para registar ficheiros. |
| LogMaxHistory | Qualquer inteiro maior ou igual a zero, por exemplo:0: Sem história1: Predefinição |
Quando um ficheiro de registo atinge o tamanho máximo, o servidor rebatiza-o como uma cópia de segurança e cria um novo ficheiro de registo. Especifique quantas versões anteriores manter. |
| LogMaxSize | Qualquer inteiro maior ou igual a 10.000, por exemplo: 250000 |
O tamanho máximo do ficheiro de registo em bytes. Quando um registo cresce para o tamanho especificado, o servidor renomea-o como um ficheiro de histórico e cria um novo ficheiro. O valor predefinido é de 250.000 bytes. |
Nota
Não altere outros valores que possam existir nesta chave de registo.
Opções de registo de consolas do Gestor de Configuração
Para alterar o nível verboso do AdminUI.log para a consola Do Gestor de Configuração, utilize o seguinte procedimento:
Abra o ficheiro de configuração da consola, Microsoft.ConfigurationManagement.exe.config, num editor de XML como Bloco de notas. O ficheiro de configuração predefinido encontra-se no seguinte local:
C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.configSob o elemento de origem de fontes de diagnóstico > > do sistema,altere o atributo SwitchValue de
ErrorVerbose. Por exemplo:Original:
<source name="SmsAdminUISnapIn" switchValue="Error">Novo:<source name="SmsAdminUISnapIn" switchValue="Verbose" >Guarde o ficheiro e reinicie a consola.
Configure as opções de registo na consola Do Gestor de Configuração
Ative ou desative o registo verboso num cliente ou recolha a partir da consola:
Na consola 'Gestor de Configuração', vá ao espaço de trabalho Ativos e Compliance, selecione o nó dispositivos e escolha um dispositivo-alvo.
Na fita, no separador Casa, no grupo Dispositivo, selecione Client Diagnostics. Escolha uma das ações disponíveis.
Para mais informações, consulte os diagnósticos do Cliente.
Inventário de hardware para definições de registo de clientes
A partir da versão 2107, pode permitir o inventário de hardware para recolher as definições de ficheiro de registo de clientes. Ativar a classe de inventário de hardware, Diagnóstico do Cliente (CCM_ClientDiagnostics) e, em seguida, selecionar os seguintes atributos:
- Registo de depurado habilitado
- Início de Sessão Habilidoso
- Nível de registo
- Contagem de ficheiros de história
- Tamanho do ficheiro de registo max
Nota
Esta classe de inventário não é ativada por defeito.
Para obter mais informações, consulte Ativar ou desativar as classes de inventário de hardware existentes.
Localizar ficheiros de registo
O Gestor de Configuração e os componentes dependentes armazenam ficheiros de registo em vários locais. Estas localizações dependem do processo que cria o ficheiro de registo e a configuração do seu ambiente.
Os seguintes locais são os padrão. Se personalizou os diretórios de instalação no 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 - Consola do Gestor de Configuração:
C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\AdminUILog - IIS:
C:\inetpub\logs\logfiles\w3svc1
Locais de registo de sequência de tarefas
A localização dos smsts de ficheiro de registo de sequência de tarefas.log varia consoante a fase da sequência de tarefas:
- Em Windows PE antes do formato e passo do disco de partição:
X:\Windows\temp\smstslog\smsts.log(X é a unidade pe RAM Windows) - Em Windows passo pe após formato e disco de partição: , em
X:\smstslog\smsts.logseguida, copiado paraC:\_SMSTaskSequence\Logs\smstslog\smsts.logquando a unidade está pronta - No novo Windows os OS antes da instalação do cliente:
C:\_SMSTaskSequence\Logs\smstslog\smsts.log - Em Windows após a instalação do cliente:
C:\Windows\CCM\Logs\smstslog\smsts.log - Em 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 tarefa apenas de leitura _SMSTSLogPath contém sempre o caminho do ficheiro de registo atual.