CMTrace

  • Article

S’applique à : Configuration Manager (branche actuelle)

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

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

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

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

Remarque

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

Configuration Manager version 2107 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 d’accès par défaut. S’il se trouve dans un emplacement personnalisé qui répond aux besoins de votre entreprise, vérifiez que vous disposez d’un processus pour le maintenir à jour. Si votre emplacement personnalisé peut être avantageux pour d’autres clients, faites part de vos commentaires sur le produit.

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

Utilisation

Exécutez CMTrace.exe. La première fois que vous exécutez l’outil, une invite d’association de fichiers s’affiche. Pour plus d’informations, consultez 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 la vue 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 : lorsqu’elle est sélectionnée, CMTrace ignore le contenu existant du fichier journal sélectionné et affiche les nouvelles lignes uniquement lorsqu’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’agit d’un seul fichier journal. Le journal fusionné est mis à jour de la même façon et prend en charge toutes les autres fonctionnalités CMTrace comme s’il s’agit d’un seul fichier journal.

Ouvrir sur le serveur

Parcourez le dossier Configuration Manager journaux sur un ordinateur de système de site à l’aide de la boîte de dialogue Parcourir standard. Vous pouvez également parcourir le réseau pour un ordinateur distant.

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

Pour vous connecter directement à un ordinateur connu sans naviguer, utilisez l’action Ouvrir . Entrez ensuite un nom de serveur et partagez-le au format UNC.

Imprimer

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

Préférences

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

  • Onglet Général

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

    • Surbrillance : définit la couleur utilisée par CMTrace lors de la mise en surbrillance des lignes de journal que vous choisissez. Par défaut, cette couleur est de base jaune (rouge : 255, vert : 255, bleu : 0).

    • Colonnes : configure les colonnes qui sont visibles dans la vue de 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 qu’il utilise lors de l’impression des fichiers journaux et l’ordre dans lequel ils apparaissent. Par défaut, il imprime les mêmes colonnes qu’il affiche.

    • 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, il utilise l’orientation Portrait.

  • Onglet Avancé

    • Intervalle d’actualisation : force CMTrace à mettre à jour la vue de 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 général, ne modifiez pas l’intervalle d’actualisation. Cela peut augmenter considérablement le temps nécessaire à l’ouverture de fichiers journaux volumineux.

Menu Outils

Les actions suivantes sont disponibles dans le menu Outils :

Trouver

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 Configuration Manager et CCM, les colonnes sont copiées dans le même ordre que la vue. Il sépare chaque colonne par un caractère de tabulation. Utilisez cette action lors de la copie de 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 mise en 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 tente de faire correspondre la valeur à la colonne Thread. Utilisez ce comportement pour mettre en évidence le traitement d’un seul thread, sans filtrer les autres threads susceptibles d’interagir avec celui-ci.

  • Pour comparer des chaînes par casse, activez l’option respectant la casse.

Filtre

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 d’entrée contenant « l’action » ou « le groupe ».
  • Filtrez InventoryAgent.log où le texte de l’entrée contient « destination ».

Recherche d’erreur

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

Interruption

Suspendez ou redémarrez la surveillance des journaux. Les cas d’usage 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 roulé vers 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. Il développe également la colonne de texte du journal à la largeur de la fenêtre. Utilisez cette action lorsque vous affichez des journaux sur un ordinateur avec une résolution d’affichage faible. Il affiche davantage de texte du journal.

Remarque

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

Afficher/masquer le volet d’informations

Afficher ou masquer le volet Informations. Utilisez cette action lorsque vous affichez des journaux sur un ordinateur avec une résolution d’affichage faible. Il affiche plus de détails de journalisation.

Volet Journal

Le volet 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 jeu de couleurs de sélection Windows.

Les lignes en surbrillance correspondent aux critères que vous définissez avec l’option Surbrillance dans le menu Outils . La mise en surbrillance utilise la couleur que vous spécifiez dans Préférences.

CMTrace affiche les lignes avec des erreurs en utilisant un arrière-plan rouge et 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 sans respect de la casse dans chaque entrée pour rechercher toute chaîne de texte correspondant à « error ».

Il affiche des lignes avec des avertissements à l’aide d’un arrière-plan jaune. Dans les journaux au format CCM, les entrées de journal ont une valeur de type explicite qui indique l’entrée sous forme d’avertissement. Pour les autres formats de journal, CMTrace effectue une recherche non sensible à la casse dans chaque entrée pour toutes les chaînes de texte correspondant à « warn ».

Volet d’informations

Le volet Informations se trouve en bas de la fenêtre CMTrace. Il inclut 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

  • Il affiche les retours chariot afin que le texte mis en forme soit plus facile à lire

  • Entrées longues plus faciles à lire qui ne sont pas entièrement visibles dans le volet Journal

Affichez ou masquez le volet Informations avec l’option Afficher/Masquer le volet d’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é du contenu du fichier existant chargé. La progression atteint 100 pour cent, CMTrace supprime la barre de progression et la remplace par le volet 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 au format CCM, la barre de 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, il calcule le temps entre l’entrée la plus sélectionnée en haut et l’entrée la plus sélectionnée en bas. 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éplacer.

Associations de fichiers

CMTrace peut s’associer à des extensions de nom de fichier .log et .lo_. 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 déjà associé à aucune extension de nom de fichier, vous êtes invité à associer les extensions de nom de fichier à CMTrace. Si vous sélectionnez Ne plus me demander cela, CMTrace ignore cette case activée chaque fois qu’il est exécuté sur cet ordinateur.

Glisser-déplacer

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

Autres conseils

Dernière clé de Registre d’annuaire

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

La première fois que vous le lancez sur un client, il est défini par défaut sur le répertoire de travail actif. Cet emplacement peut être le chemin d’accès où vous avez enregistré CMTrace, ou un chemin d’accès 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 %windir%\CCM\Logs sur sur vos clients, CMTrace ouvre les fichiers à l’emplacement du journal client la première fois que vous l’exécutez.

Étapes suivantes

OneTrace est la visionneuse du journal avec le Centre d’aide et de support. Il fonctionne de la même façon que CMTrace, avec des améliorations. Pour plus d’informations, consultez Centre d’aide et de support OneTrace.