À propos des fichiers journaux dans Configuration Manager

  • Article

S’applique à : Gestionnaire de Configuration (branche actuelle)

Dans Configuration Manager, les composants client et serveur de site enregistrent les informations de processus dans des fichiers journaux individuels. Vous pouvez utiliser les informations contenues dans ces fichiers journaux pour vous aider à résoudre les problèmes qui peuvent se produire. Par défaut, Configuration Manager active la journalisation pour les composants client et serveur.

Cet article fournit des informations générales sur les fichiers journaux Configuration Manager. Il inclut des outils à utiliser, comment configurer les journaux et où les trouver. Pour plus d’informations sur des fichiers journaux spécifiques, consultez Informations de référence sur les fichiers journaux.

Mode de fonctionnement

La plupart des processus dans Configuration Manager écrire des informations opérationnelles dans un fichier journal dédié à ce processus. Les fichiers journaux sont identifiés par .log les extensions de fichier ou .lo_ . Configuration Manager écrit dans un .log fichier jusqu’à ce que ce journal atteigne sa taille maximale. Lorsque le journal est plein, le .log fichier est copié dans un fichier du même nom, mais avec l’extension .lo_ , et le processus ou le composant continue d’écrire dans le .log fichier. Lorsque le .log fichier atteint à nouveau sa taille maximale, le .lo_ fichier est remplacé et le processus se répète. Certains composants établissent un historique de fichier journal en ajoutant une date et une heure au nom du fichier journal et en conservant l’extension .log .

Outils de visionneuse de journaux

Tous les fichiers journaux Configuration Manager sont en texte brut. Vous pouvez donc les afficher avec n’importe quel lecteur de texte tel que le Bloc-notes. Les journaux utilisent une mise en forme unique qui est mieux visible avec l’un des outils spécialisés suivants :

CMTrace

Pour afficher les journaux, utilisez l’outil de visionneuse de journaux Configuration Manager CMTrace. Il se trouve dans le \SMSSetup\Tools dossier du média source Configuration Manager. L’outil CMTrace est ajouté à toutes les images de démarrage ajoutées à la bibliothèque de logiciels. L’outil d’affichage des journaux CMTrace est automatiquement installé avec le client Configuration Manager. Pour plus d’informations, consultez CMTrace.

OneTrace

OneTrace est une visionneuse de journaux 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.

Visionneuse du fichier journal du Centre d’aide et de support

Le Centre d’aide et de support comprend une visionneuse de journaux moderne. Cet outil remplace CMTrace et fournit une interface personnalisable avec prise en charge des onglets et des fenêtres ancreables. Il dispose d’une couche de présentation rapide et peut charger des fichiers journaux volumineux en quelques secondes. Pour plus d’informations, consultez Visionneuse du fichier journal du Centre d’aide et de support.

Remarque

La visionneuse du fichier journal du Centre d’aide et OneTrace utilisent Windows Presentation Foundation (WPF). Ce composant n’est pas disponible dans Windows PE. Continuez à utiliser CMTrace dans les images de démarrage avec des déploiements de séquence de tâches.

Configurer les options de journalisation

Vous pouvez modifier la configuration des fichiers journaux, comme le niveau détaillé, la taille et l’historique. Il existe plusieurs façons de modifier ces paramètres :

Vous pouvez également utiliser l’inventaire matériel pour collecter les paramètres de journal auprès des clients.

Configurer les options de journalisation pendant l’installation du client

Vous pouvez définir la configuration des fichiers journaux du client pendant l’installation. Utilisez les propriétés suivantes :

  • CCMENABLELOGGING
  • CCMDEBUGLOGGING
  • CCMLOGLEVEL
  • CCMLOGMAXHISTORY
  • CCMLOGMAXSIZE

Pour plus d’informations, consultez Propriétés d’installation du client.

Configurer les options de journalisation à l’aide de Configuration Manager Service Manager

Vous pouvez modifier l’emplacement où Configuration Manager stocke les fichiers journaux et leur taille.

Pour modifier la taille des fichiers journaux, modifier le nom et l’emplacement du fichier journal ou forcer plusieurs composants à écrire dans un seul fichier journal, procédez comme suit :

Modifier la journalisation d’un composant

  1. Dans la console Configuration Manager, accédez à l’espace de travail Surveillance, développez État du système, puis sélectionnez le nœud État du site ou État du composant.

  2. Dans le ruban, sélectionnez Démarrer, puis Configuration Manager Service Manager.

  3. Lorsque Configuration Manager Service Manager s’ouvre, connectez-vous au site que vous souhaitez gérer. Si le site que vous souhaitez gérer n’est pas affiché, sélectionnez Site, Se connecter, puis entrez le nom du serveur de site pour le site approprié.

  4. Développez le site et accédez à Composants ou Serveurs, en fonction de l’emplacement des composants que vous souhaitez gérer.

  5. Dans le volet droit, sélectionnez un ou plusieurs composants.

  6. Dans le menu Composant , sélectionnez Journalisation.

  7. Dans la boîte de dialogue Journalisation des composants Configuration Manager, renseignez les options de configuration disponibles pour votre sélection.

  8. Sélectionnez OK pour enregistrer la configuration.

Configurer les options de journalisation à l’aide du Registre Windows

Utilisez le Registre Windows sur les serveurs ou les clients pour modifier les options de journalisation suivantes :

  • Niveau détaillé
  • Historique maximal
  • Taille maximale

Lors de la résolution d’un problème, vous pouvez activer la journalisation détaillée pour Configuration Manager d’écrire des détails supplémentaires dans les fichiers journaux.

Avertissement

Une configuration incorrecte de ces paramètres peut entraîner Configuration Manager journaliser de grandes quantités d’informations, voire aucune. Bien que ces données puissent être utiles pour la résolution des problèmes, soyez prudent lorsque vous modifiez ces valeurs dans les sites de production. Testez toujours d’abord ces modifications dans un environnement lab. Une journalisation excessive peut se produire, ce qui peut rendre difficile la recherche d’informations pertinentes dans les fichiers journaux.

Après avoir apporté des modifications à ces paramètres de Registre, redémarrez le composant :

  • Si vous modifiez les paramètres du client, redémarrez le service Hôte de l’agent SMS (CcmExec).
  • Si vous modifiez les paramètres du serveur, redémarrez le service SMS Executive .

Les paramètres du Registre varient en fonction du composant :

Options de journalisation des clients et des points de gestion

Pour configurer les options de journalisation pour tous les composants d’un système de site client ou de point de gestion, configurez ces valeurs REG_DWORD sous la clé de Registre Windows suivante :

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global

Nom Valeurs Description
Loglevel 0:Verbose
1:Par défaut
2: avertissements et erreurs
3: erreurs uniquement		 Niveau de détail à écrire dans les fichiers journaux.
LogMaxHistory Tout entier supérieur ou égal à zéro, par exemple :
0: Aucun historique
1:Par défaut		 Lorsqu’un fichier journal atteint la taille maximale, le client le renomme en tant que sauvegarde et crée un fichier journal. Spécifiez le nombre de versions précédentes à conserver.
LogMaxSize Tout entier supérieur ou égal à 10 000, par exemple :
250000		 Taille maximale du fichier journal en octets. Lorsqu’un journal atteint la taille spécifiée, le client le renomme en fichier d’historique et crée un fichier. La valeur par défaut est 250 000 octets.

Remarque

Ne modifiez pas les autres valeurs qui peuvent exister dans cette clé de Registre.

Pour le débogage avancé, vous pouvez également ajouter cette valeur REG_SZ sous la clé de Registre Windows suivante :

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging

Nom Valeurs Description
Activé True: activer les journaux de débogage
False: désactiver les journaux de débogage		 Active la journalisation de débogage à des fins de résolution des problèmes.

Ce paramètre oblige le client à journaliser les informations de bas niveau à des fins de résolution des problèmes. Évitez d’utiliser ce paramètre dans les sites de production. Une journalisation excessive peut se produire, ce qui peut rendre difficile la recherche d’informations pertinentes dans les fichiers journaux. Veillez à désactiver ce paramètre après avoir résolu le problème.

Options de journalisation du serveur de site

Vous pouvez configurer les paramètres globalement ou pour un composant spécifique sur le serveur de site Configuration Manager.

Configurez ces valeurs sous la clé de Registre Windows suivante :

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing

Nom Valeurs Type Description
SqlEnabled 1: activer le suivi SQL Server
0: désactiver le suivi SQL Server		 REG_DWORD Ajoutez SQL Server journalisation de trace à tous les journaux d’activité du serveur de site.
ArchiveEnabled 1: activer les archives des journaux
0: désactiver les archives des journaux		 REG_DWORD Archivez les journaux du serveur de site dans un emplacement distinct pour la préservation de l’historique.
ArchivePath Un chemin d’accès de dossier valide, par exemple C:\Logs\Archive REG_SZ Chemin d’accès pour archiver les journaux du serveur de site.

Activez uniquement le suivi SQL Server à des fins de résolution des problèmes. Évitez de l’utiliser sur les sites de production. Une journalisation excessive peut se produire, ce qui peut rendre difficile la recherche d’informations pertinentes dans les fichiers journaux. Veillez à désactiver ce paramètre après avoir résolu le problème.

Remarque

Ne modifiez pas les autres valeurs qui peuvent exister dans cette clé de Registre.

Pour configurer les options de journalisation d’un composant serveur spécifique, configurez ces valeurs REG_DWORD sous la clé de Registre Windows suivante :

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing\<ComponentName>

Nom Valeurs Description
LoggingLevel 0:Verbose
1:Par défaut
2: avertissements et erreurs
3: erreurs uniquement		 Niveau de détail à écrire dans les fichiers journaux.
LogMaxHistory Tout entier supérieur ou égal à zéro, par exemple :
0: Aucun historique
1:Par défaut		 Lorsqu’un fichier journal atteint la taille maximale, le serveur le renomme en tant que sauvegarde et crée un fichier journal. Spécifiez le nombre de versions précédentes à conserver.
MaxFileSize Tout entier supérieur ou égal à 10 000, par exemple :
250000		 Taille maximale du fichier journal en octets. Lorsqu’un journal atteint la taille spécifiée, le client le renomme en fichier d’historique et crée un fichier. La valeur par défaut est 250 000 octets.
DebugLogging 1: activer les journaux de débogage
0: désactiver les journaux de débogage		 Active la journalisation de débogage à des fins de résolution des problèmes.

Le paramètre DebugLogging oblige le serveur à journaliser des informations de bas niveau pour la résolution des problèmes. Évitez d’utiliser ce paramètre dans les sites de production. Une journalisation excessive peut se produire, ce qui peut rendre difficile la recherche d’informations pertinentes dans les fichiers journaux. Veillez à désactiver ce paramètre après avoir résolu le problème.

Remarque

Ne modifiez pas les autres valeurs qui peuvent exister dans cette clé de Registre.

Options de journalisation des rôles de système de site

Vous pouvez configurer les paramètres globalement ou pour un composant spécifique sur un système de site qui héberge un rôle serveur Configuration Manager.

Pour configurer les options de journalisation d’un composant serveur spécifique, configurez ces valeurs REG_DWORD sous la clé de Registre Windows suivante :

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\<ComponentName>\Logging

Par exemple, pour le rôle de point de distribution :

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging

Nom Valeurs Description
Loglevel 0:Verbose
1:Par défaut
2: avertissements et erreurs
3: erreurs uniquement		 Niveau de détail à écrire dans les fichiers journaux.
LogMaxHistory Tout entier supérieur ou égal à zéro, par exemple :
0: Aucun historique
1:Par défaut		 Lorsqu’un fichier journal atteint la taille maximale, le serveur le renomme en tant que sauvegarde et crée un fichier journal. Spécifiez le nombre de versions précédentes à conserver.
LogMaxSize Tout entier supérieur ou égal à 10 000, par exemple :
250000		 Taille maximale du fichier journal en octets. Lorsqu’un journal atteint la taille spécifiée, le serveur le renomme en fichier d’historique et crée un fichier. La valeur par défaut est 250 000 octets.

Remarque

Ne modifiez pas les autres valeurs qui peuvent exister dans cette clé de Registre.

Configuration Manager options de journalisation de la console

Pour modifier le niveau détaillé de AdminUI.log pour la console Configuration Manager, procédez comme suit :

  1. Ouvrez le fichier de configuration de console,Microsoft.ConfigurationManagement.exe.config, dans un éditeur XML tel que le Bloc-notes. Le fichier de configuration par défaut se trouve à l’emplacement suivant : C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. Sous l’élémentsource dessources>system.diagnostics>, remplacez l’attribut switchValue par ErrorVerbose. Par exemple :

    Original : <source name="SmsAdminUISnapIn" switchValue="Error"> Nouveau : <source name="SmsAdminUISnapIn" switchValue="Verbose" >

  3. Enregistrez le fichier et redémarrez la console.

Configurer les options de journalisation dans la console Configuration Manager

Activez ou désactivez la journalisation détaillée sur un client ou un regroupement à partir de la console :

  1. Dans la console Configuration Manager, accédez à l’espace de travail Ressources et conformité, sélectionnez le nœud Appareils, puis choisissez un appareil cible.

  2. Dans le ruban, sous l’onglet Accueil , dans le groupe Appareil , sélectionnez Diagnostics du client. Choisissez l’une des actions disponibles.

Pour plus d’informations, consultez Diagnostics client.

Inventaire matériel pour les paramètres du journal client

À compter de la version 2107, vous pouvez activer l’inventaire matériel pour collecter les paramètres du fichier journal client. Activez la classe d’inventaire matériel, Diagnostics du client (CCM_ClientDiagnostics), puis sélectionnez les attributs suivants :

  • Journalisation du débogage activée
  • Journalisation activée
  • Niveau de journalisation
  • Nombre de fichiers d’historique
  • Taille maximale du fichier journal

Remarque

Cette classe d’inventaire n’est pas activée par défaut.

Pour plus d’informations, consultez Activer ou désactiver des classes d’inventaire matériel existantes.

Localisation des fichiers journaux

Configuration Manager et les composants dépendants stockent les fichiers journaux à différents emplacements. Ces emplacements dépendent du processus qui crée le fichier journal et de la configuration de votre environnement.

Les emplacements suivants sont les valeurs par défaut. Si vous avez personnalisé les répertoires d’installation dans votre environnement, les chemins d’accès réels peuvent varier.

  • Client: C:\Windows\CCM\logs
  • Serveur: C:\Program Files\Microsoft Configuration Manager\Logs
  • Point de gestion : C:\SMS_CCM\Logs
  • console Configuration Manager :C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\AdminUILog
  • IIS: C:\inetpub\logs\logfiles\w3svc1

Emplacements du journal de séquence de tâches

L’emplacement du fichier journal de séquence de tâches smsts.log varie en fonction de la phase de la séquence de tâches :

  • Dans Windows PE avant l’étape Formater et partitionner le disque : X:\Windows\temp\smstslog\smsts.log (X est le lecteur de RAM Windows PE)
  • Dans Windows PE après l’étape Formater et partitionner le disque : X:\smstslog\smsts.log, puis copié dans C:\_SMSTaskSequence\Logs\smstslog\smsts.log lorsque le lecteur est prêt
  • Dans le nouveau système d’exploitation Windows avant l’installation du client : C:\_SMSTaskSequence\Logs\smstslog\smsts.log
  • Dans Windows après l’installation du client : C:\Windows\CCM\Logs\smstslog\smsts.log
  • Dans Windows, une fois la séquence de tâches terminée : C:\Windows\CCM\Logs\smsts.log

Conseil

La variable de séquence de tâches en lecture seule _SMSTSLogPath contient toujours le chemin du fichier journal actuel.

Prochaines étapes