- 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
-
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.
-
Na fita, selecione Iniciar e depois selecione Configuration Manager Service Manager.
-
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.
-
Expandir o site e vá para Componentes ou Servidores, dependendo de onde os componentes que você deseja gerenciar estão localizados.
> -
No menu Componente, selecione Logging.
-
>
- >
>Na caixa de diálogo Configuration Manager Component Logging, complete as opções de configuração disponíveis para sua seleção.
>
- >
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 : Verbose1 : Por defeito2 : Avisos e erros3 : 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ória1 : 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 tracing0 : desactivar SQL Server tracing |
REG_DWORD | Adicionar SQL Server trace log a todos os registos do servidor do site. |
ArquivoAtivado | 1 : habilitar arquivos de log0 : 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 : Verbose1 : Por defeito2 : Avisos e erros3 : 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ória1 : 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 logs0 : 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 : Verbose1 : Por defeito2 : Avisos e erros3 : 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ória1 : 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:
-
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. -
>De acordo com o system.diagnostics > sources > source element, altere o atributo switchValue de
Error
paraVerbose
. Por exemplo:Original:
<source name="SmsAdminUISnapIn" switchValue="Error">
Novo:<source name="SmsAdminUISnapIn" switchValue="Verbose" >
-
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:
- >
No console do Configuration Manager, vá para o espaço de trabalho Assets and Compliance, seleccione o nó Devices, e escolha um dispositivo alvo.
-
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 paraC:\_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.