CMTraceCMTrace

S’applique à : System Center Configuration Manager (Current Branch)Applies to: System Center Configuration Manager (Current Branch)

CMTrace fait partie des outils de Configuration Manager.CMTrace is one of the Configuration Manager tools. Il vous permet d’afficher et de surveiller les fichiers journaux, notamment les types suivants :It allows you to view and monitor log files, including the following types:

  • Fichiers journaux au format Configuration Manager ou CCM (Client Component Manager)Log files in Configuration Manager or Client Component Manager (CCM) format

  • Fichiers au format texte ASCII ou Unicode, tels que les journaux de Windows InstallerPlain ASCII or Unicode text files, such as Windows Installer logs

L’outil aide à analyser les fichiers journaux par la mise en surbrillance, le filtrage et la recherche d’erreurs.The tool helps to analyze log files by highlighting, filtering, and error lookup.

Depuis la version 1806, l’outil d’affichage des journaux CMTrace est automatiquement installé avec le client Configuration Manager.Starting in version 1806, the CMTrace log viewing tool is automatically installed along with the Configuration Manager client. Il est ajouté au répertoire d’installation du client, qui est par défaut %WinDir%\CCM\CMTrace.exe.It's added to the client installation directory, which by default is %WinDir%\CCM\CMTrace.exe.

Notes

CMTrace n’est pas automatiquement inscrit auprès de Windows pour ouvrir l’extension de fichier .log.CMTrace isn't automatically registered with Windows to open the .log file extension. Pour plus d’informations, consultez Associations de fichiers.For more information, see File associations.

Depuis la version 1906, OneTrace est une nouvelle visionneuse du journal avec le Centre d’aide et de support.Starting in version 1906, OneTrace is a new log viewer with Support Center. Elle fonctionne de façon similaire à CMTrace, avec des améliorations.It works similarly to CMTrace, with improvements. Pour plus d’informations, voir Centre d’aide et de support OneTrace.For more information, see Support Center OneTrace.

UtilisationUsage

Exécutez CMTrace.exe.Run CMTrace.exe. La première fois que vous exécutez l’outil, vous voyez une invite pour une association de fichiers.The first time you run the tool, you see a prompt for file association. Pour plus d’informations, consultez Associations de fichiers.For more information, see File associations.

Vous effectuez la plupart des actions dans CMTrace à partir des menus suivants :You take most actions in CMTrace from the following menus:

Menu FichierFile menu

Les actions suivantes sont disponibles dans le menu File :The following actions are available in the File menu:

Le menu File liste également les huit fichiers les plus récents.The File menu also lists the last eight recent files. Rouvrez rapidement l’un de ces journaux en le sélectionnant dans le menu File.Quickly reopen one of these logs by selecting it from the File menu.

OuvrirOpen

Affiche la boîte de dialogue Open pour rechercher un fichier journal.Displays the Open dialog box to browse for a log file.

Filtrez l’affichage pour les fichiers des types suivants :Filter the view for files of the following types:

  • Fichiers journaux (*.log)Log files (*.log)
  • Anciens fichiers journaux (*.lo_)Old log files (*.lo_)
  • Tous les fichiers (*.*)All files (*.*)

Les deux options suivantes ne sont pas sélectionnées par défaut :The following two options aren't selected by default:

  • Ignore existing lines : lorsque cette option est sélectionnée, CMTrace ignore le contenu existant du fichier journal sélectionné et n’affiche les nouvelles lignes qu’au moment où elles sont ajoutées.Ignore existing lines: When selected, CMTrace ignores the existing contents of the selected log file and displays new lines only as they're added. Utilisez cette option pour superviser uniquement les nouvelles actions quand vous n’avez pas besoin de l’historique complet du fichier journal.Use this option to monitor only new actions when you don't need the full history of the log file.

  • Merge selected files : si vous activez cette option et que vous sélectionnez plusieurs fichiers journaux, CMTrace fusionne les journaux sélectionnés dans la vue.Merge selected files: If you enable this option and select more than one log file, CMTrace merges the selected logs in the view. Il les affiche comme s’il s’agissait d’un fichier journal unique.It displays them as if they're a single log file. Le journal fusionné est mis à jour de la même façon et prend en charge toutes les autres fonctionnalités de CMTrace comme s’il s’agissait d’un fichier journal unique.The merged log updates the same, and supports all other CMTrace features as if it's a single log file.

Open on ServerOpen on Server

Parcourez le dossier des journaux Configuration Manager sur un ordinateur du système de site avec la boîte de dialogue Parcourir standard.Browse the Configuration Manager logs folder on a site system computer with the standard Browse dialog box. Vous pouvez également parcourir le réseau à la recherche d’un ordinateur distant.You can also browse the network for a remote computer.

Quand vous sélectionnez un ordinateur distant à parcourir, CMTrace recherche le partage Configuration Manager.When you select a remote computer to browse, CMTrace checks for the Configuration Manager share. S’il ne trouve pas de partage avec les fichiers journaux Configuration Manager, il affiche un message d’erreur.If it can't find a share with Configuration Manager log files, it displays an error message.

Pour vous connecter directement à un ordinateur connu sans navigation, utilisez l’action Open.To connect directly to a known computer without browsing, use the Open action. Entrez un nom de serveur et un partage en utilisant le format UNC.Then enter a server name and share using the UNC format.

ImprimerPrint

Affichez la boîte de dialogue Imprimer Windows standard.Display the standard Windows Print dialog box. Cette action envoie le fichier journal actuel à une imprimante.This action sends the current log file to a printer. Elle met en forme la sortie en fonction des paramètres sous l’onglet Printing de Preferences CMTrace.It formats the output according to the settings on the Printing tab of CMTrace Preferences.

PreferencesPreferences

Configurez les paramètres pour CMTrace.Configure settings for CMTrace. Les options ci-dessous sont disponibles :The following options are available:

  • OngletGénéralGeneral tab

    • Update Interval : contrôle la fréquence à laquelle CMTrace recherche des modifications apportées aux fichiers journaux et charge de nouvelles lignes.Update Interval: Controls how often CMTrace checks for changes to log files and loads new lines. Par défaut, cette valeur est de 500 millisecondes.By default, this value is 500 milliseconds.

    • Highlight : définit la couleur que CMTrace utilise lors de la mise en surbrillance des lignes de journal que vous choisissez.Highlight: Sets the color that CMTrace uses when highlighting log lines that you choose. Par défaut, cette couleur est le jaune de base (rouge : 255, vert : 255, bleu : 0).By default, this color is basic yellow (Red: 255, Green: 255, Blue: 0).

    • Columns : configure les colonnes qui sont visibles dans la vue du journal et l’ordre dans lequel elles apparaissent.Columns: Configures the columns that are visible in the log view and the order in which they appear. Par défaut, les colonnes Log Text, Component, Date/Time et Thread sont affichées.By default, it displays Log Text, Component, Date/Time, and Thread.

  • Onglet PrintingPrinting tab

    • Columns : configure les colonnes utilisées lors de l’impression de fichiers journaux et l’ordre dans lequel elles apparaissent.Columns: Configure which columns it uses when printing log files and the order in which they appear. Par défaut, les colonnes affichées sont imprimées.By default, it prints the same columns as it displays.

    • Orientation : définit l’orientation d’impression par défaut lors de l’impression de fichiers journaux.Orientation: Sets the default print orientation when printing log files. Remplacez ce paramètre dans la boîte de dialogue d’impression.Override this setting in the Print dialog box. Par défaut, l’orientation Portrait est utilisée.By default, it uses Portrait orientation.

  • Onglet AdvancedAdvanced tab

    • Refresh Interval : force CMTrace à mettre à jour la vue du journal selon un intervalle spécifié lors du chargement d’un grand nombre de lignes.Refresh Interval: Forces CMTrace to update the log view at a specified interval when loading a large number of lines. Par défaut, cette option est désactivée avec une valeur égale à zéro.By default, this option is disabled with a value of zero.

      Notes

      En règle générale, ne modifiez pas la valeur pour Refresh Interval.In general, don't modify the Refresh Interval. Cela peut augmenter considérablement le délai nécessaire pour ouvrir des fichiers journaux volumineux.It can significantly increase the amount of time it takes to open large log files.

Menu ToolsTools menu

Les actions suivantes sont disponibles dans le menu Tools :The following actions are available in the Tools menu:

TrouverFind

Recherchez une chaîne de texte spécifiée dans le fichier journal ouvert.Search the open log file for a specified text string.

SuivantFind Next

Recherche la chaîne correspondante suivante, que vous avez spécifiée précédemment dans la boîte de dialogue Find.Finds the next matching string, as you previously specified in the Find dialog box.

Copy to ClipboardCopy to Clipboard

Copie les lignes sélectionnées comme texte brut dans le Presse-papiers Windows.Copies the selected lines as plain text to the Windows clipboard. Si vous examinez les fichiers journaux Configuration Manager et CCM, il copie les colonnes dans le même ordre que l’affichage.If you're examining Configuration Manager and CCM log files, it copies the columns in the same order as the view. Chaque colonne est séparée par un caractère de tabulation.It separates each column by a tab character. Utilisez cette action lors de la copie des journaux dans les e-mails ou d’autres documents.Use this action when copying logs into email messages or other documents.

HighlightHighlight

Entrez une chaîne que CMTrace recherche dans le texte de chaque entrée de journal.Enter a string that CMTrace uses to search the text of each log entry. Il met ensuite en surbrillance n’importe quel texte du journal qui correspond à la chaîne que vous entrez.It then highlights any log text that matches the string you enter.

  • La mise en surbrillance utilise la couleur que vous avez spécifiée dans Preferences.The highlight uses the color you specified in Preferences.

  • Pour désactiver la mise en surbrillance, effacez la chaîne de ce champ.To turn off highlighting, clearing the string from this field.

  • Si vous entrez un nombre décimal ou hexadécimal, CMTrace essaie d’associer la valeur à la colonne Thread.If you enter a decimal or hexadecimal number, CMTrace tries to match the value to the Thread column. Ce comportement permet de mettre en surbrillance le traitement d’un thread unique, sans filtrage des autres threads qui peuvent interagir avec lui.Use this behavior to highlight the processing of a single thread, without filtering out other threads that might interact with it.

  • Pour comparer des chaînes par la casse, activez l’option Case sensitive.To compare strings by case, enable the option for Case sensitive.

FiltreFilter

Affichez ou masquez des lignes du journal en fonction des critères spécifiés.Show or hide log lines based on the specified criteria. Appliquez des filtres à l’une des quatre colonnes qu’elles soient visibles ou non.Apply filters to any of the four columns regardless of whether they're visible. Ces paramètres s’appliquent à chaque fichier journal ouvert.These settings apply to each opened log file.

Exemples :Examples:

  • Filtrez smsts.log sur le texte d’entrée contenant « the action » ou « the group ».Filter smsts.log on entry text containing "the action" or "the group".
  • Filtrez InventoryAgent.log avec le texte d’entrée qui contient « destination ».Filter InventoryAgent.log where entry text contains "destination".

Error LookupError Lookup

Tapez ou collez un code d’erreur au format décimal ou hexadécimal pour afficher une description.Type or paste an error code in either decimal or hexadecimal format to display a description. Les sources d’erreur possibles sont les suivantes : Windows, WMI ou Winhttp.Possible error sources include: Windows, WMI, or Winhttp.

SuspendrePause

Suspendez ou redémarrez la surveillance du journal.Suspend or restart log monitoring. Les cas d’usage suivants représentent certaines des raisons possibles pour utiliser cette action :The following use cases are some of the possible reasons to use this action:

  • Quand CMTrace affiche les informations du fichier journal trop rapidementWhen CMTrace is displaying log file information too quickly

  • Quand vous suspendez la surveillance du journal, les informations que CMTrace affiche ne sont pas perdues si le fichier actif bascule vers un nouveau journalWhen you pause log monitoring, the information that CMTrace displays isn't lost if the current file rolls over to a new log

  • Quand vous souhaitez empêcher CMTrace d’afficher de nouvelles données pendant que vous examinez le fichier journalWhen you want to stop CMTrace from displaying new data while you examine the log file

Show/Hide DetailsShow/Hide Details

Affichez ou masquez toutes les colonnes autres que le texte du journal.Show or hide all columns other than the log text. Cette action adapte également la colonne de texte du journal à la largeur de la fenêtre.It also expands the log text column to the width of the window. Utilisez cette action quand vous consultez des journaux sur un ordinateur avec une résolution d’affichage faible.Use this action when you're viewing logs on a computer with low display resolution. Elle affiche plus de texte du journal.It displays more of the log text.

Notes

Quand vous affichez des fichiers de texte brut, CMTrace masque automatiquement les détails, car ils sont toujours vides.When viewing plain-text files, CMTrace automatically hides details because they're always empty.

Show/Hide Info PaneShow/Hide Info Pane

Affichez ou masquez le volet d’informations.Show or hide the Info pane. Utilisez cette action quand vous consultez des journaux sur un ordinateur avec une résolution d’affichage faible.Use this action when you're viewing logs on a computer with low display resolution. Elle affiche plus de détails de journalisation.It displays more logging details.

Volet de journalLog pane

Le volet de journal figure en haut de la fenêtre CMTrace.The log pane is at the top of the CMTrace window. Il affiche des lignes des fichiers journaux.It displays lines from log files.

Quand vous sélectionnez une ligne, elle est temporairement mise en surbrillance à l’aide du modèle de couleurs de sélection Windows.When you select a line, it's temporarily highlighted using the Windows selection color scheme.

Les lignes en surbrillance correspondent aux critères que vous définissez avec l’option Highlight dans le menu Tools.Highlighted lines match the criteria you define with the Highlight option in the Tools menu. La mise en surbrillance utilise la couleur que vous spécifiez dans Preferences.The highlight uses the color that you specify in Preferences.

CMTrace affiche les lignes avec des erreurs à l’aide d’un arrière-plan rouge et de la couleur de texte jaune.CMTrace displays lines with errors using a red background and yellow text color. Dans les journaux au format CCM, les entrées du journal ont une valeur de type explicite qui indique l’entrée comme une erreur.In CCM-format logs, log entries have an explicit type value that indicates the entry as an error. Pour les autres formats de journaux, CMTrace effectue une recherche non sensible à la casse dans chaque entrée de n’importe quelle chaîne de texte correspondant à « erreur ».For other log formats, CMTrace does a case-insensitive search in each entry for any text string matching "error".

Il affiche les lignes avec des avertissements à l’aide d’un arrière-plan jaune.It displays lines with warnings using a yellow background. Dans les journaux au format CCM, les entrées du journal ont une valeur de type explicite qui indique l’entrée comme un avertissement.In CCM-format logs, log entries have an explicit type value that indicates the entry as a warning. Pour les autres formats de journaux, CMTrace effectue une recherche non sensible à la casse dans chaque entrée de n’importe quelle chaîne de texte correspondant à « avertissement ».For other log formats, CMTrace does a case-insensitive search in each entry for any text string matching "warn".

Volet d’informationsInfo pane

Le volet d’informations figure au bas de la fenêtre CMTrace.The Info pane is at the bottom of the CMTrace window. Ce pack offre les fonctionnalités suivantes :It includes the following features:

  • Détails sur l’entrée de journal actuellement sélectionnéeDetails about the currently selected log entry

  • Zone de texte qui affiche le texte du journalA text box that displays the log text

  • Affichage des retours chariot afin que le texte mis en forme soit plus facile à lireIt displays carriage returns so that formatted text is easier to read

  • Entrées longues plus faciles à lire et qui ne sont pas complètement visibles dans le volet de journalEasier to read long entries that aren't fully visible in the Log pane

Affichez ou masquez le volet d’informations avec l’option Show/Hide Info Pane dans le menu Tools.Show or hide the Info pane with the Show/Hide Info Pane option on the Tools menu. Si le volet d’informations occupe plus de la moitié de la fenêtre du journal, CMTrace le masque automatiquement.If the Info pane takes up more than half of the log window, CMTrace automatically hides it.

Barre de progressionProgress bar

Quand vous ouvrez un fichier journal pour la première fois, CMTrace remplace le volet d’informations par une barre de progression.When you first open a log file, CMTrace replaces the Info pane by a progress bar. Cette barre de progression indique la quantité de contenu du fichier existant qui est chargée.This progress indicates how much of the existing file contents it's loaded. Quand la progression atteint 100 pour cent, CMTrace supprime la barre de progression et la remplace par le volet d’informations.The progress reaches 100 percent, CMTrace removes the progress bar, and replaces it with the Info pane. Lorsque vous chargez des fichiers volumineux, ce comportement vous fournit une indication de la durée possible du chargement.When you load large files, this behavior provides you with an indication of how long the load might take.

Barre d’étatStatus bar

Pour les fichiers journaux au format Configuration Manager et CCM, la barre d’état affiche le temps écoulé pour les entrées de journal sélectionnées.For Configuration Manager-format and CCM-format log files, the status bar displays the elapsed time for the selected log entries. Si vous sélectionnez une seule entrée, l’outil affiche le temps écoulé entre la première entrée de journal et l’entrée sélectionnée.If you select a single entry, the tool displays the time from the first log entry to the selected entry. Si vous sélectionnez plusieurs entrées, il calcule le temps écoulé entre l’entrée sélectionnée la plus haute et l’entrée sélectionnée la plus basse.If you select multiple entries, it calculates the time from the top-most selected entry to the bottom-most selected entry. CMTrace met en forme ces informations comme suit :CMTrace formats this information as follows:

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

Intégration au shell WindowsWindows shell integration

CMTrace prend en charge les associations de fichiers et la fonction glisser-déplacer.CMTrace supports file associations and drag-and-drop.

Associations de fichiersFile associations

CMTrace peut s’associer aux extensions de nom de fichier .log et .lo_.CMTrace can associate itself with .log and .lo_ file name extensions. Quand le programme démarre, il vérifie le Registre pour déterminer s’il est déjà associé à ces extensions de nom de fichier.When the program starts, it checks the registry to determine whether it's already associated with these file name extensions. Si CMTrace n’est pas déjà associé à des extensions de nom de fichier, vous êtes invité à les associer à CMTrace.If CMTrace isn't already associated with any file name extensions, you're prompted to associate the file name extensions with CMTrace. Si vous sélectionnez Do not ask me this again, CMTrace ignore cette vérification chaque fois qu’il est exécuté sur cet ordinateur.If you select Do not ask me this again, CMTrace skips this check whenever it's run on this computer.

Glisser-déplacerDrag-and-drop

CMTrace prend en charge la fonctionnalité glisser-déplacer de base.CMTrace supports basic drag-and-drop functionality. Faites glisser un fichier journal à partir de l’Explorateur Windows dans CMTrace pour l’ouvrir.Drag a log file from Windows Explorer into CMTrace to open it.

Autres conseilsOther tips

Clé de Registre Last DirectoryLast Directory registry key

Par défaut, CMTrace enregistre le dernier emplacement de journal que vous avez ouvert.By default, CMTrace saves the last log location that you opened. Ce comportement est utile sur le serveur de site, car l’emplacement par défaut correspond chaque fois au chemin des journaux.This behavior is useful on the site server, as it defaults to the logs path every time.

La première fois que vous le lancez sur un client, l’emplacement par défaut correspond au répertoire de travail actuel.The first time you launch it on a client, it defaults to the current working directory. Cet emplacement peut être le chemin où vous avez enregistré CMTrace ou un chemin comme %userprofile%\Desktop.This location may be the path where you saved CMTrace, or a path like %userprofile%\Desktop.

La valeur Last Directory dans la clé de Registre HKEY_CURRENT_USER\Software\Microsoft\Trace32 contrôle cet emplacement par défaut.The Last Directory value in the registry key HKEY_CURRENT_USER\Software\Microsoft\Trace32 controls this default location. Si vous définissez cette valeur sur %windir%\CCM\Logs sur vos clients, CMTrace ouvre les fichiers à l’emplacement des journaux des clients lors de la première exécution.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.

Voir aussiSee also