CMTrace

• 07/26/2019
• 8 minutos para ler
• • m
  • d

Candidata-se a: Configuration Manager (ramo atual)

CMTrace é uma das ferramentas do Configuration Manager. Ela permite visualizar e monitorar arquivos de log, incluindo os seguintes tipos:

• Arquivos de log no Gerenciador de configuração ou no Gerenciador de componentes do cliente (CCM) formato

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

A ferramenta ajuda a analisar os arquivos de log destacando, filtrando e pesquisando erros.

Iniciando na versão 1806, a ferramenta de visualização de logs CMTrace é instalada automaticamente junto com o cliente Configuration Manager. Ela é adicionada ao diretório de instalação do cliente, que por padrão é %WinDir%\CCM\CMTrace.exe.

Starting na versão 1906, 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.

Usage

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

>

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

• Arquivo
• Ferramentas

MenuArquivo

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

• Abrir
• Abrir no Servidor
• Imprimir
• Preferências

O menu Ficheiro também lista os últimos oito ficheiros recentes. Rapidamente reabra um desses logs selecionando-o no menu File.

Open

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

Filtre a vista para arquivos dos seguintes tipos:

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

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

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

• Fundir arquivos selecionados: Se você ativar esta opção e selecionar mais de um arquivo de log, o CMTrace funde os logs selecionados na visualização. Ele os exibe como se eles fossem um único arquivo de log. O log fundido atualiza o mesmo, e suporta todos os outros recursos do CMTrace como se fosse um único arquivo de log.

Open on Server

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

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

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

Imprimir

Exibir a caixa de diálogo padrão de impressão do Windows. Esta acção envia o ficheiro de registo actual para uma impressora. Ele formata a saída de acordo com as configurações na guia Preferências de Impressão do CMTrace.

Preferências

Configurar configurações para o CMTrace. As seguintes opções estão disponíveis:

• Guia Geral

  • Intervalo de Atualização: Controla com que frequência o CMTrace verifica se há alterações nos ficheiros de registo e carrega novas linhas. Por padrão, este valor é 500 milissegundos.

  • Highlight: Define a cor que o CMTrace usa ao destacar as linhas de log que você escolher. Por padrão, esta cor é amarelo básico (Vermelho: 255, Verde: 255, Azul: 0).

  • Colunas: Configura as colunas que são visíveis na vista de log e a ordem em que aparecem. Por padrão, ele exibe Log Text, Component, Date/Time e Thread.

• Printing tab

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

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

• Advanced tab

  • Intervalo de atualização: Força o CMTrace a actualizar a vista de registo a um intervalo especificado ao carregar um grande número de linhas. Por padrão, esta opção é desabilitada com um valor de zero.

    Nota

    Em geral, não modifique o Intervalo de Atualização (Refresh Interval). Ele pode aumentar significativamente a quantidade de tempo que leva para abrir grandes arquivos de log.

Menu Ferramentas

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

• Find
• Find Next
• Copy to Clipboard
• Highlight
• Filtro
• Error Lookup
• Pausa
• Mostrar/Esconder Detalhes
• Mostrar/Esconder Painel de Informações

Localizar

Procure o ficheiro de registo aberto para uma cadeia de texto especificada.

>

Encontra a próxima cadeia de caracteres correspondente, como especificou anteriormente na caixa de diálogo Procurar.

Copiar para a Área de Transferência

Copia as linhas seleccionadas como texto simples para a área de transferência do Windows. Se você estiver examinando o Gerenciador de Configuração e os arquivos de log CCM, ele copia as colunas na mesma ordem que a vista. Ele separa cada coluna por um caractere de tabulação. Use esta ação ao copiar os logs em mensagens de e-mail ou outros documentos.

Highlight

Entrar uma string que o CMTrace usa para pesquisar o texto de cada entrada de log. Ele então destaca qualquer texto de log que combine com a string que você digitar.

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

• Para desligar o destaque, limpe a string deste campo.

• Se você digitar um número decimal ou hexadecimal, o CMTrace tenta combinar o valor com a coluna Thread. Use este comportamento para destacar o processamento de uma única thread, sem filtrar outras threads que possam interagir com ela.

• Para comparar strings por caso, habilite a opção para Case sensitive.

Filter

Show or hide log lines based on the specified criteria. Aplique filtros em qualquer uma das quatro colunas, independentemente de estarem visíveis. Estas configurações aplicam-se a cada arquivo de log aberto.

Exemplos:

• Filter smsts.log no texto de entrada contendo “a ação” ou “o grupo”.
• Filter InventoryAgent.log onde o texto de entrada contém “destino”.

Error Lookup

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

Pausa

Suspender ou reiniciar a monitorização do registo. Os seguintes casos de uso são alguns dos possíveis motivos para usar esta ação:

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

• Quando você pausa a monitoração de log, a informação que o CMTrace exibe não se perde se o arquivo atual rolar para um novo log

• Quando você quer parar o CMTrace de exibir novos dados enquanto você examina o arquivo de log

Show/Hide Details

Show or hide all columns other than the log text. Ele também expande a coluna de texto de log para a largura da janela. Use esta ação quando você estiver visualizando os logs em um computador com baixa resolução de exibição. Ele exibe mais do texto do log.

Mostrar/ocultar o painel de informações

Mostrar ou ocultar o painel de informações. Use esta ação quando estiver visualizando os logs em um computador com baixa resolução de tela. Ele exibe mais detalhes de registro.

Log pane

O painel de registro está no topo da janela do CMTrace. Ele exibe linhas dos arquivos de log.

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

Linhas iluminadas correspondem aos critérios que você define com a opção Highlight no menu Tools. O destaque usa a cor especificada em Preferências.

CMTrace exibe linhas com erros usando uma cor de fundo vermelha e uma cor de texto amarela. Nos logs em 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 distinção entre maiúsculas e minúsculas em cada entrada para qualquer string de texto que combine com “erro”.

Representa linhas com avisos usando uma cor de fundo amarela. Nos logs em 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 distinção entre maiúsculas e minúsculas em cada entrada para qualquer string de texto que corresponda a “warning”.

Painel informativo

O painel informativo está na parte inferior da janela do CMTrace. Ele inclui as seguintes características:

• Detalhes sobre a entrada de log selecionada atualmente

• Uma caixa de texto que exibe o texto de log

• Exibe retornos de transporte 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 de Log

Mostrar ou ocultar o painel de Informação com a opção Mostrar/ocultar painel de Informação no menu Ferramentas. Se o painel Info ocupa mais da metade da janela de log, o CMTrace o esconde automaticamente.

Barra de progresso

Quando você abre um arquivo de log pela primeira vez, o CMTrace substitui o painel Info por uma barra de progresso. Este progresso indica quanto do conteúdo do arquivo existente ele está carregado. O progresso atinge 100%, o CMTrace remove a barra de progresso, e a substitui pelo painel de informação. Quando você carrega arquivos grandes, este comportamento fornece uma indicação de quanto tempo a carga pode levar.

Barras de status

Para arquivos de log em formato de Gerenciador de configuração e CCM, a barra de status exibe o tempo decorrido para as entradas de log selecionadas. Se você selecionar uma única entrada, a ferramenta exibe o tempo desde a primeira entrada de log até a entrada selecionada. Se o usuário selecionar várias entradas, ele calcula o tempo desde a entrada mais selecionada até a entrada mais selecionada. CMTrace formata esta informação da seguinte forma:

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

Integração do Windows shell

CMTrace suporta associações de ficheiros e drag-and-drop.

Associações de ficheiros

CMTrace pode associar-se com extensões .log e .lo_ nome de ficheiro. Quando o programa inicia, 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 está associado a nenhuma extensão de nome de arquivo, você é solicitado a associar as extensões de nome de arquivo ao CMTrace. Se você selecionar Do not ask me this again, o CMTrace pula esta verificação sempre que for executado neste computador.

Drag-and-drop

CMTrace suporta a funcionalidade básica de drag-and-drop. Arraste um arquivo de log do Windows Explorer para o CMTrace para abri-lo.

Outras dicas

Last Directory register key

Por padrão, o CMTrace salva o último local de log que você abriu. Este comportamento é útil no servidor do site, uma vez que o caminho dos logs é sempre o padrão.

A primeira vez que você o lança em um cliente, ele é o padrão para o diretório de trabalho atual. Esta localização pode ser o caminho onde você salvou o CMTrace, ou um caminho como %userprofile%\Desktop.

O valor do último diretório na chave de registro HKEY_CURRENT_USER\Software\Microsoft\Trace32 controla esta localização padrão. Se você definir este valor para %windir%\CCM\Logs nos seus clientes, então o CMTrace abre arquivos no local de registro do cliente na primeira vez que você o executa.

>

Veja também

• Arquivos de registro

• Visualizador de arquivos de registro do Centro de Suporte

• Centro de Suporte OneTrace