CMTrace

  • Artigo

Aplica-se a: Configuration Manager (ramo atual)

O CMTrace é uma das ferramentas do Gestor de Configurações. Permite-lhe visualizar e monitorizar ficheiros de registo, incluindo os seguintes tipos:

  • Registar ficheiros no formato Gestor de Configuração ou Gestor de Componentes de Clientes (CCM)

  • Ficheiros de texto simples ASCII ou Unicode, tais como registos de instaladores de Windows

A ferramenta ajuda a analisar ficheiros de registo realçando, filtrando e procurando erros.

Nota

A CMTrace não está automaticamente registada com Windows para abrir a extensão de ficheiro .log. Para obter mais informações, consulte as associações de ficheiros.

A versão 2107 do Gestor de Configuração inclui múltiplas melhorias de desempenho no visualizador de registo CMTrace.

Localizações

O Gestor de Configuração 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 Gestão. Por exemplo: C:\SMS_CCM\CMTrace.exe
  • O diretório de instalação do cliente. Por exemplo: C:\Windows\CCM\CMTrace.exe
  • Imagens de arranque de implantação do SO. Por exemplo: X:\sms\bin\x64\CMTrace.exe

Se tiver uma cópia do CMTrace noutro local, considere removê-la e utilizar uma cópia num dos caminhos predefinidos. Se estiver num local personalizado que satisfaça os requisitos do seu negócio, então certifique-se de que tem um processo para mantê-lo atualizado. Se a sua localização personalizada pode ser benéfica para outros clientes, arquiva o feedback do produto.

Está disponível um script no Centro Comunitário para o ajudar a localizar e atualizar versões da CMTrace para a versão mais recente: CMTraceUpdate. Para obter mais informações, consulte links diretos para itens do hub comunitário.

Utilização

Executar CMTrace.exe. A primeira vez que executar a ferramenta, vê um pedido para associação de ficheiros. Para obter mais informações, consulte as associações de ficheiros.

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

Menu Ficheiro

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

O menu 'Ficheiro' também lista os últimos oito ficheiros recentes. Reabra rapidamente um destes registos selecionando-o no menu Ficheiro.

Abrir

Exibe a caixa de diálogo Open para navegar por um ficheiro de registo.

Filtrar a vista para ficheiros dos seguintes tipos:

  • Registar ficheiros * (.log)
  • Ficheiros de registo antigos * (.lo_)
  • Todos os ficheiros * ( * . )

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

  • Ignorar as linhas existentes: Quando selecionado, o CMTrace ignora o conteúdo existente do ficheiro de registo selecionado e exibe novas linhas apenas à medida que são adicionadas. Utilize esta opção para monitorizar apenas novas ações quando não necessitar do histórico completo do ficheiro de registo.

  • Fundir ficheiros selecionados: Se ativar esta opção e selecionar mais de um ficheiro de registo, a CMTrace funde os registos selecionados na vista. Mostra-os como se fossem um único ficheiro de registo. O registo fundido atualiza o mesmo, e suporta todas as outras funcionalidades cmTrace como se fosse um único ficheiro de registo.

Abrir no Servidor

Navegue na pasta de registos do Gestor de Configuração num computador do sistema de site com a caixa de diálogo padrão Browse. Também pode navegar na rede para um computador remoto.

Ao selecionar um computador remoto para navegar, a CMTrace verifica a partilha do Gestor de Configuração. Se não conseguir encontrar uma partilha com ficheiros de registo do Gestor de Configuração, apresenta uma mensagem de erro.

Para ligar diretamente a um computador conhecido sem navegar, utilize a ação Open. Em seguida, insira um nome de servidor e partilhe usando o formato UNC.

Imprimir

Mostrar a caixa de diálogo de impressão padrão Windows. Esta ação envia o ficheiro de registo atual para uma impressora. Formata a saída de acordo com as definições no separador de impressão das Preferências CMTrace.

Preferências

Configurar as definições para CMTrace. Estão disponíveis as seguintes opções:

  • Separador geral

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

    • Destaque: Define a cor que a CMTrace utiliza ao realçar as linhas de registo que escolhe. Por padrão, esta cor é amarelo básico (Vermelho: 255, Verde: 255, Azul: 0).

    • Colunas: Configura as colunas visíveis na vista de registo e na ordem em que aparecem. Por predefinição, apresenta texto de registo, componente, data/hora e fio.

  • Separador de impressão

    • Colunas: Configure quais colunas utiliza ao imprimir ficheiros de registo e a ordem em que aparecem. Por predefinição, imprime as mesmas colunas que exibe.

    • Orientação: Define a orientação de impressão predefinida ao imprimir ficheiros de registo. Substitua esta definição na caixa de diálogo de impressão. Por padrão, utiliza a orientação portrait.

  • Separador avançado

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

      Nota

      Em geral, não modifique o Intervalo de Atualização. Pode aumentar significativamente o tempo que leva para abrir ficheiros de registo grandes.

Menu de ferramentas

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

Localizar

Procure no ficheiro de registo aberto uma cadeia de texto especificada.

Encontrar a seguir

Encontra a próxima cadeia de correspondência, como já especificou na caixa de diálogo Find.

Copiar para a área de transferência

Copia as linhas selecionadas como texto simples para a Windows de clipboard. Se estiver a examinar os ficheiros de registo de Configuração Manager e CCM, copia as colunas na mesma ordem que a vista. Separa cada coluna por um caráter de separador. Utilize esta ação ao copiar registos em mensagens de correio e-mail ou outros documentos.

Realce

Introduza uma cadeia que a CMTrace utiliza para pesquisar o texto de cada entrada de registo. Em seguida, realça qualquer texto de registo que corresponda à cadeia em que entra.

  • O destaque utiliza a cor especificada nas Preferências.

  • Para desligar o realce, limpar a corda deste campo.

  • Se introduzir um número decimal ou hexadecimal, a CMTrace tenta corresponder o valor à coluna Thread. Utilize este comportamento para realçar o processamento de um único fio, sem filtrar outros fios que possam interagir com ele.

  • Para comparar as cordas por caso, ative a opção para caso sensível .

Filtro

Mostrar ou ocultar linhas de registo com base nos critérios especificados. Aplique filtros em qualquer uma das quatro colunas, independentemente de serem visíveis. Estas definições aplicam-se a cada ficheiro de registo aberto.

Exemplos:

  • Filtrar smsts.log em texto de entrada contendo "a ação" ou "o grupo".
  • Inventário de FiltrosAgent.log onde o texto de entrada contém "destino".

Lookup de erros

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

Colocar em pausa

Suspender ou reiniciar a monitorização do registo. Os seguintes casos de utilização são algumas das razões possíveis para utilizar esta ação:

  • Quando o CMTrace está a exibir informações de ficheiros de registo muito rapidamente

  • Quando interrompe a monitorização do registo, a informação que o CMTrace exibe não se perder se o ficheiro atual rolar para um novo registo

  • Quando pretende impedir a CMTrace de apresentar novos dados enquanto examina o ficheiro de registo

Detalhes do show/hide

Mostrar ou ocultar todas as colunas que não o texto do registo. Também expande a coluna de texto de registo para a largura da janela. Utilize esta ação quando estiver a visualizar registos num computador com baixa resolução de visualização. Exibe mais do texto de registo.

Nota

Ao visualizar ficheiros de texto simples, a CMTrace oculta automaticamente os detalhes porque estão sempre vazios.

Painel de Informações de Espetáculo/Ocultação

Mostrar ou esconder o painel de informações. Utilize esta ação quando estiver a visualizar registos num computador com baixa resolução de visualização. Apresenta mais detalhes de registo.

Painel de registo

O painel de madeira encontra-se na parte superior da janela CMTrace. Apresenta linhas a partir de ficheiros de registo.

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

As linhas destacadas correspondem aos critérios definidos com a opção 'Realçar' no menu Ferramentas. O destaque utiliza a cor que especifica nas Preferências.

CMTrace exibe linhas com erros utilizando um fundo vermelho e cor de texto amarelo. Nos registos de formato CCM, as entradas de registo têm um valor de tipo explícito que indica a entrada como um erro. Para outros formatos de registo, a CMTrace faz uma pesquisa insensível em cada entrada para qualquer "erro" de cadeia de texto.

Exibe linhas com avisos utilizando um fundo amarelo. Nos registos de formato CCM, as entradas de registo têm um valor de tipo explícito que indica a entrada como aviso. Para outros formatos de registo, a CMTrace faz uma pesquisa de caso-insensível em cada entrada para qualquer cadeia de texto que corresponda "warn".

Painel de informações

O painel de informações encontra-se na parte inferior da janela CMTrace. Inclui as seguintes características:

  • Detalhes sobre a entrada de registo atualmente selecionada

  • Uma caixa de texto que exibe o texto do registo

  • Exibe devoluções de carruagens 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ções com a opção 'Mostrar/Ocultar Informações' no menu Ferramentas. Se o painel de informações ocupa mais de metade da janela de registo, a CMTrace esconde-a automaticamente.

Barra de progresso

Quando abre pela primeira vez um ficheiro de registo, a CMTrace substitui o painel de Informação por uma barra de progresso. Este progresso indica quanto do conteúdo de ficheiros existente está carregado. O progresso atinge 100%, CMTrace remove a barra de progresso, e substitui-a pelo painel de Informação. Quando carrega ficheiros grandes, este comportamento fornece-lhe uma indicação de quanto tempo a carga pode demorar.

Barra de estado

Para o formato de Configuração Manager e ficheiros de registo de formato CCM, a barra de estado apresenta o tempo decorrido para as entradas de registo selecionadas. Se selecionar uma única entrada, a ferramenta mostra a hora a partir da primeira entrada de registo para a entrada selecionada. Se selecionar várias entradas, calcula o tempo a partir da entrada mais selecionada para a entrada mais selecionada. A CMTrace forma esta informação da seguinte forma:

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

integração Windows shell

A CMTrace suporta associações de ficheiros e arrastar e largar.

Associações de arquivos

A CMTrace pode associar-se a extensões de nome de ficheiros .log e .lo_. Quando o programa começa, verifica o registo para determinar se já está associado a estas extensões de nome de ficheiro. Se a CMTrace ainda não estiver associada a quaisquer extensões de nome de ficheiro, é solicitado que as extensões de nome do ficheiro sejam associadas à CMTrace. Se selecionar Não me pergunte isto novamente, CMTrace ignora esta verificação sempre que é executada neste computador.

Arrastar e largar

O CMTrace suporta a funcionalidade básica de arrastar e largar. Arraste um ficheiro de registo do Windows Explorer para a CMTrace para o abrir.

Outras dicas

Última chave do registo do diretório

Por predefinição, a CMTrace guarda o último local de registo que abriu. Este comportamento é útil no servidor do site, uma vez que predefine o caminho dos registos de cada vez.

A primeira vez que o lanças num cliente, não faz parte do diretório atual. Este local pode ser o caminho onde salvou o CMTrace, ou um caminho como %userprofile%\Desktop .

O valor do Último Diretório na chave de registo controla esta HKEY_CURRENT_USER\Software\Microsoft\Trace32 localização predefinido. Se definir este valor %windir%\CCM\Logs nos seus clientes, então a CMTrace abre ficheiros no local de registo do cliente da primeira vez que o executou.

Passos seguintes

OneTrace é o visualizador de registos com Centro de Suporte. Funciona da mesma forma que a CMTrace, com melhorias. Para mais informações, consulte o Centro de Suporte OneTrace.