À propos des fichiers journaux dans Configuration Manager

• 11/29/2019
• 10 minutes de lecture
• • a
  • d

S’applique à : Configuration Manager (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 pourraient survenir. 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 de Configuration Manager. Il comprend les outils à utiliser, la façon de configurer les journaux et l’endroit où les trouver. Pour plus d’informations sur des fichiers journaux spécifiques, voir Référence des fichiers journaux.

Comment ça marche

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

Outils de visualisation des journaux

Tous les fichiers journaux de Configuration Manager sont en texte brut, vous pouvez donc les visualiser avec n’importe quel lecteur de texte comme le Bloc-notes. Les journaux utilisent un formatage unique qu’il est préférable de visualiser avec l’un des outils spécialisés suivants :

• CMTrace
• OneTrace
• Viseur de journaux du centre de support

CMTrace

Pour visualiser les journaux, utilisez l’outil de visualisation des journaux de Configuration Manager, CMTrace. Il est situé dans le dossier \SMSSetup\Tools du support source de Configuration Manager. L’outil CMTrace est ajouté à toutes les images de démarrage qui sont ajoutées à la bibliothèque de logiciels. L’outil de visualisation des journaux CMTrace est automatiquement installé avec le client Configuration Manager. Pour plus d’informations, voir CMTrace.

OneTrace

À partir de la version 1906, OneTrace est un nouvel outil de visualisation des journaux avec Support Center. Il fonctionne de manière similaire à CMTrace, avec des améliorations. Pour plus d’informations, voir Centre de support OneTrace.

Viseur de journaux du Centre de support

Le Centre de support comprend un visualiseur de journaux moderne. Cet outil remplace CMTrace et offre une interface personnalisable avec prise en charge des onglets et des fenêtres ancrables. Il dispose d’une couche de présentation rapide et peut charger des fichiers journaux volumineux en quelques secondes. Pour plus d’informations, consultez la référence du visualiseur de journaux du Centre de support.

Configurer les options de journalisation

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

• Pendant l’installation du client
• À l’aide du gestionnaire de service du gestionnaire de configuration
• À l’aide du registre Windows
• Dans la console du gestionnaire de configuration

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, voir Propriétés d’installation du client.

Configurer les options de journalisation en utilisant le gestionnaire de services Configuration Manager

Vous pouvez modifier l’endroit où Configuration Manager stocke les fichiers journaux, ainsi que leur taille.

Pour modifier la taille des fichiers journaux, changer 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 pour 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 sélectionnez Configuration Manager Service Manager.

3. Lorsque Configuration Manager Service Manager s’ouvre, connectez-vous au site que vous voulez gérer. Si le site que vous voulez gérer n’est pas affiché, sélectionnez Site, sélectionnez Connecter, puis entrez le nom du serveur du site correct.

4. Développez le site et allez dans Composants ou Serveurs, selon l’emplacement des composants que vous voulez gérer.

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

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

7. Dans la boîte de dialogue Consignation du composant du gestionnaire de configuration, complétez les options de configuration disponibles pour votre sélection.

8. Sélectionnez OK pour enregistrer la configuration.

Configurer les options de journalisation en utilisant le registre Windows

Utiliser le registre Windows sur les serveurs ou les clients pour modifier les options de journalisation suivantes :

• Niveau Verbose
• Historique maximum
• Taille maximum

Lors du dépannage d’un problème, vous pouvez activer la journalisation verbeuse pour que Configuration Manager écrive des détails supplémentaires 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 exécutif SMS.

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

• Client et point de gestion
• Serveur de site
• Rôle du système de site
• Console du gestionnaire de configuration

Options de journalisation du client et du point de gestion

Pour configurer les options de journalisation pour tous les composants sur un système de site client ou 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 : Défaut 2 : Avertissements et erreurs 3 : Erreurs seulement	Le niveau de détail à écrire dans les fichiers journaux.
LogMaxHistory	Tout nombre entier supérieur ou égal à zéro, par exemple: 0 : Pas d’historique 1 : Défaut	Lorsqu’un fichier journal atteint la taille maximale, le client le renomme en tant que sauvegarde et crée un nouveau fichier journal. Spécifiez le nombre de versions précédentes à conserver.
LogMaxSize	Tout nombre entier supérieur ou égal à 10 000, par exemple : 250000	La taille maximale du fichier journal en octets. Lorsqu’un journal atteint la taille spécifiée, le client le renomme en fichier historique et crée un nouveau fichier. La valeur par défaut est de 250 000 octets.

Pour un 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
Enabled	True : activer les journaux de débogage False : désactiver les journaux de débogage	Active la journalisation de débogage à des fins de dépannage.

Ce paramètre amène le client à consigner des informations de bas niveau pour le dépannage. Évitez d’utiliser ce paramètre dans les sites de production. Une journalisation excessive peut se produire, ce qui pourrait 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 traçage du serveur SQL 0 : désactiver le traçage du serveur SQL	REG_DWORD	Ajouter la journalisation du traçage du serveur SQL à tous les journaux du serveur du site.
ArchiveEnabled	1 : activer l’archivage des journaux 0 : désactiver l’archivage des journaux	REG_DWORD	Archiver les journaux du serveur du site à un emplacement séparé pour une conservation historique.
ArchivePath	Un chemin de dossier valide, par exemple C:\Logs\Archive	REG_SZ	Le chemin pour archiver les journaux du serveur de site.

Activer uniquement le traçage du serveur SQL à des fins de dépannage. Évitez de l’utiliser dans les sites de production. Une journalisation excessive peut se produire, ce qui pourrait rendre difficile la recherche d’informations pertinentes dans les fichiers journaux. Assurez-vous de désactiver ce paramètre après avoir résolu le problème.

Pour configurer les options de journalisation pour un composant de 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
Niveau de journalisation	0 : Verbose 1 : Par défaut 2 : Avertissements et erreurs 3 : Erreurs seulement	Le niveau de détail à écrire dans les fichiers journaux.
LogMaxHistory	Tout nombre entier supérieur ou égal à zéro, par exemple: 0 : Pas d’historique 1 : Défaut	Lorsqu’un fichier journal atteint la taille maximale, le serveur le renomme en tant que sauvegarde et crée un nouveau fichier journal. Spécifiez le nombre de versions précédentes à conserver.
MaxFileSize	Tout nombre entier supérieur ou égal à 10 000, par exemple : 250000	La taille maximale du fichier journal en octets. Lorsqu’un journal atteint la taille spécifiée, le client le renomme en fichier historique et crée un nouveau fichier. La valeur par défaut est de 250 000 octets.
DebugLogging	1 : enable debug logs 0 : disable debug logs	Active la journalisation de débogage à des fins de dépannage.

Le paramètre DebugLogging amène le serveur à consigner des informations de bas niveau pour le dépannage. Évitez d’utiliser ce paramètre dans les sites de production. Une journalisation excessive peut se produire, ce qui pourrait rendre difficile la recherche d’informations pertinentes dans les fichiers journaux. Assurez-vous de désactiver ce paramètre après avoir résolu le problème.

Options de journalisation du rôle du 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 de serveur Configuration Manager.

Pour configurer les options de journalisation pour 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 : Défaut 2 : Avertissements et erreurs 3 : Erreurs seulement	Le niveau de détail à écrire dans les fichiers journaux.
LogMaxHistory	Tout nombre entier supérieur ou égal à zéro, par exemple: 0 : Pas d’historique 1 : Défaut	Lorsqu’un fichier journal atteint la taille maximale, le serveur le renomme en tant que sauvegarde et crée un nouveau fichier journal. Spécifiez le nombre de versions précédentes à conserver.
LogMaxSize	Tout nombre entier supérieur ou égal à 10 000, par exemple : 250000	La taille maximale du fichier journal en octets. Lorsqu’un journal atteint la taille spécifiée, le serveur le renomme en tant que fichier d’historique et crée un nouveau fichier. La valeur par défaut est de 250 000 octets.

Options de journalisation de la console Configuration Manager

Pour modifier le niveau verbeux de l’AdminUI.log pour la console du gestionnaire de configuration, utilisez la procédure suivante :

1. Ouvrir le fichier de configuration de la console, Microsoft.ConfigurationManagement.exe.config, dans un éditeur XML tel que Notepad. 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

   Important

   À partir de la version 1910, ce chemin a changé pour utiliser le dossier Microsoft Endpoint Manager. Assurez-vous de ne pas utiliser une ancienne version du fichier qui pourrait exister dans un autre dossier.

2. Sous l’élément source system.diagnostics > sources >, changez l’attribut switchValue de Error à Verbose. Par exemple:

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

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

Configuration des options de journalisation dans la console Configuration Manager

À partir de la version 1910, activez ou désactivez la journalisation verbeuse sur un client ou une collection à partir de la console :

1. Dans la console Configuration Manager, allez dans l’espace de travail Actifs et conformité, sélectionnez le nœud Dispositifs et choisissez un dispositif cible.

2. Dans le ruban, sur l’onglet Accueil, dans le groupe Périphérique, sélectionnez Diagnostic client. Choisissez l’une des actions disponibles.

Pour plus d’informations, voir Diagnostics du client.

Localisation des fichiers journaux

Le Gestionnaire de configuration et les composants dépendants stockent les fichiers journaux à divers 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 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 du gestionnaire de configuration : C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\AdminUILog
• IIS : C:\inetpub\logs\logfiles\w3svc1

L’emplacement du journal de la séquence de tâches

L’emplacement du fichier journal de la 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 RAM de Windows PE)
• Dans Windows PE après l’étape Formater et partitionner le disque : X:\smstslog\smsts.log, puis copié sur C:\_SMSTaskSequence\Logs\smstslog\smsts.log lorsque le lecteur est prêt
• Dans le nouvel OS Windows avant l’installation du client : C:\_SMSTaskSequence\Logs\smstslog\smsts.log
• Dans Windows après que le client soit installé : C:\Windows\CCM\Logs\smstslog\smsts.log
• Dans Windows après la fin de la séquence de tâches : C:\Windows\CCM\Logs\smsts.log

Voir aussi

.