CMTraceCMTrace

Se aplica a: Configuration Manager (rama actual)Applies to: Configuration Manager (current branch)

CMTrace es una de las herramientas de Configuration Manager.CMTrace is one of the Configuration Manager tools. Permite ver y supervisar los archivos de registro, incluidos los siguientes tipos:It allows you to view and monitor log files, including the following types:

  • Archivos de registro en formato de Configuration Manager o de Administrador de componentes cliente (CCM)Log files in Configuration Manager or Client Component Manager (CCM) format

  • Archivos de texto Unicode o ASCII sin formato, como los registros de Windows InstallerPlain ASCII or Unicode text files, such as Windows Installer logs

La herramienta ayuda a analizar los archivos de registro mediante el resaltado, el filtrado y la búsqueda de errores.The tool helps to analyze log files by highlighting, filtering, and error lookup.

A partir de la versión 1806, la herramienta de visualización de registros CMTrace se instala automáticamente con el cliente de Configuration Manager.Starting in version 1806, the CMTrace log viewing tool is automatically installed along with the Configuration Manager client. Se agrega al directorio de instalación del cliente, que de forma predeterminada es %WinDir%\CCM\CMTrace.exe.It's added to the client installation directory, which by default is %WinDir%\CCM\CMTrace.exe.

Nota

CMTrace no se registra automáticamente con Windows para abrir la extensión de archivo. log.CMTrace isn't automatically registered with Windows to open the .log file extension. Para más información, vea Asociaciones de archivo.For more information, see File associations.

A partir de la versión 1906, OneTrace es un nuevo visor de registros del Centro de soporte técnico.Starting in version 1906, OneTrace is a new log viewer with Support Center. Funciona de manera similar a CMTrace, pero con mejoras.It works similarly to CMTrace, with improvements. Para obtener más información, consulte Centro de soporte técnico OneTrace.For more information, see Support Center OneTrace.

UsoUsage

Ejecute CMTrace.exe.Run CMTrace.exe. La primera vez que ejecute la herramienta, verá una solicitud de asociación de archivos.The first time you run the tool, you see a prompt for file association. Para más información, vea Asociaciones de archivo.For more information, see File associations.

La mayoría de las acciones de CMTrace se realizan desde los siguientes menús:You take most actions in CMTrace from the following menus:

Menú ArchivoFile menu

Las acciones siguientes están disponibles en el menú Archivo:The following actions are available in the File menu:

El menú Archivo también muestra los ocho archivos más recientes.The File menu also lists the last eight recent files. Para reabrir rápidamente uno de estos registros, selecciónelo en el menú Archivo.Quickly reopen one of these logs by selecting it from the File menu.

AbrirOpen

Muestra el cuadro de diálogo Abrir para buscar un archivo de registro.Displays the Open dialog box to browse for a log file.

Filtre la vista por archivos de los siguientes tipos:Filter the view for files of the following types:

  • Archivos de registro (*.log)Log files (*.log)
  • Archivos de registro antiguos (*.lo_)Old log files (*.lo_)
  • Todos los archivos (*.*)All files (*.*)

Las dos opciones siguientes no están seleccionadas de forma predeterminada:The following two options aren't selected by default:

  • Omitir líneas existentes: cuando se selecciona, CMTrace omite el contenido existente del archivo de registro seleccionado y solo muestra las nuevas líneas cuando se agregan.Ignore existing lines: When selected, CMTrace ignores the existing contents of the selected log file and displays new lines only as they're added. Utilice esta opción solo para supervisar nuevas acciones cuando ya no necesite el historial completo del archivo de registro.Use this option to monitor only new actions when you don't need the full history of the log file.

  • Combinar archivos seleccionados: si habilita esta opción y selecciona más de un archivo de registro, CMTrace combina los registros seleccionados en la vista.Merge selected files: If you enable this option and select more than one log file, CMTrace merges the selected logs in the view. Los muestra como si fuesen un solo archivo de registro.It displays them as if they're a single log file. El registro combinado actualiza lo mismo y admite el resto de características de CMTrace como si fuera un solo archivo de registro.The merged log updates the same, and supports all other CMTrace features as if it's a single log file.

Open on Server (Abrir en el servidor)Open on Server

Vaya a la carpeta de registros de Configuration Manager en un equipo de sistema de sitio con el cuadro de diálogo Examinar estándar.Browse the Configuration Manager logs folder on a site system computer with the standard Browse dialog box. También puede buscar un equipo remoto en la red.You can also browse the network for a remote computer.

Al seleccionar un equipo remoto para examinarlo, CMTrace busca el recurso compartido de Configuration Manager.When you select a remote computer to browse, CMTrace checks for the Configuration Manager share. Si no encuentra un recurso compartido con archivos de registro de Configuration Manager, muestra un mensaje de error.If it can't find a share with Configuration Manager log files, it displays an error message.

Para conectarse directamente a un equipo conocido sin navegar, use la acción Abrir.To connect directly to a known computer without browsing, use the Open action. Luego escriba un nombre de servidor y compártalo con el formato UNC.Then enter a server name and share using the UNC format.

ImprimirPrint

Muestra el cuadro de diálogo Imprimir de Windows estándar.Display the standard Windows Print dialog box. Con esta acción se envía el archivo de registro actual a una impresora.This action sends the current log file to a printer. Da formato a la salida según la configuración de la pestaña de impresión de las preferencias de CMTrace.It formats the output according to the settings on the Printing tab of CMTrace Preferences.

PreferenciasPreferences

Configure las opciones de CMTrace.Configure settings for CMTrace. Están disponibles las siguientes opciones:The following options are available:

  • PestañaGeneralGeneral tab

    • Intervalo de actualización: controla la frecuencia con la que CMTrace comprueba si hay cambios en los archivos de registro y carga nuevas líneas.Update Interval: Controls how often CMTrace checks for changes to log files and loads new lines. De forma predeterminada, este valor es de 500 milisegundos.By default, this value is 500 milliseconds.

    • Resaltar: establece el color que CMTrace usa para resaltar las líneas del registro que seleccione.Highlight: Sets the color that CMTrace uses when highlighting log lines that you choose. De forma predeterminada, este color es amarillo básico (rojo: 255, verde: 255, azul: 0).By default, this color is basic yellow (Red: 255, Green: 255, Blue: 0).

    • Columnas: configura las columnas que están visibles en la vista del registro y el orden en que aparecen.Columns: Configures the columns that are visible in the log view and the order in which they appear. De forma predeterminada, muestra Texto del registro, Componente, Fecha y hora y Subproceso.By default, it displays Log Text, Component, Date/Time, and Thread.

  • Pestaña ImpresiónPrinting tab

    • Columnas: configure las columnas que se usan al imprimir archivos de registro y el orden en que aparecen.Columns: Configure which columns it uses when printing log files and the order in which they appear. De forma predeterminada, imprime las mismas columnas que muestra.By default, it prints the same columns as it displays.

    • Orientación: establece la orientación de impresión predeterminado al imprimir archivos de registro.Orientation: Sets the default print orientation when printing log files. Reemplace esta configuración en el cuadro de diálogo Imprimir.Override this setting in the Print dialog box. De forma predeterminada, utiliza orientación Vertical.By default, it uses Portrait orientation.

  • Pestaña AvanzadasAdvanced tab

    • Intervalo de actualización: obliga a CMTrace a actualizar la vista del registro en un intervalo especificado al cargar un gran número de líneas.Refresh Interval: Forces CMTrace to update the log view at a specified interval when loading a large number of lines. De forma predeterminada, esta opción está deshabilitada con un valor de cero.By default, this option is disabled with a value of zero.

      Nota

      En general, no modifique el intervalo de actualización.In general, don't modify the Refresh Interval. Eso puede aumentar considerablemente la cantidad de tiempo necesario para abrir archivos de registro grandes.It can significantly increase the amount of time it takes to open large log files.

Menú HerramientasTools menu

Las acciones siguientes están disponibles en el menú Herramientas:The following actions are available in the Tools menu:

BuscarFind

Busque una cadena de texto especificado en el archivo de registro abierto.Search the open log file for a specified text string.

Buscar siguienteFind Next

Busca la siguiente cadena coincidente con la especificada anteriormente en el cuadro de diálogo Buscar.Finds the next matching string, as you previously specified in the Find dialog box.

Copiar al PortapapelesCopy to Clipboard

Copia las líneas seleccionadas como texto sin formato en el Portapapeles de Windows.Copies the selected lines as plain text to the Windows clipboard. Si se examinan archivos de registro de CCM y Configuration Manager, copia las columnas en el mismo orden en que aparecen en la vista.If you're examining Configuration Manager and CCM log files, it copies the columns in the same order as the view. Separa cada columna con un carácter de tabulación.It separates each column by a tab character. Utilice esta acción cuando copie registros en los mensajes de correo electrónico o en otros documentos.Use this action when copying logs into email messages or other documents.

ResaltarHighlight

Escriba una cadena que CMTrace use para buscar el texto de cada entrada del registro.Enter a string that CMTrace uses to search the text of each log entry. Luego se resalta cualquier texto del registro que coincida con la cadena especificada.It then highlights any log text that matches the string you enter.

  • El resaltado utiliza el color que se especifique en Preferencias.The highlight uses the color you specified in Preferences.

  • Para desactivar el resaltado, borre la cadena de este campo.To turn off highlighting, clearing the string from this field.

  • Si escribe un número decimal o hexadecimal, CMTrace intenta hacer coincidir el valor con la columna Subproceso.If you enter a decimal or hexadecimal number, CMTrace tries to match the value to the Thread column. Utilice este comportamiento para resaltar el procesamiento de un único subproceso, sin filtrar otros subprocesos que puedan interactuar con él.Use this behavior to highlight the processing of a single thread, without filtering out other threads that might interact with it.

  • Para comparar cadenas por mayúsculas y minúsculas, habilite la opción Distinguir mayúsculas de minúsculas.To compare strings by case, enable the option for Case sensitive.

FiltroFilter

Muestra u oculta las líneas de registro según los criterios especificados.Show or hide log lines based on the specified criteria. Aplique filtros a cualquiera de las cuatro columnas independientemente de si están visibles.Apply filters to any of the four columns regardless of whether they're visible. Estas opciones se aplican a cada archivo de registro abierto.These settings apply to each opened log file.

Ejemplos:Examples:

  • Filtro smsts.log en texto de entrada que contenga "la acción" o "el grupo".Filter smsts.log on entry text containing "the action" or "the group".
  • Filtro InventoryAgent.log cuando el texto de entrada contiene "destino".Filter InventoryAgent.log where entry text contains "destination".

Búsqueda de erroresError Lookup

Escriba o pegue un código de error en formato decimal o hexadecimal para mostrar una descripción.Type or paste an error code in either decimal or hexadecimal format to display a description. Entre los posibles orígenes de errores, se incluyen los siguientes: Windows, WMI o WinHTTP.Possible error sources include: Windows, WMI, or Winhttp.

PausarPause

Suspenda o reinicie la supervisión del registro.Suspend or restart log monitoring. Los siguientes casos de uso son algunos de los posibles motivos para usar esta acción:The following use cases are some of the possible reasons to use this action:

  • Cuando CMTrace muestra información del archivo de registro demasiado rápidoWhen CMTrace is displaying log file information too quickly

  • Cuando pausa la supervisión del registro, la información que CMTrace muestra no se pierde si el archivo actual pasa a un nuevo registroWhen you pause log monitoring, the information that CMTrace displays isn't lost if the current file rolls over to a new log

  • Cuando quiere que CMTrace deje de mostrar nuevos datos mientras se examina el archivo de registroWhen you want to stop CMTrace from displaying new data while you examine the log file

Mostrar u ocultar detallesShow/Hide Details

Muestra u oculta todas las columnas aparte de la de texto del registro.Show or hide all columns other than the log text. También expande la columna de texto del registro hasta el ancho de la ventana.It also expands the log text column to the width of the window. Use esta acción cuando visualice los registros en un equipo con una resolución de pantalla baja.Use this action when you're viewing logs on a computer with low display resolution. Se muestra mayor parte del texto de registro.It displays more of the log text.

Nota

Cuando se visualizan archivos de texto sin formato, CMTrace oculta automáticamente los detalles porque siempre están vacíos.When viewing plain-text files, CMTrace automatically hides details because they're always empty.

Show/Hide Info Pane (Mostrar u ocultar panel de información)Show/Hide Info Pane

Muestra u oculta el panel de información.Show or hide the Info pane. Use esta acción cuando visualice los registros en un equipo con una resolución de pantalla baja.Use this action when you're viewing logs on a computer with low display resolution. Se muestran más detalles del registro.It displays more logging details.

Panel de registroLog pane

El panel de registro se encuentra en la parte superior de la ventana CMTrace.The log pane is at the top of the CMTrace window. Muestra líneas de los archivos de registro.It displays lines from log files.

Cuando se selecciona una línea, se resalta temporalmente con la combinación de colores de selección de Windows.When you select a line, it's temporarily highlighted using the Windows selection color scheme.

Las líneas resaltadas coinciden con los criterios definidos con la opción Resaltar del menú Herramientas.Highlighted lines match the criteria you define with the Highlight option in the Tools menu. El resaltado utiliza el color que se especifique en Preferencias.The highlight uses the color that you specify in Preferences.

CMTrace utiliza texto de color amarillo sobre un fondo rojo para mostrar las líneas con errores.CMTrace displays lines with errors using a red background and yellow text color. En los registros con formato de CCM, las entradas del registro tienen un valor de tipo explícito que indica la entrada como un error.In CCM-format logs, log entries have an explicit type value that indicates the entry as an error. Para otros formatos de registro, CMTrace realiza una búsqueda que no distingue mayúsculas de minúsculas de cualquier cadena de texto que coincida con "error" en cada entrada.For other log formats, CMTrace does a case-insensitive search in each entry for any text string matching "error".

Muestra las líneas con advertencias con un fondo amarillo.It displays lines with warnings using a yellow background. En los registros con formato de CCM, las entradas del registro tienen un valor de tipo explícito que indica la entrada como una advertencia.In CCM-format logs, log entries have an explicit type value that indicates the entry as a warning. Para otros formatos de registro, CMTrace realiza una búsqueda que no distingue mayúsculas de minúsculas de cualquier cadena de texto que coincida con "warn" en cada entrada.For other log formats, CMTrace does a case-insensitive search in each entry for any text string matching "warn".

Panel de informaciónInfo pane

El panel de información se encuentra en la parte inferior de la ventana CMTrace.The Info pane is at the bottom of the CMTrace window. Contiene las características siguientes:It includes the following features:

  • Detalles sobre la entrada del registro seleccionada actualmenteDetails about the currently selected log entry

  • Un cuadro de texto que muestra el texto del registroA text box that displays the log text

  • Muestra los retornos de carro para que el texto con formato sea más fácil de leerIt displays carriage returns so that formatted text is easier to read

  • Las entradas largas que no son totalmente visibles en el panel de registro resultan más fáciles de leerEasier to read long entries that aren't fully visible in the Log pane

Muestre u oculte el panel de información con la opción Show/Hide Info Pane (Mostrar u ocultar panel de información) del menú Herramientas.Show or hide the Info pane with the Show/Hide Info Pane option on the Tools menu. Si el panel de información ocupa más de la mitad de la ventana de registro, CMTrace lo oculta automáticamente.If the Info pane takes up more than half of the log window, CMTrace automatically hides it.

Barra de progresoProgress bar

Al abrir un archivo de registro por primera vez, CMTrace reemplaza el panel de información por una barra de progreso.When you first open a log file, CMTrace replaces the Info pane by a progress bar. El progreso indica cuánto contenido del archivo existente está cargado.This progress indicates how much of the existing file contents it's loaded. Cuando el progreso llega al 100 %, CMTrace quita la barra de progreso y la reemplaza por el panel de información.The progress reaches 100 percent, CMTrace removes the progress bar, and replaces it with the Info pane. Al cargar archivos grandes, este comportamiento le indica cuánto tiempo puede tardar la carga.When you load large files, this behavior provides you with an indication of how long the load might take.

Barra de estadoStatus bar

En el caso de los archivos de registro con formato de Configuration Manager y de CCM, la barra de estado muestra el tiempo transcurrido para las entradas del registro seleccionadas.For Configuration Manager-format and CCM-format log files, the status bar displays the elapsed time for the selected log entries. Si se selecciona una sola entrada, la herramienta muestra el tiempo desde la primera entrada del registro hasta la entrada seleccionada.If you select a single entry, the tool displays the time from the first log entry to the selected entry. Si se seleccionan varias entradas, calcula el tiempo desde la primera entrada seleccionada hasta la última entrada seleccionada.If you select multiple entries, it calculates the time from the top-most selected entry to the bottom-most selected entry. CMTrace da formato a esta información de la manera siguiente:CMTrace formats this information as follows:

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

Integración de Windows ShellWindows shell integration

CMTrace admite asociaciones de archivo y arrastrar y colocar.CMTrace supports file associations and drag-and-drop.

Asociaciones de archivoFile associations

CMTrace puede asociarse a extensiones de nombre de archivo .log y .lo_.CMTrace can associate itself with .log and .lo_ file name extensions. Cuando el programa se inicia, comprueba el registro para determinar si ya está asociado a estas extensiones de nombre de archivo.When the program starts, it checks the registry to determine whether it's already associated with these file name extensions. Si CMTrace no está ya asociado ninguna extensión de nombre de archivo, se le pedirá que asocie las extensiones de nombre de archivo a CMTrace.If CMTrace isn't already associated with any file name extensions, you're prompted to associate the file name extensions with CMTrace. Si selecciona No volver a preguntar, CMTrace omitirá esta comprobación cada vez que se ejecute en este equipo.If you select Do not ask me this again, CMTrace skips this check whenever it's run on this computer.

Arrastrar y colocarDrag-and-drop

CMTrace admite funcionalidad básica de arrastrar y colocar.CMTrace supports basic drag-and-drop functionality. Arrastre un archivo de registro desde el Explorador de Windows a CMTrace para abrirlo.Drag a log file from Windows Explorer into CMTrace to open it.

Otras sugerenciasOther tips

Clave del registro de Last DirectoryLast Directory registry key

De forma predeterminada, CMTrace guarda la última ubicación del registro que se ha abierto.By default, CMTrace saves the last log location that you opened. Este comportamiento es útil en el servidor de sitio porque el valor predeterminado es siempre la ruta de acceso de los registros.This behavior is useful on the site server, as it defaults to the logs path every time.

La primera vez que se inicie en un cliente, el valor predeterminado es el directorio de trabajo actual.The first time you launch it on a client, it defaults to the current working directory. Esta ubicación puede ser la ruta de acceso donde guardó CMTrace o una ruta de acceso como %userprofile%\Desktop.This location may be the path where you saved CMTrace, or a path like %userprofile%\Desktop.

El valor Last Directory de la clave del registro HKEY_CURRENT_USER\Software\Microsoft\Trace32 controla esta ubicación predeterminada.The Last Directory value in the registry key HKEY_CURRENT_USER\Software\Microsoft\Trace32 controls this default location. Si establece este valor en %windir%\CCM\Logs en los clientes, CMTrace abrirá los archivos en la ubicación de registro del cliente la primera vez que lo ejecute.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.

Vea tambiénSee also