Teilen über

Informationen zu Protokolldateien in Configuration Manager

  • Artikel

Gilt für: Configuration Manager (Current Branch)

In Configuration Manager zeichnen Client- und Standortserverkomponenten Prozessinformationen in einzelnen Protokolldateien auf. Sie können die Informationen in diesen Protokolldateien verwenden, um Probleme zu beheben, die auftreten können. Standardmäßig aktiviert Configuration Manager die Protokollierung für Client- und Serverkomponenten.

Dieser Artikel enthält allgemeine Informationen zu den Configuration Manager Protokolldateien. Es enthält tools to use, how to configure the logs, and where to find them. Weitere Informationen zu bestimmten Protokolldateien finden Sie unter Referenz zu Protokolldateien.

So funktioniert es

Die meisten Prozesse in Configuration Manager operative Informationen in eine Protokolldatei schreiben, die für diesen Prozess reserviert ist. Die Protokolldateien werden durch .log die Dateierweiterungen oder .lo_ identifiziert. Configuration Manager schreibt in eine .log Datei, bis dieses Protokoll seine maximale Größe erreicht. Wenn das Protokoll voll ist, wird die .log Datei in eine Datei mit demselben Namen, aber mit der .lo_ Erweiterung kopiert, und der Prozess oder die Komponente schreibt weiterhin in die .log Datei. Wenn die .log Datei wieder ihre maximale Größe erreicht, wird die .lo_ Datei überschrieben, und der Prozess wird wiederholt. Einige Komponenten richten einen Protokolldateiverlauf ein, indem sie einen Datums- und Zeitstempel an den Protokolldateinamen anfügen und die .log Erweiterung beibehalten.

Protokollanzeigetools

Alle Configuration Manager Protokolldateien sind Nur-Text, sodass Sie sie mit jedem Textleser wie Editor anzeigen können. Die Protokolle verwenden eine eindeutige Formatierung, die am besten mit einem der folgenden spezialisierten Tools angezeigt wird:

CMTrace

Verwenden Sie zum Anzeigen der Protokolle das Configuration Manager Protokoll-Viewer-Tool CMTrace. Sie befindet sich im \SMSSetup\Tools Ordner des Configuration Manager Quellmediums. Das CMTrace-Tool wird allen Startimages hinzugefügt, die der Softwarebibliothek hinzugefügt werden. Das CMTrace-Protokollanzeigetool wird automatisch zusammen mit dem Configuration Manager-Client installiert. Weitere Informationen finden Sie unter CMTrace.

OneTrace

OneTrace ist ein Protokoll-Viewer mit Supportcenter. Es funktioniert ähnlich wie CMTrace, mit Verbesserungen. Weitere Informationen finden Sie unter Supportcenter OneTrace.

Protokolldatei-Viewer des Supportcenters

Das Supportcenter enthält einen modernen Protokoll-Viewer. Dieses Tool ersetzt CMTrace und bietet eine anpassbare Schnittstelle mit Unterstützung für Registerkarten und andockbare Fenster. Es verfügt über eine schnelle Präsentationsebene und kann große Protokolldateien in Sekunden laden. Weitere Informationen finden Sie unter Log File Viewer des Supportcenters.

Hinweis

Support Center Log File Viewer und OneTrace verwenden Windows Presentation Foundation (WPF). Diese Komponente ist in Windows PE nicht verfügbar. Verwenden Sie CMTrace weiterhin in Startimages mit Tasksequenzbereitstellungen.

Konfigurieren von Protokollierungsoptionen

Sie können die Konfiguration der Protokolldateien ändern, z. B. ausführliche Ebene, Größe und Verlauf. Es gibt mehrere Möglichkeiten, diese Einstellungen zu ändern:

Sie können auch die Hardwareinventur verwenden, um Protokolleinstellungen von Clients zu erfassen .

Konfigurieren von Protokollierungsoptionen während der Clientinstallation

Sie können die Konfiguration der Clientprotokolldateien während der Installation festlegen. Verwenden Sie die folgenden Eigenschaften:

  • CCMENABLELOGGING
  • CCMDEBUGLOGGING
  • CCMLOGLEVEL
  • CCMLOGMAXHISTORY
  • CCMLOGMAXSIZE

Weitere Informationen finden Sie unter Clientinstallationseigenschaften.

Konfigurieren von Protokollierungsoptionen mithilfe von Configuration Manager Service Manager

Sie können ändern, wo Configuration Manager die Protokolldateien speichern und deren Größe ändern.

Führen Sie die folgenden Schritte aus, um die Größe von Protokolldateien zu ändern, den Namen und speicherort der Protokolldatei zu ändern oder um zu erzwingen, dass mehrere Komponenten in eine einzelne Protokolldatei schreiben:

Ändern der Protokollierung für eine Komponente

  1. Wechseln Sie in der Configuration Manager-Konsole zum Arbeitsbereich Überwachung, erweitern Sie Systemstatus, und wählen Sie dann entweder den Knoten Standortstatus oder Komponentenstatus aus.

  2. Wählen Sie im Menüband Start und dann Configuration Manager Service Manager aus.

  3. Wenn Configuration Manager Service Manager geöffnet wird, stellen Sie eine Verbindung mit der Website her, die Sie verwalten möchten. Wenn die Website, die Sie verwalten möchten, nicht angezeigt wird, wählen Sie Standort aus, wählen Sie Verbinden aus, und geben Sie dann den Namen des Standortservers für den richtigen Standort ein.

  4. Erweitern Sie den Standort, und wechseln Sie zu Komponenten oder Server, je nachdem, wo sich die zu verwaltenden Komponenten befinden.

  5. Wählen Sie im rechten Bereich mindestens eine Komponente aus.

  6. Wählen Sie im Menü Komponente die Option Protokollierung aus.

  7. Füllen Sie im Dialogfeld Configuration Manager Komponentenprotokollierung die verfügbaren Konfigurationsoptionen für Ihre Auswahl aus.

  8. Wählen Sie OK aus, um die Konfiguration zu speichern.

Konfigurieren von Protokollierungsoptionen mithilfe der Windows-Registrierung

Verwenden Sie die Windows-Registrierung auf den Servern oder Clients, um die folgenden Protokollierungsoptionen zu ändern:

  • Ausführliche Ebene
  • Maximaler Verlauf
  • Maximale Größe

Bei der Problembehandlung können Sie die ausführliche Protokollierung für Configuration Manager aktivieren, um zusätzliche Details in die Protokolldateien zu schreiben.

Warnung

Eine Fehlkonfiguration dieser Einstellungen kann dazu führen, dass Configuration Manager große Mengen von Informationen protokollieren oder gar nicht. Obwohl diese Daten für die Problembehandlung von Vorteil sein können, seien Sie vorsichtig, wenn Sie diese Werte an Produktionsstandorten ändern. Testen Sie diese Änderungen immer zuerst in einer Labumgebung. Es kann zu einer übermäßigen Protokollierung kommen, wodurch es möglicherweise schwierig wird, relevante Informationen in den Protokolldateien zu finden.

Nachdem Sie Änderungen an diesen Registrierungseinstellungen vorgenommen haben, starten Sie die Komponente neu:

  • Wenn Sie die Clienteinstellungen ändern, starten Sie den SMS-Agent-Hostdienst (CcmExec) neu.
  • Wenn Sie die Servereinstellungen ändern, starten Sie den SMS Executive-Dienst neu.

Die Registrierungseinstellungen variieren je nach Komponente:

Protokollierungsoptionen für Client und Verwaltungspunkt

Um Protokollierungsoptionen für alle Komponenten auf einem Client- oder Verwaltungspunkt-Standortsystem zu konfigurieren, konfigurieren Sie diese REG_DWORD Werte unter dem folgenden Windows-Registrierungsschlüssel:

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

Name Werte Beschreibung
Loglevel 0:Ausführliche
1:Standard
2: Warnungen und Fehler
3: Nur Fehler		 Die Detailebene, die in Protokolldateien geschrieben werden soll.
LogMaxHistory Jede ganze Zahl, die größer oder gleich 0 (null) ist, z. B.:
0: Kein Verlauf
1:Standard		 Wenn eine Protokolldatei die maximale Größe erreicht, benennt der Client sie als Sicherung um und erstellt eine neue Protokolldatei. Geben Sie an, wie viele vorherige Versionen beibehalten werden sollen.
LogMaxSize Jede ganze Zahl größer oder gleich 10.000, z. B.:
250000		 Die maximale Protokolldateigröße in Bytes. Wenn ein Protokoll auf die angegebene Größe anwächst, benennt der Client es in eine Verlaufsdatei um und erstellt eine neue Datei. Der Standardwert ist 250.000 Byte.

Hinweis

Ändern Sie keine anderen Werte, die möglicherweise in diesem Registrierungsschlüssel vorhanden sind.

Für das erweiterte Debuggen können Sie diesen REG_SZ Wert auch unter dem folgenden Windows-Registrierungsschlüssel hinzufügen:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging

Name Werte Beschreibung
Aktiviert True: Debugprotokolle aktivieren
False: Debugprotokolle deaktivieren		 Aktiviert die Debugprotokollierung zu Problembehandlungszwecken.

Diese Einstellung bewirkt, dass der Client Informationen auf niedriger Ebene für die Problembehandlung protokolliert. Vermeiden Sie die Verwendung dieser Einstellung in Produktionsstandorten. Es kann zu einer übermäßigen Protokollierung kommen, wodurch es möglicherweise schwierig wird, relevante Informationen in den Protokolldateien zu finden. Stellen Sie sicher, dass Sie diese Einstellung deaktivieren, nachdem Sie das Problem behoben haben.

Protokollierungsoptionen für Standortserver

Sie können Einstellungen global oder für eine bestimmte Komponente auf dem Configuration Manager-Standortserver konfigurieren.

Konfigurieren Sie diese Werte unter dem folgenden Windows-Registrierungsschlüssel:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing

Name Werte Typ Beschreibung
SqlEnabled 1: SQL Server Ablaufverfolgung aktivieren
0: Deaktivieren SQL Server Ablaufverfolgung		 REG_DWORD Fügen Sie SQL Server Ablaufverfolgungsprotokollierung zu allen Standortserverprotokollen hinzu.
ArchiveEnabled 1: Protokollarchive aktivieren
0: Protokollarchive deaktivieren		 REG_DWORD Archivieren Sie Standortserverprotokolle an einem separaten Speicherort, um den Verlauf zu erhalten.
ArchivePath Ein gültiger Ordnerpfad, z. B. C:\Logs\Archive REG_SZ Der Pfad zum Archivieren von Standortserverprotokollen.

Aktivieren Sie SQL Server Ablaufverfolgung nur zu Problembehandlungszwecken. Vermeiden Sie die Verwendung an Produktionsstandorten. Es kann zu einer übermäßigen Protokollierung kommen, wodurch es möglicherweise schwierig wird, relevante Informationen in den Protokolldateien zu finden. Stellen Sie sicher, dass Sie diese Einstellung deaktivieren, nachdem Sie das Problem behoben haben.

Hinweis

Ändern Sie keine anderen Werte, die möglicherweise in diesem Registrierungsschlüssel vorhanden sind.

Um Protokollierungsoptionen für eine bestimmte Serverkomponente zu konfigurieren, konfigurieren Sie diese REG_DWORD Werte unter dem folgenden Windows-Registrierungsschlüssel:

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

Name Werte Beschreibung
LoggingLevel 0:Ausführliche
1:Standard
2: Warnungen und Fehler
3: Nur Fehler		 Die Detailebene, die in Protokolldateien geschrieben werden soll.
LogMaxHistory Jede ganze Zahl, die größer oder gleich 0 (null) ist, z. B.:
0: Kein Verlauf
1:Standard		 Wenn eine Protokolldatei die maximale Größe erreicht, benennt der Server sie als Sicherung um und erstellt eine neue Protokolldatei. Geben Sie an, wie viele vorherige Versionen beibehalten werden sollen.
Maxfilesize Jede ganze Zahl größer oder gleich 10.000, z. B.:
250000		 Die maximale Protokolldateigröße in Bytes. Wenn ein Protokoll auf die angegebene Größe anwächst, benennt der Client es in eine Verlaufsdatei um und erstellt eine neue Datei. Der Standardwert ist 250.000 Byte.
DebugLogging 1: Debugprotokolle aktivieren
0: Debugprotokolle deaktivieren		 Aktiviert die Debugprotokollierung zu Problembehandlungszwecken.

Die DebugLogging-Einstellung bewirkt, dass der Server Informationen auf niedriger Ebene für die Problembehandlung protokolliert. Vermeiden Sie die Verwendung dieser Einstellung in Produktionsstandorten. Es kann zu einer übermäßigen Protokollierung kommen, wodurch es möglicherweise schwierig wird, relevante Informationen in den Protokolldateien zu finden. Stellen Sie sicher, dass Sie diese Einstellung deaktivieren, nachdem Sie das Problem behoben haben.

Hinweis

Ändern Sie keine anderen Werte, die möglicherweise in diesem Registrierungsschlüssel vorhanden sind.

Protokollierungsoptionen für Standortsystemrollen

Sie können Einstellungen global oder für eine bestimmte Komponente in einem Standortsystem konfigurieren, das eine Configuration Manager Serverrolle hostet.

Um Protokollierungsoptionen für eine bestimmte Serverkomponente zu konfigurieren, konfigurieren Sie diese REG_DWORD Werte unter dem folgenden Windows-Registrierungsschlüssel:

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

Beispiel: Für die Verteilungspunktrolle:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging

Name Werte Beschreibung
Loglevel 0:Ausführliche
1:Standard
2: Warnungen und Fehler
3: Nur Fehler		 Die Detailebene, die in Protokolldateien geschrieben werden soll.
LogMaxHistory Jede ganze Zahl, die größer oder gleich 0 (null) ist, z. B.:
0: Kein Verlauf
1:Standard		 Wenn eine Protokolldatei die maximale Größe erreicht, benennt der Server sie als Sicherung um und erstellt eine neue Protokolldatei. Geben Sie an, wie viele vorherige Versionen beibehalten werden sollen.
LogMaxSize Jede ganze Zahl größer oder gleich 10.000, z. B.:
250000		 Die maximale Protokolldateigröße in Bytes. Wenn ein Protokoll auf die angegebene Größe anwächst, benennt der Server es in eine Verlaufsdatei um und erstellt eine neue Datei. Der Standardwert ist 250.000 Byte.

Hinweis

Ändern Sie keine anderen Werte, die möglicherweise in diesem Registrierungsschlüssel vorhanden sind.

Protokollierungsoptionen für Configuration Manager-Konsole

Gehen Sie wie folgt vor, um die ausführliche Ebene von AdminUI.log für die Configuration Manager-Konsole zu ändern:

  1. Öffnen Sie die Konsolenkonfigurationsdatei Microsoft.ConfigurationManagement.exe.configin einem XML-Editor wie Editor. Die Standardkonfigurationsdatei befindet sich am folgenden Speicherort: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. Ändern Sie unter demQuellelementsystem.diagnostics>sources> das attribut switchValue von in ErrorVerbose. Zum Beispiel:

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

  3. Speichern Sie die Datei, und starten Sie die Konsole neu.

Konfigurieren von Protokollierungsoptionen in der Configuration Manager-Konsole

Aktivieren oder deaktivieren Sie die ausführliche Protokollierung auf einem Client oder einer Sammlung über die Konsole:

  1. Wechseln Sie in der Configuration Manager-Konsole zum Arbeitsbereich Bestand und Kompatibilität, wählen Sie den Knoten Geräte und dann ein Zielgerät aus.

  2. Wählen Sie im Menüband auf der Registerkarte Start in der Gruppe Gerät die Option Clientdiagnose aus. Wählen Sie eine der verfügbaren Aktionen aus.

Weitere Informationen finden Sie unter Clientdiagnose.

Hardwareinventur für Clientprotokolleinstellungen

Ab Version 2107 können Sie die Hardwareinventur aktivieren, um Clientprotokolldateieinstellungen zu erfassen. Aktivieren Sie die Hardwareinventurklasse ClientDiagnose (CCM_ClientDiagnostics), und wählen Sie dann die folgenden Attribute aus:

  • Debugprotokollierung aktiviert
  • Protokollierung aktiviert
  • Protokollebene
  • Anzahl der Verlaufsdateien
  • Maximale Protokolldateigröße

Hinweis

Diese Bestandsklasse ist standardmäßig nicht aktiviert.

Weitere Informationen finden Sie unter Aktivieren oder Deaktivieren vorhandener Hardwareinventurklassen.

Suchen nach Protokolldateien

Configuration Manager und abhängigen Komponenten speichern Protokolldateien an verschiedenen Speicherorten. Diese Speicherorte hängen vom Prozess zum Erstellen der Protokolldatei und der Konfiguration Ihrer Umgebung ab.

Die folgenden Speicherorte sind die Standardwerte. Wenn Sie die Installationsverzeichnisse in Ihrer Umgebung angepasst haben, können die tatsächlichen Pfade variieren.

  • Kunde: C:\Windows\CCM\logs
  • Server: C:\Program Files\Microsoft Configuration Manager\Logs
  • Verwaltungspunkt: C:\SMS_CCM\Logs
  • Configuration Manager-Konsole:C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\AdminUILog
  • IIS: C:\inetpub\logs\logfiles\w3svc1

Speicherorte des Tasksequenzprotokolls

Der Speicherort der Tasksequenzprotokolldatei smsts.log hängt von der Phase der Tasksequenz ab:

  • In Windows PE vor dem Schritt Datenträger formatieren und partitionieren : X:\Windows\temp\smstslog\smsts.log (X ist das Windows PE-RAM-Laufwerk)
  • In Windows PE nach dem Schritt Datenträger formatieren und partitionieren : X:\smstslog\smsts.log, und dann in C:\_SMSTaskSequence\Logs\smstslog\smsts.log kopiert, wenn das Laufwerk bereit ist
  • Im neuen Windows-Betriebssystem, bevor der Client installiert wird: C:\_SMSTaskSequence\Logs\smstslog\smsts.log
  • In Windows nach der Installation des Clients: C:\Windows\CCM\Logs\smstslog\smsts.log
  • In Windows nach Abschluss der Tasksequenz: C:\Windows\CCM\Logs\smsts.log

Tipp

Die schreibgeschützte Tasksequenzvariable _SMSTSLogPath immer den Pfad der aktuellen Protokolldatei enthält.

Nächste Schritte