CMTrace

  • Artigo

Aplica-se a: Configuration Manager (branch atual)

O CMTrace é uma das ferramentas de Configuration Manager. Ele permite exibir e monitorar arquivos de log, incluindo os seguintes tipos:

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

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

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

Observação

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

Configuration Manager versão 2107 inclui várias melhorias de desempenho para o visualizador de log CMTrace.

Localizações

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 de 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 ele estiver em um local personalizado que atenda aos seus requisitos comerciais, verifique se você tem um processo para mantê-lo atualizado. Se sua localização personalizada pode ser de benefício para outros clientes, envie comentários sobre o produto.

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

Uso

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

Você usa a maioria das ações no CMTrace nos 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 a exibição para arquivos dos seguintes tipos:

  • Arquivos de log (*.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, o CMTrace ignora o conteúdo existente do arquivo de log selecionado e exibe novas linhas apenas à medida que são adicionadas. Use essa 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 mescla os logs selecionados no modo de exibição. Ele os exibe como se fossem um único arquivo de log. O log mesclado atualiza o mesmo e dá suporte a todos os outros recursos do CMTrace como se fosse um único arquivo de log.

Abrir no Servidor

Navegue pela pasta Configuration Manager logs em um computador do sistema de sites com a caixa de diálogo Procurar padrão. Você também pode navegar pela rede por um computador remoto.

Quando você seleciona um computador remoto para navegar, o CMTrace verifica o compartilhamento de Configuration Manager. Se ele não conseguir encontrar um compartilhamento com Configuration Manager arquivos de log, 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.

Imprimir

Exiba a caixa de diálogo Padrão do Windows Print. 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 de Preferências CMTrace.

Preferências

Configurar configurações para 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 arquivos de log e carrega novas linhas. Por padrão, esse valor é de 500 milissegundos.

    • Destaque: define a cor que o CMTrace usa ao realçar as linhas de log escolhidas. Por padrão, essa cor é amarela básica (Vermelho: 255, Verde: 255, Azul: 0).

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

  • Guia impressão

    • Colunas: configure quais colunas ela usa ao imprimir arquivos de log e a ordem em que elas 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çada

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

      Observação

      Em geral, não modifique o intervalo de atualização. Ele 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 para obter uma cadeia de caracteres de texto especificada.

Localizar próximo

Localiza a próxima cadeia de caracteres correspondente, como você especificou anteriormente na caixa de diálogo Localizar.

Copiar para área de transferência

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

Marca-texto

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

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

  • Para desativar o realce, desmarcando a cadeia de caracteres deste campo.

  • Se você inserir um número decimal ou hexadecimal, o 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 caso, habilite a opção para o Caso confidencial.

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. 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 em que o texto de 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

Suspender ou reiniciar o monitoramento de log. 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 o monitoramento de log, as informações exibidas pelo CMTrace não serão perdidas se o arquivo atual for revertida para um novo log

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

Mostrar/ocultar detalhes

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

Observação

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

Painel Mostrar/Ocultar Informações

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

Painel de log

O painel de log está na parte superior da janela 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 que você define com a opção Realçar no menu Ferramentas . O destaque usa a cor especificada em Preferências.

O CMTrace exibe linhas com erros usando um fundo vermelho e cor de texto amarelo. Em logs de 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 maiúsculas de maiúsculas de minúsculas em cada entrada para qualquer "erro" de cadeia de caracteres de texto correspondente.

Ele exibe linhas com avisos usando um plano de fundo amarelo. Em logs de 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 maiúsculas de maiúsculas de minúsculas em cada entrada para qualquer cadeia de caracteres de texto que corresponda a "avisar".

Painel de informações

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

  • Detalhes sobre a entrada de log selecionada no momento

  • Uma caixa de texto que exibe o texto de log

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

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

Mostrar ou ocultar o painel Informações com a opção Mostrar/Ocultar Informações no menu Ferramentas . Se o painel Informações ocupa 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 é 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 a carga pode levar.

Barra de status

Para arquivos de log de 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á a hora da primeira entrada de log para a entrada selecionada. Se você selecionar várias entradas, ele calculará a hora da entrada mais selecionada para a entrada mais selecionada na parte inferior mais selecionada. 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 do Shell do Windows

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

Associações de arquivos

O CMTrace pode associar-se 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 do arquivo ao CMTrace. Se você selecionar Não me perguntar isso novamente, o CMTrace ignorará esse marcar 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 do Diretório

Por padrão, o CMTrace salva o último local de log que você abriu. Esse comportamento é útil no servidor do site, pois ele é padrão para o caminho de logs sempre.

Na primeira vez que você o inicia em um cliente, ele é padrão para 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 último diretório 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 o executar.

Próximas etapas

O OneTrace é o visualizador de log com a Central de Suporte. Ele funciona de forma semelhante ao CMTrace, com melhorias. Para obter mais informações, consulte Centro de Suporte OneTrace.