CMTraceCMTrace

Aplica-se a: System Center Configuration Manager (Branch Atual)Applies to: System Center Configuration Manager (Current Branch)

CMTrace é uma das ferramentas do Configuration Manager.CMTrace is one of the Configuration Manager tools. Ele permite exibir e monitorar arquivos de log, incluindo os seguintes tipos:It allows you to view and monitor log files, including the following types:

  • Arquivos de log no formato do Configuration Manager ou o CCM (gerenciador de componente de cliente)Log files in Configuration Manager or Client Component Manager (CCM) format

  • Arquivo de texto Unicode ou ASCII simples, como logs do Windows InstallerPlain ASCII or Unicode text files, such as Windows Installer logs

A ferramenta ajuda a analisar arquivos de log por meio de destaque, filtragem e pesquisa de erro.The tool helps to analyze log files by highlighting, filtering, and error lookup.

Começando na versão 1806, a ferramenta de visualização de log CMTrace é instalada automaticamente junto com o cliente do Configuration Manager.Starting in version 1806, the CMTrace log viewing tool is automatically installed along with the Configuration Manager client. Ela é adicionada ao diretório de instalação do cliente, que por padrão é %WinDir%\CCM\CMTrace.exe.It's added to the client installation directory, which by default is %WinDir%\CCM\CMTrace.exe.

Observação

O CMTrace não é registrado automaticamente no Windows para abrir a extensão de arquivo .log.CMTrace isn't automatically registered with Windows to open the .log file extension. Para obter mais informações, veja Associações de arquivo.For more information, see File associations.

Da versão 1906 em diante, o OneTrace é um novo visualizador de log com um Centro de Suporte.Starting in version 1906, OneTrace is a new log viewer with Support Center. Ele funciona de forma semelhante ao CMTrace, mas oferece melhorias.It works similarly to CMTrace, with improvements. Para saber mais, confira Centro de Suporte do OneTrace.For more information, see Support Center OneTrace.

UsoUsage

Execute CMTrace.exe.Run CMTrace.exe. Na primeira vez que você executa a ferramenta, vê um prompt para associação de arquivo.The first time you run the tool, you see a prompt for file association. Para obter mais informações, veja Associações de arquivo.For more information, see File associations.

Você executa a maioria das ações no CMTrace usando os menus a seguir:You take most actions in CMTrace from the following menus:

Menu ArquivoFile menu

As seguintes ações estão disponíveis no menu Arquivo:The following actions are available in the File menu:

No menu Arquivo também lista os últimos oito arquivos recentes.The File menu also lists the last eight recent files. Reabra um desses logs rapidamente selecionando-os no menu Arquivo.Quickly reopen one of these logs by selecting it from the File menu.

AbrirOpen

Exibe a caixa de diálogo Abrir para procurar um arquivo de log.Displays the Open dialog box to browse for a log file.

Filtre a exibição para os arquivos dos seguintes tipos:Filter the view for files of the following types:

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

As duas opções a seguir não são selecionadas por padrão:The following two options aren't selected by default:

  • Ignorar linhas existentes: quando selecionadas, o CMTrace ignora o conteúdo existente do arquivo de log selecionado e exibe novas linhas somente conforme elas são adicionadas.Ignore existing lines: When selected, CMTrace ignores the existing contents of the selected log file and displays new lines only as they're added. Use essa opção para monitorar apenas novas ações quando o histórico completo do arquivo de log não for necessário.Use this option to monitor only new actions when you don't need the full history of the log file.

  • 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.Merge selected files: If you enable this option and select more than one log file, CMTrace merges the selected logs in the view. Ele os exibe como se fossem um único arquivo de log.It displays them as if they're a single log file. O log mesclado atualiza o mesmo e dá suporte a todos os outros recursos de CMTrace como se fosse um único arquivo de log.The merged log updates the same, and supports all other CMTrace features as if it's a single log file.

Abrir no ServidorOpen on Server

Procure a pasta de logs do Configuration Manager em um computador do sistema de sites com a caixa de diálogo Procurar padrão.Browse the Configuration Manager logs folder on a site system computer with the standard Browse dialog box. Você também pode procurar na rede por um computador remoto.You can also browse the network for a remote computer.

Ao selecionar um computador remoto para procurar, o CMTrace verifica o compartilhamento do Configuration Manager.When you select a remote computer to browse, CMTrace checks for the Configuration Manager share. Se ele não conseguir localizar um compartilhamento de arquivos de log do Configuration Manager, exibirá uma mensagem de erro.If it can't find a share with Configuration Manager log files, it displays an error message.

Para se conectar diretamente a um computador conhecido sem navegar, use a ação Abrir.To connect directly to a known computer without browsing, use the Open action. Em seguida, insira um nome do servidor e compartilhamento usando o formato UNC.Then enter a server name and share using the UNC format.

ImprimirPrint

Exiba a caixa de diálogo de Impressão do Windows padrão.Display the standard Windows Print dialog box. Essa ação envia o arquivo de log atual para uma impressora.This action sends the current log file to a printer. Ele formata a saída de acordo com as configurações na guia Impressão das Preferências do CMTrace.It formats the output according to the settings on the Printing tab of CMTrace Preferences.

PreferênciasPreferences

Defina as configurações do CMTrace.Configure settings for CMTrace. As seguintes opções estão disponíveis:The following options are available:

  • GuiaGeralGeneral tab

    • Intervalo de Atualização: controla a frequência com que o CMTrace verifica se há alterações nos arquivos de log e carrega as novas linhas.Update Interval: Controls how often CMTrace checks for changes to log files and loads new lines. Por padrão, esse valor é de 500 milissegundos.By default, this value is 500 milliseconds.

    • Realçar: define a cor que o CMTrace usa ao destacar as linhas de log que você escolhe.Highlight: Sets the color that CMTrace uses when highlighting log lines that you choose. Por padrão, essa cor é amarelo básico (vermelho: 255, verde: 255, azul: 0).By default, this color is basic yellow (Red: 255, Green: 255, Blue: 0).

    • Colunas: configura as colunas visíveis na exibição de log e a ordem em que aparecem.Columns: Configures the columns that are visible in the log view and the order in which they appear. Por padrão, exibe o Texto de Log, Componente, Data/Hora e Thread.By default, it displays Log Text, Component, Date/Time, and Thread.

  • Guia ImpressãoPrinting tab

    • Colunas: configure quais colunas ele usa ao imprimir arquivos de log e a ordem em que aparecem.Columns: Configure which columns it uses when printing log files and the order in which they appear. Por padrão, ele imprime as mesmas colunas que exibe.By default, it prints the same columns as it displays.

    • Orientação: define a orientação de impressão padrão ao imprimir arquivos de log.Orientation: Sets the default print orientation when printing log files. Substitua essa configuração na caixa de diálogo Imprimir.Override this setting in the Print dialog box. Por padrão, ele usa a orientação Retrato.By default, it uses Portrait orientation.

  • Guia AvançadoAdvanced tab

    • 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.Refresh Interval: Forces CMTrace to update the log view at a specified interval when loading a large number of lines. Por padrão, essa opção é desabilitada com um valor de zero.By default, this option is disabled with a value of zero.

      Observação

      Em geral, não modifique o Intervalo de Atualização.In general, don't modify the Refresh Interval. Isso pode aumentar significativamente a quantidade de tempo que leva para abrir arquivos de log grandes.It can significantly increase the amount of time it takes to open large log files.

Menu FerramentasTools menu

As seguintes ações estão disponíveis no menu Ferramentas:The following actions are available in the Tools menu:

LocalizarFind

Pesquise o arquivo de log aberto para uma cadeia de caracteres de texto especificada.Search the open log file for a specified text string.

Localizar PróximoFind Next

Localiza a próxima cadeia de caracteres correspondente, conforme você especificou anteriormente na caixa de diálogo Localizar.Finds the next matching string, as you previously specified in the Find dialog box.

Copiar para a Área de TransferênciaCopy to Clipboard

Copia as linhas selecionadas como texto sem formatação para a área de transferência do Windows.Copies the selected lines as plain text to the Windows clipboard. Se você estiver analisando os arquivos de log do CCM e do Configuration Manager, ele copiará as colunas na mesma ordem da exibição.If you're examining Configuration Manager and CCM log files, it copies the columns in the same order as the view. Ele separa cada coluna por um caractere de tabulação.It separates each column by a tab character. Use esta ação ao copiar os logs para mensagens de email ou outros documentos.Use this action when copying logs into email messages or other documents.

DestacarHighlight

Insira uma cadeia de caracteres que usa o CMTrace para pesquisar o texto de cada entrada de log.Enter a string that CMTrace uses to search the text of each log entry. Ele então destaca qualquer texto de log que corresponde à cadeia de caracteres que você insere.It then highlights any log text that matches the string you enter.

  • O destaque usa a cor especificada nas Preferências.The highlight uses the color you specified in Preferences.

  • Para desligar o destaque, limpando a cadeia de caracteres desse campo.To turn off highlighting, clearing the string from this field.

  • Se você inserir um número decimal ou hexadecimal, o CMTrace tentará combinar o valor com a coluna de Thread.If you enter a decimal or hexadecimal number, CMTrace tries to match the value to the Thread column. Use esse comportamento para destacar o processamento de um único thread, sem filtrar outros threads que possam interagir com eles.Use this behavior to highlight the processing of a single thread, without filtering out other threads that might interact with it.

  • Para comparar cadeias de caracteres por caso, habilite a opção para Diferenciar maiúsculas de minúsculas.To compare strings by case, enable the option for Case sensitive.

FiltroFilter

Mostrar ou ocultar linhas de log com base nos critérios especificados.Show or hide log lines based on the specified criteria. Aplica filtros a qualquer uma das quatro colunas, não importa se elas estão visíveis.Apply filters to any of the four columns regardless of whether they're visible. Essas configurações se aplicam a cada arquivo de log aberto.These settings apply to each opened log file.

Exemplos:Examples:

  • Filtre SMSTS.log no texto de entrada que contém "a ação" ou "o grupo".Filter smsts.log on entry text containing "the action" or "the group".
  • Filtre InventoryAgent.log no ponto em que o texto de entrada contém "destino".Filter InventoryAgent.log where entry text contains "destination".

Pesquisa de ErroError Lookup

Digite ou cole um código de erro no formato decimal ou hexadecimal para exibir uma descrição.Type or paste an error code in either decimal or hexadecimal format to display a description. Possíveis origens do erro incluem: Windows, WMI ou Winhttp.Possible error sources include: Windows, WMI, or Winhttp.

PausarPause

Suspender ou reiniciar o monitoramento de log.Suspend or restart log monitoring. Os casos de uso a seguir estão algumas das possíveis razões para usar essa ação:The following use cases are some of the possible reasons to use this action:

  • Quando o CMTrace está exibindo informações do arquivo de log muito rapidamenteWhen CMTrace is displaying log file information too quickly

  • Quando você pausa o monitoramento de log, as informações exibidas CMTrace não serão perdidas se o arquivo atual mudar para um novo logWhen you pause log monitoring, the information that CMTrace displays isn't lost if the current file rolls over to a new log

  • Quando você deseja impedir que o CMTrace exiba novos dados enquanto você examina o arquivo de logWhen you want to stop CMTrace from displaying new data while you examine the log file

Mostrar/Ocultar DetalhesShow/Hide Details

Mostrar ou ocultar todas as colunas que não o texto de log.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.It also expands the log text column to the width of the window. Use essa ação quando você estiver exibindo os logs em um computador com baixa resolução de tela.Use this action when you're viewing logs on a computer with low display resolution. Exibe mais do texto de log.It displays more of the log text.

Observação

Ao exibir os arquivos de texto sem formatação, o CMTrace automaticamente oculta detalhes porque eles estão sempre vazios.When viewing plain-text files, CMTrace automatically hides details because they're always empty.

Mostrar/Ocultar Painel de InformaçõesShow/Hide Info Pane

Mostrar ou ocultar o painel de informações.Show or hide the Info pane. Use essa ação quando você estiver exibindo os logs em um computador com baixa resolução de tela.Use this action when you're viewing logs on a computer with low display resolution. Exibe mais detalhes de registro em log.It displays more logging details.

Painel de logLog pane

O painel de log está na parte superior da janela CMTrace.The log pane is at the top of the CMTrace window. Exibe linhas de arquivos de log.It displays lines from log files.

Quando você seleciona uma linha, ela é destacada temporariamente usando o esquema de cores de seleção do Windows.When you select a line, it's temporarily highlighted using the Windows selection color scheme.

Linhas destacadas correspondem aos critérios definidos com a opção Destaque no menu Ferramentas.Highlighted lines match the criteria you define with the Highlight option in the Tools menu. O realce usa a cor que você especifica em Preferências.The highlight uses the color that you specify in Preferences.

O CMTrace exibe linhas com erros usando uma tela de fundo vermelha e a cor do texto amarela.CMTrace displays lines with errors using a red background and yellow text color. Nos logs de formato do CCM, as entradas de log têm um valor de tipo explícito que indica a entrada como um erro.In CCM-format logs, log entries have an explicit type value that indicates the entry as an error. Para os outros formatos de log, o CMTrace faz uma pesquisa que diferencia maiúsculas de minúsculas em cada entrada para qualquer "erro" que corresponda à cadeia de caracteres de texto.For other log formats, CMTrace does a case-insensitive search in each entry for any text string matching "error".

Ele exibe linhas com avisos usando uma tela de fundo amarela.It displays lines with warnings using a yellow background. Nos logs de formato do CCM, as entradas de log têm um valor de tipo explícito que indica a entrada como um aviso.In CCM-format logs, log entries have an explicit type value that indicates the entry as a warning. Para os outros formatos de log, o CMTrace faz uma pesquisa que diferencia maiúsculas de minúsculas em cada entrada para qualquer "aviso" que corresponda à cadeia de caracteres de texto.For other log formats, CMTrace does a case-insensitive search in each entry for any text string matching "warn".

Painel de informaçõesInfo pane

O painel de informações está na parte inferior da janela CMTrace.The Info pane is at the bottom of the CMTrace window. Ele contém os seguintes recursos:It includes the following features:

  • Detalhes sobre a entrada de log selecionada no momentoDetails about the currently selected log entry

  • Uma caixa de texto que exibe o texto de logA text box that displays the log text

  • Ele exibe retornos de carro para que o texto formatado seja mais fácil de lerIt displays carriage returns so that formatted text is easier to read

  • Entradas longas mais fáceis de ler que não são totalmente visíveis no painel de LogEasier to read long entries that aren't fully visible in the Log pane

Mostrar ou ocultar o painel de Informações com a opção Mostrar/Ocultar Painel de Informações no menu Ferramentas.Show or hide the Info pane with the Show/Hide Info Pane option on the Tools menu. Se o painel de informações ocupar mais da metade da janela de log, o CMTrace a ocultará automaticamente.If the Info pane takes up more than half of the log window, CMTrace automatically hides it.

Barra de progressoProgress bar

Quando você abre um arquivo de log pela primeira vez, o CMTrace substitui o painel de Informações por uma barra de progresso.When you first open a log file, CMTrace replaces the Info pane by a progress bar. Esse progresso indica quanto dos conteúdos existentes do arquivo são carregados.This progress indicates how much of the existing file contents it's loaded. O progresso atinge 100%, o CMTrace remove a barra de progresso e a substitui pelo painel de Informações.The progress reaches 100 percent, CMTrace removes the progress bar, and replaces it with the Info pane. Quando você carrega arquivos grandes, esse comportamento fornece uma indicação de quanto tempo o carregamento pode demorar.When you load large files, this behavior provides you with an indication of how long the load might take.

Barra de statusStatus bar

Para o formato do Configuration Manager e os arquivos de log no formato CCM, a barra de status exibe o tempo decorrido para as entradas de log selecionadas.For Configuration Manager-format and CCM-format log files, the status bar displays the elapsed time for the selected log entries. Se você selecionar uma única entrada, a ferramenta exibirá a hora da primeira entrada de log para a entrada selecionada.If you select a single entry, the tool displays the time from the first log entry to the selected entry. Se você selecionar várias entradas, ele calculará o tempo da entrada selecionada da mais alta para a mais baixa.If you select multiple entries, it calculates the time from the top-most selected entry to the bottom-most selected entry. O CMTrace formata essas informações da seguinte maneira:CMTrace formats this information as follows:

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

Integração ao shell do WindowsWindows shell integration

O CMTrace dá suporte para associações de arquivo e ações do tipo "arrastar e soltar".CMTrace supports file associations and drag-and-drop.

Associações de arquivoFile associations

O CMTrace pode associar-se a extensões de nome de arquivo .log e .lo_.CMTrace can associate itself with .log and .lo_ file name extensions. Quando o programa é iniciado, ele verifica o Registro para determinar se ele já está associado a essas extensões de nome de arquivo.When the program starts, it checks the registry to determine whether it's already associated with these file name extensions. Se 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 do CMTrace.If CMTrace isn't already associated with any file name extensions, you're prompted to associate the file name extensions with CMTrace. Se você selecionar Não me perguntar novamente, o CMTrace ignorará essa verificação sempre que for executado neste computador.If you select Do not ask me this again, CMTrace skips this check whenever it's run on this computer.

Arrastar e soltarDrag-and-drop

O CMTrace é compatível com a funcionalidade básica do tipo "arrastar e soltar".CMTrace supports basic drag-and-drop functionality. Arraste um arquivo de log do Windows Explorer no CMTrace para abri-lo.Drag a log file from Windows Explorer into CMTrace to open it.

Outras dicasOther tips

Chave do Registro do último diretórioLast Directory registry key

Por padrão, o CMTrace salva o último local de log que você abriu.By default, CMTrace saves the last log location that you opened. Esse comportamento é útil no servidor do site, uma vez que ele sempre usa como o padrão o caminho de logs.This behavior is useful on the site server, as it defaults to the logs path every time.

Na primeira vez que você inicializá-lo em um cliente, ele usará como padrão o diretório de trabalho atual.The first time you launch it on a client, it defaults to the current working directory. Esse local pode ser o caminho no qual você salvou o CMTrace ou um caminho como %userprofile%\Desktop.This location may be the path where you saved CMTrace, or a path like %userprofile%\Desktop.

O valor Último Diretório na chave do Registro HKEY_CURRENT_USER\Software\Microsoft\Trace32 controla esse local padrão.The Last Directory value in the registry key HKEY_CURRENT_USER\Software\Microsoft\Trace32 controls this default location. Se você definir esse valor como %windir%\CCM\Logs nos seus clientes, o CMTrace abrirá arquivos no local de log do cliente na primeira vez que você o executar.If you set this value to %windir%\CCM\Logs on your clients, then CMTrace opens files in the client log location the first time you run it.

Consulte tambémSee also