CMTrace

S’applique à : Configuration Manager (branche actuelle)

CMTrace est l’un des outils de Configuration Manager. Il vous permet d’afficher et de surveiller les fichiers journaux, notamment les types suivants :

  • Fichiers journaux au format Configuration Manager ou Client Component Manager (CCM)

  • Fichiers texte simples ASCII ou Unicode, tels que les journaux de Windows Installer

Cet outil permet d’analyser les fichiers journaux en mettant en surbrillance, en filtrant et en recherchant les erreurs.

Remarque

CMTrace n’est pas automatiquement inscrit auprès de Windows pour ouvrir l’extension de fichier .log. Pour plus d’informations, voir Associations de fichiers.

La version 2107 de Configuration Manager inclut plusieurs améliorations des performances de la visionneuse de journaux CMTrace.

Emplacements

Configuration Manager installe automatiquement CMTrace aux emplacements suivants :

  • Répertoire des outils du serveur de site. Par exemple : cd.latest\SMSSETUP\Tools\CMTrace.exe
  • Répertoire d’installation du point de gestion. Par exemple : C:\SMS_CCM\CMTrace.exe
  • Répertoire d’installation du client. Par exemple : C:\Windows\CCM\CMTrace.exe
  • Images de démarrage du déploiement du système d’exploitation. Par exemple : X:\sms\bin\x64\CMTrace.exe

Si vous avez une copie de CMTrace dans un autre emplacement, envisagez de la supprimer et d’utiliser une copie dans l’un des chemins par défaut. S’il se trouve dans un emplacement personnalisé qui répond aux besoins de votre entreprise, assurez-vous que vous disposez d’un processus pour le maintenir à jour. Si votre emplacement personnalisé peut être utile à d’autres clients, envoyez vos commentaires sur le produit.

Pour plus d’informations, consultez Liens directs vers les éléments du hub de la communauté.

Utilisation

Exécuter CMTrace.exe. La première fois que vous exécutez l’outil, une invite s’affiche pour associer les fichiers. Pour plus d’informations, voir Associations de fichiers.

Vous effectuez la plupart des actions dans CMTrace à partir des menus suivants :

menu Fichier

Les actions suivantes sont disponibles dans le menu Fichier :

Le menu Fichier répertorie également les huit derniers fichiers récents. Rouvrez rapidement l’un de ces journaux en le sélectionnant dans le menu Fichier.

Ouvrir

Affiche la boîte de dialogue Ouvrir pour rechercher un fichier journal.

Filtrez l’affichage pour les fichiers des types suivants :

  • Fichiers journaux (*.log)
  • Anciens fichiers journaux (*.lo_)
  • Tous les fichiers (*.*)

Les deux options suivantes ne sont pas sélectionnées par défaut :

  • Ignorer les lignes existantes : lorsque cette option est sélectionnée, CMTrace ignore le contenu existant du fichier journal sélectionné et affiche les nouvelles lignes uniquement au fur et à mesure qu’elles sont ajoutées. Utilisez cette option pour surveiller uniquement les nouvelles actions lorsque vous n’avez pas besoin de l’historique complet du fichier journal.

  • Fusionner les fichiers sélectionnés : si vous activez cette option et sélectionnez plusieurs fichiers journaux, CMTrace fusionne les journaux sélectionnés dans la vue. Il les affiche comme s’il s’agissait d’un fichier journal unique. Le journal fusionné se met à jour de la même manière et prend en charge toutes les autres fonctionnalités de CMTrace comme s’il s’agissait d’un seul fichier journal.

Ouvrir sur le serveur

Parcourez le dossier des journaux du Configuration Manager sur un ordinateur de système de site avec la boîte de dialogue Parcourir standard. Vous pouvez également rechercher un ordinateur distant sur le réseau.

Lorsque vous sélectionnez un ordinateur distant à parcourir, CMTrace recherche le partage du Configuration Manager. S’il ne trouve pas de partage avec les fichiers journaux de Configuration Manager, il affiche un message d’erreur.

Pour vous connecter directement à un ordinateur connu sans parcourir, utilisez l’action Ouvrir . Entrez ensuite un nom de serveur et un partage en utilisant le format UNC.

Print

Afficher la boîte de dialogue d’impression standard de Windows. Cette action envoie le fichier journal actuel à une imprimante. Il formate la sortie en fonction des paramètres de l’onglet Impression des préférences de CMTrace.

Préférences

Configurez les paramètres de CMTrace. Les options suivantes sont disponibles :

  • Onglet Général

    • Intervalle de mise à jour : contrôle la fréquence à laquelle CMTrace vérifie les modifications apportées aux fichiers journaux et charge de nouvelles lignes. Par défaut, cette valeur est de 500 millisecondes.

    • Mettre en surbrillance : définit la couleur que CMTrace utilise pour mettre en surbrillance les lignes de journal que vous choisissez. Par défaut, cette couleur est le jaune de base (Rouge : 255, Vert : 255, Bleu : 0).

    • Colonnes : configure les colonnes visibles dans la vue du journal et l’ordre dans lequel elles apparaissent. Par défaut, il affiche le texte du journal, le composant, la date/heure et le thread.

  • Onglet Impression

    • Colonnes : configurez les colonnes utilisées lors de l’impression des fichiers journaux et l’ordre dans lequel elles apparaissent. Par défaut, affiche les mêmes colonnes qu’affichées.

    • Orientation : définit l’orientation d’impression par défaut lors de l’impression des fichiers journaux. Remplacez ce paramètre dans la boîte de dialogue Imprimer. Par défaut, l’orientation portrait est activée.

  • Onglet Options avancées

    • Intervalle d’actualisation : force CMTrace à mettre à jour l’affichage du journal à un intervalle spécifié lors du chargement d’un grand nombre de lignes. Par défaut, cette option est désactivée avec la valeur zéro.

      Remarque

      En règle générale, ne modifiez pas l’intervalle d’actualisation. Cela peut considérablement augmenter le temps nécessaire à l’ouverture des fichiers journaux volumineux.

Menu Outils

Les actions suivantes sont disponibles dans le menu Outils :

Rechercher

Recherchez une chaîne de texte spécifiée dans le fichier journal ouvert.

Suivant

Recherche la chaîne correspondante suivante, comme vous l’avez spécifié précédemment dans la boîte de dialogue Rechercher.

Copier dans le Presse-papiers

Copie les lignes sélectionnées sous forme de texte brut dans le Presse-papiers Windows. Si vous examinez les fichiers journaux de Configuration Manager et CCM, il copie les colonnes dans le même ordre que la vue. Elle sépare chaque colonne par un caractère de tabulation. Utilisez cette action lors de la copie des journaux dans des messages électroniques ou d’autres documents.

Highlight

Entrez une chaîne que CMTrace utilise pour rechercher le texte de chaque entrée de journal. Il met ensuite en surbrillance tout texte de journal qui correspond à la chaîne que vous entrez.

  • La surbrillance utilise la couleur que vous avez spécifiée dans Préférences.

  • Pour désactiver la mise en surbrillance, effacez la chaîne de ce champ.

  • Si vous entrez un nombre décimal ou hexadécimal, CMTrace essaie de faire correspondre la valeur à la colonne Thread. Utilisez ce comportement pour mettre en surbrillance le traitement d’un seul thread, sans filtrer les autres threads susceptibles d’interagir avec celui-ci.

  • Pour comparer les chaînes par casse, activez l’option sensible à la casse.

Filter

Afficher ou masquer les lignes de journal en fonction des critères spécifiés. Appliquez des filtres à l’une des quatre colonnes, qu’elles soient visibles ou non. Ces paramètres s’appliquent à chaque fichier journal ouvert.

Exemples :

  • Filtrez smsts.log sur le texte de saisie contenant « l’action » ou « le groupe ».
  • Filtrer InventoryAgent.log où le texte d’entrée contient « destination ».

Recherche d’erreurs

Tapez ou collez un code d’erreur au format décimal ou hexadécimal pour afficher une description. Les sources d’erreur possibles sont les suivantes : Windows, WMI ou Winhttp.

Pause

Suspendez ou redémarrez la surveillance des journaux. Les cas d’utilisation suivants sont quelques-unes des raisons possibles d’utiliser cette action :

  • Lorsque CMTrace affiche trop rapidement les informations du fichier journal

  • Lorsque vous suspendez la surveillance des journaux, les informations affichées par CMTrace ne sont pas perdues si le fichier actuel est substitué à un nouveau journal

  • Lorsque vous souhaitez empêcher CMTrace d’afficher de nouvelles données pendant que vous examinez le fichier journal

Afficher/masquer les détails

Afficher ou masquer toutes les colonnes autres que le texte du journal. Elle étend également la colonne de texte du journal à la largeur de la fenêtre. Utilisez cette action lorsque vous affichez les journaux sur un ordinateur avec une résolution d’affichage faible. Il affiche une plus grande partie du texte du journal.

Remarque

Lors de l’affichage de fichiers en texte brut, CMTrace masque automatiquement les détails, car ils sont toujours vides.

Afficher/masquer le volet d’informations

Afficher ou masquer le volet Infos. Utilisez cette action lorsque vous affichez les journaux sur un ordinateur avec une résolution d’affichage faible. Il affiche d’autres détails sur la journalisation.

Volet du journal

Le volet du journal se trouve en haut de la fenêtre CMTrace. Il affiche les lignes des fichiers journaux.

Lorsque vous sélectionnez une ligne, elle est temporairement mise en surbrillance à l’aide du modèle de couleurs de sélection de Windows.

Les traits mis en surbrillance correspondent aux critères que vous définissez avec l’option Surligner du menu Outils . La surbrillance utilise la couleur que vous spécifiez dans les Préférences.

CMTrace affiche les lignes avec des erreurs à l’aide d’un arrière-plan rouge et d’une couleur de texte jaune. Dans les journaux au format CCM, les entrées de journal ont une valeur de type explicite qui indique l’entrée comme une erreur. Pour les autres formats de journal, CMTrace effectue une recherche insensible à la casse dans chaque entrée pour toute chaîne de texte correspondant à « error ».

Il affiche les lignes avec des avertissements sur fond jaune. Dans les journaux au format CCM, les entrées de journal ont une valeur de type explicite qui indique l’entrée comme un avertissement. Pour les autres formats de journal, CMTrace effectue une recherche insensible à la casse dans chaque entrée pour toute chaîne de texte correspondant à « warn ».

Volet d’informations

Le volet d’informations se trouve en bas de la fenêtre CMTrace. Il comprend les fonctionnalités suivantes :

  • Détails sur l’entrée de journal actuellement sélectionnée

  • Zone de texte qui affiche le texte du journal

  • Elle affiche des retours chariot afin de faciliter la lecture du texte mis en forme

  • Lecture simplifiée des entrées longues qui ne sont pas entièrement visibles dans le volet Journal

Afficher ou masquer le volet Informations avec l’option Afficher/Masquer le volet Informations du menu Outils . Si le volet Informations occupe plus de la moitié de la fenêtre de journal, CMTrace le masque automatiquement.

Barre de progression

Lorsque vous ouvrez un fichier journal pour la première fois, CMTrace remplace le volet Informations par une barre de progression. Cette progression indique la quantité de contenu du fichier existant chargée. La progression atteint 100 %, CMTrace supprime la barre de progression et la remplace par le volet d’informations. Lorsque vous chargez des fichiers volumineux, ce comportement vous donne une indication de la durée du chargement.

Barre d’état

Pour les fichiers journaux au format Configuration Manager et CCM, la barre d’status affiche le temps écoulé pour les entrées de journal sélectionnées. Si vous sélectionnez une seule entrée, l’outil affiche l’heure entre la première entrée de journal et l’entrée sélectionnée. Si vous sélectionnez plusieurs entrées, le temps écoulé entre l’entrée la plus haute sélectionnée et l’entrée la plus basse sélectionnée. CMTrace met en forme ces informations comme suit :

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

Intégration de l’interpréteur de commandes Windows

CMTrace prend en charge les associations de fichiers et le glisser-déposer.

Associations de fichiers

CMTrace peut s’associer à .log et .lo_ extensions de nom de fichier. Lorsque le programme démarre, il vérifie le registre pour déterminer s’il est déjà associé à ces extensions de nom de fichier. Si CMTrace n’est pas déjà associé à des extensions de nom de fichier, vous êtes invité à associer les extensions de nom de fichier à CMTrace. Si vous sélectionnez Ne plus me poser cette question, CMTrace ignore cette case activée chaque fois qu’elle est exécutée sur cet ordinateur.

Glisser-déplacer

CMTrace prend en charge la fonctionnalité de glisser-déposer de base. Faites glisser un fichier journal de l’Explorer Windows vers CMTrace pour l’ouvrir.

Autres conseils

Clé de Registre Last Directory

Par défaut, CMTrace enregistre le dernier emplacement de journal que vous avez ouvert. Ce comportement est utile sur le serveur du site, car il utilise par défaut à chaque fois le chemin d’accès des journaux.

La première fois que vous le lancez sur un client, il utilise par défaut le répertoire de travail actuel. Cet emplacement peut être le chemin où vous avez enregistré CMTrace, ou un chemin comme %userprofile%\Desktop.

La valeur Last Directory dans la clé HKEY_CURRENT_USER\Software\Microsoft\Trace32 de Registre contrôle cet emplacement par défaut. Si vous définissez cette valeur sur %windir%\CCM\Logs vos clients, CMTrace ouvre les fichiers dans l’emplacement du journal client la première fois que vous l’exécutez.

Étapes suivantes

OneTrace est la visionneuse de journaux avec le Centre de support. Il fonctionne de la même manière que CMTrace, avec des améliorations. Pour plus d’informations, voir Centre d’assistance OneTrace.

  • Last updated on