CMTrace

Aplica-se a: Configuration Manager (branch atual)

O CMTrace é uma das ferramentas do Configuration Manager. Ela permite que você exiba e monitore arquivos de log, incluindo os seguintes tipos:

  • Arquivos de log no formato do Configuration Manager ou do Gerenciador de Componentes do Cliente (CCM)

  • Arquivos de texto ASCII ou Unicode simples, como logs do Windows Installer

A ferramenta ajuda a analisar arquivos de log realçando, filtrando e pesquisando erros.

Observação

O CMTrace não é registrado automaticamente no Windows para abrir a extensão de arquivo .log. Para obter mais informações, consulte Associações de arquivos.

O Configuration Manager versão 2107 inclui várias melhorias de desempenho no visualizador de logs CMTrace.

Localizações

O Configuration Manager instala automaticamente o CMTrace nos seguintes locais:

  • O diretório de ferramentas do servidor do site. Por exemplo: cd.latest\SMSSETUP\Tools\CMTrace.exe
  • O diretório de instalação do ponto de gerenciamento. Por exemplo: C:\SMS_CCM\CMTrace.exe
  • O diretório de instalação do cliente. Por exemplo: C:\Windows\CCM\CMTrace.exe
  • Imagens de inicialização da implantação do sistema operacional. Por exemplo: X:\sms\bin\x64\CMTrace.exe

Se você tiver uma cópia do CMTrace em outro local, considere removê-la e usar uma cópia em um dos caminhos padrão. Se estiver em um local personalizado que atenda aos seus requisitos de negócios, verifique se você tem um processo para mantê-lo atualizado. Se o seu local personalizado for benéfico para outros clientes, envie comentários sobre o produto.

Para obter mais informações, consulte Links diretos para itens do hub da comunidade.

Uso

Executar CMTrace.exe. Na primeira vez que executar a ferramenta, você verá um prompt de associação de arquivo. Para obter mais informações, consulte Associações de arquivos.

Você executa a maioria das ações no CMTrace a partir dos seguintes menus:

Menu Arquivo

As seguintes ações estão disponíveis no menu Arquivo :

O menu Arquivo também lista os últimos oito arquivos recentes. Reabra rapidamente um desses logs selecionando-o no menu Arquivo.

Abrir

Exibe a caixa de diálogo Abrir para procurar um arquivo de log.

Filtre o modo de exibição de arquivos dos seguintes tipos:

  • Arquivos de log (*.log)
  • Arquivos de log antigos (*.lo_)
  • Todos os arquivos (*.*)

As duas opções a seguir não estão selecionadas por padrão:

  • Ignorar linhas existentes: quando selecionado, o CMTrace ignora o conteúdo existente do arquivo de log selecionado e exibe novas linhas somente à medida que são adicionadas. Use esta opção para monitorar apenas novas ações quando você não precisar do histórico completo do arquivo de log.

  • Mesclar arquivos selecionados: se você habilitar essa opção e selecionar mais de um arquivo de log, o CMTrace mesclará os logs selecionados na exibição. Ele os exibe como se fossem um único arquivo de log. O log mesclado é atualizado da mesma forma e dá suporte a todos os outros recursos do CMTrace como se fosse um único arquivo de log.

Abrir no servidor

Procure a pasta de logs do Configuration Manager em um computador com sistema de site com a caixa de diálogo Procurar padrão. Você também pode procurar um computador remoto na rede.

Quando você seleciona um computador remoto para procurar, o CMTrace verifica o compartilhamento do Configuration Manager. Se não conseguir encontrar um compartilhamento com os arquivos de log do Configuration Manager, ele exibirá uma mensagem de erro.

Para se conectar diretamente a um computador conhecido sem navegar, use a ação Abrir . Em seguida, insira um nome de servidor e compartilhe usando o formato UNC.

Print

Exibir a caixa de diálogo Imprimir do Windows padrão. Essa ação envia o arquivo de log atual para uma impressora. Ele formata a saída de acordo com as configurações na guia Impressão das Preferências do CMTrace.

Preferências

Defina as configurações do CMTrace. As seguintes opções estão disponíveis:

  • Guia Geral

    • Intervalo de atualização: controla a frequência com que o CMTrace verifica se há alterações nos arquivos de log e carrega novas linhas. Por padrão, esse valor é de 500 milissegundos.

    • Realçar: Define a cor que o CMTrace usa ao destacar as linhas de log escolhidas. Por padrão, essa cor é amarelo básico (Vermelho: 255, Verde: 255, Azul: 0).

    • Colunas: configura as colunas visíveis na exibição de log e a ordem em que aparecem. Por padrão, ele exibe Texto de Log, Componente, Data/Hora e Thread.

  • Guia Impressão

    • Colunas: Configure quais colunas ele usa ao imprimir arquivos de log e a ordem em que aparecem. Por padrão, ele imprime as mesmas colunas que exibe.

    • Orientação: Define a orientação de impressão padrão ao imprimir arquivos de log. Substitua essa configuração na caixa de diálogo Imprimir. Por padrão, ele usa a orientação Retrato.

  • Guia Avançado

    • Intervalo de atualização: Força o CMTrace a atualizar a exibição do log em um intervalo especificado ao carregar um grande número de linhas. Por padrão, essa opção está desabilitada com um valor zero.

      Observação

      Em geral, não modifique o Intervalo de Atualização. Isso pode aumentar significativamente o tempo necessário para abrir arquivos de log grandes.

Menu Ferramentas

As seguintes ações estão disponíveis no menu Ferramentas :

Localizar

Pesquise o arquivo de log aberto em busca de uma cadeia de caracteres de texto especificada.

Localizar próximo

Localiza a próxima cadeia de caracteres correspondente, conforme especificado anteriormente na caixa de diálogo Localizar.

Copiar para a Área de Transferência

Copia as linhas selecionadas como texto sem formatação para a área de transferência do Windows. Se você estiver examinando os arquivos de log do Configuration Manager e do CCM, ele copiará as colunas na mesma ordem que a exibição. Ela separa cada coluna por um caractere de tabulação. Use essa ação ao copiar logs para mensagens de email ou outros documentos.

Destacar

Insira uma cadeia de caracteres que o CMTrace usa para pesquisar o texto de cada entrada de log. Em seguida, ele destaca qualquer texto de log que corresponda à cadeia de caracteres inserida.

  • O destaque usa a cor especificada em Preferências.

  • Para desativar o realce, limpe a cadeia de caracteres desse campo.

  • Se você inserir um número decimal ou hexadecimal, a CMTrace tentará corresponder o valor à coluna Thread. Use esse comportamento para realçar o processamento de um único thread, sem filtrar outros threads que possam interagir com ele.

  • Para comparar cadeias de caracteres por maiúsculas e minúsculas, ative a opção que diferencia maiúsculas de minúsculas.

Filter

Mostrar ou ocultar linhas de log com base nos critérios especificados. Aplique filtros a qualquer uma das quatro colunas, independentemente de estarem visíveis ou não. Essas configurações se aplicam a cada arquivo de log aberto.

Exemplos:

  • Filtrar smsts.log no texto de entrada que contém "a ação" ou "o grupo".
  • Filtrar InventoryAgent.log onde o texto da entrada contém "destino".

Pesquisa de Erro

Digite ou cole um código de erro no formato decimal ou hexadecimal para exibir uma descrição. As possíveis fontes de erro incluem: Windows, WMI ou Winhttp.

Pausar

Suspenda ou reinicie o monitoramento de log. Os seguintes casos de uso são alguns dos possíveis motivos para usar essa ação:

  • Quando o CMTrace está exibindo informações do arquivo de log muito rapidamente

  • Quando você pausa o monitoramento de log, as informações que o CMTrace exibe não são perdidas se o arquivo atual for transferido para um novo log

  • Quando você deseja impedir que o CMTrace exiba novos dados enquanto examina o arquivo de log

Mostrar/ocultar detalhes

Mostrar ou ocultar todas as colunas, exceto o texto do log. Ele também expande a coluna de texto do log para a largura da janela. Use essa ação quando estiver exibindo logs em um computador com baixa resolução de vídeo. Ele exibe mais do texto do log.

Observação

Ao exibir arquivos de texto sem formatação, o CMTrace oculta automaticamente os detalhes porque eles estão sempre vazios.

Mostrar/ocultar painel de informações

Mostrar ou ocultar o painel de informações. Use essa ação quando estiver exibindo logs em um computador com baixa resolução de vídeo. Ele exibe mais detalhes de log.

Painel de log

O painel de log está na parte superior da janela do CMTrace. Ele exibe linhas de arquivos de log.

Quando você seleciona uma linha, ela é temporariamente realçada usando o esquema de cores de seleção do Windows.

As linhas realçadas correspondem aos critérios definidos com a opção Realçar no menu Ferramentas . O realce usa a cor especificada em Preferências.

O CMTrace exibe linhas com erros usando um fundo vermelho e uma cor de texto amarela. Em logs no formato CCM, as entradas de log têm um valor de tipo explícito que indica a entrada como um erro. Para outros formatos de log, o CMTrace faz uma pesquisa sem diferenciação entre maiúsculas e minúsculas em cada entrada para qualquer cadeia de caracteres de texto que corresponda a "erro".

Ele exibe linhas com avisos usando um fundo amarelo. Em logs no formato CCM, as entradas de log têm um valor de tipo explícito que indica a entrada como um aviso. Para outros formatos de log, o CMTrace faz uma pesquisa sem diferenciação entre maiúsculas e minúsculas em cada entrada para qualquer cadeia de caracteres de texto que corresponda a "warn".

Painel Informações

O painel Informações está na parte inferior da janela CMTrace. Ela inclui os seguintes recursos:

  • Detalhes sobre a entrada de log selecionada no momento

  • Uma caixa de texto que exibe o texto de log

  • Ela exibe os retornos de carro para que o texto formatado seja mais fácil de ler

  • Mais fácil de ler entradas longas que não são totalmente visíveis no painel Log

Mostrar ou ocultar o painel Informações com a opção Mostrar/Ocultar Painel de Informações no menu Ferramentas . Se o painel Informações ocupar mais da metade da janela de log, o CMTrace o ocultará automaticamente.

Barra de progresso

Quando você abre um arquivo de log pela primeira vez, o CMTrace substitui o painel Informações por uma barra de progresso. Esse progresso indica quanto do conteúdo do arquivo existente foi carregado. O progresso atinge 100%, o CMTrace remove a barra de progresso e a substitui pelo painel Informações. Quando você carrega arquivos grandes, esse comportamento fornece uma indicação de quanto tempo o carregamento pode levar.

Barra de status

Para arquivos de log no formato Configuration Manager e CCM, a barra de status exibe o tempo decorrido para as entradas de log selecionadas. Se você selecionar uma única entrada, a ferramenta exibirá o tempo desde a primeira entrada de log até a entrada selecionada. Se você selecionar várias entradas, ele calculará o tempo da entrada selecionada mais alta para a entrada selecionada mais abaixo. O CMTrace formata essas informações da seguinte maneira:

Elapsed time is <hours>h <minutes>m <seconds>s <milliseconds>ms (<seconds+milliseconds> seconds)

Integração com o shell do Windows

O CMTrace dá suporte a associações de arquivos e arrastar e soltar.

Associações de arquivos

O CMTrace pode se associar a extensões de nome de arquivo .log e .lo_. Quando o programa é iniciado, ele verifica o Registro para determinar se ele já está associado a essas extensões de nome de arquivo. Se o CMTrace ainda não estiver associado a nenhuma extensão de nome de arquivo, você será solicitado a associar as extensões de nome de arquivo ao CMTrace. Se você selecionar Não me pergunte isso novamente, o CMTrace ignorará essa marca sempre que for executado neste computador.

Arrastar e soltar

O CMTrace dá suporte à funcionalidade básica de arrastar e soltar. Arraste um arquivo de log do Windows Explorer para o CMTrace para abri-lo.

Outras dicas

Última chave de registro de diretório

Por padrão, o CMTrace salva o último local de log aberto. Esse comportamento é útil no servidor do site, pois o padrão é sempre o caminho de logs.

Na primeira vez que você o inicia em um cliente, o padrão é o diretório de trabalho atual. Esse local pode ser o caminho em que você salvou o CMTrace ou um caminho como %userprofile%\Desktop.

O valor Last Directory na chave HKEY_CURRENT_USER\Software\Microsoft\Trace32 do Registro controla esse local padrão. Se você definir esse valor como %windir%\CCM\Logs em seus clientes, o CMTrace abrirá arquivos no local do log do cliente na primeira vez que você executá-lo.

Próximas etapas

O OneTrace é o visualizador de logs com o Centro de Suporte. Funciona de forma semelhante ao CMTrace, com melhorias. Para obter mais informações, consulte Centro de Suporte OneTrace.

  • Last updated on