Über Protokolldateien in Configuration Manager

• 11/29/2019
• 10 Minuten zu lesen
• • a
  • d

Gilt für: Configuration Manager (aktueller Zweig)

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

Dieser Artikel enthält allgemeine Informationen über die Protokolldateien von Configuration Manager. Er enthält die zu verwendenden Tools, wie die Protokolle konfiguriert werden und wo sie zu finden sind. Weitere Informationen zu bestimmten Protokolldateien finden Sie unter Referenz der Protokolldateien.

Funktionsweise

Die meisten Prozesse in Configuration Manager schreiben Betriebsinformationen in eine Protokolldatei, die für diesen Prozess bestimmt ist. Die Protokolldateien sind durch die Dateierweiterungen .log oder .lo_ gekennzeichnet. Configuration Manager schreibt so lange in eine .log-Datei, bis das Protokoll seine maximale Größe erreicht hat. Wenn das Protokoll voll ist, wird die .log-Datei in eine gleichnamige Datei mit der Erweiterung .lo_ kopiert, und der Prozess oder die Komponente schreibt weiter in die .log-Datei. Wenn die .log-Datei wieder ihre maximale Größe erreicht, wird die .lo_-Datei überschrieben und der Vorgang wiederholt sich. Einige Komponenten erstellen einen Protokolldateiverlauf, indem sie einen Datums- und Zeitstempel an den Protokolldateinamen anhängen und die .log-Erweiterung beibehalten.

Protokollanzeigetools

Alle Configuration Manager-Protokolldateien sind reiner Text, so dass Sie sie mit einem beliebigen Textprogramm wie Notepad anzeigen können. Die Protokolle verwenden eine eindeutige Formatierung, die am besten mit einem der folgenden spezialisierten Tools angezeigt wird:

• CMTrace
• OneTrace
• Support Center Log Viewer

CMTrace

Um die Protokolle anzuzeigen, verwenden Sie das Configuration Manager Log Viewer Tool CMTrace. Es befindet sich im Ordner \SMSSetup\Tools des Configuration Manager-Quellmediums. Das CMTrace-Tool wird zu allen Boot-Images hinzugefügt, die der Software-Bibliothek hinzugefügt werden. Das CMTrace-Protokollanzeigetool wird automatisch zusammen mit dem Configuration Manager-Client installiert. Weitere Informationen finden Sie unter CMTrace.

OneTrace

Seit Version 1906 ist OneTrace eine neue Protokollanzeige mit Support Center. Er funktioniert ähnlich wie CMTrace, mit einigen Verbesserungen. Weitere Informationen finden Sie unter Support Center OneTrace.

Protokollanzeige im Support Center

Support Center enthält eine moderne Protokollanzeige. Dieses Tool ersetzt CMTrace und bietet eine anpassbare Oberfläche mit Unterstützung für Registerkarten und andockbare Fenster. Es verfügt über eine schnelle Präsentationsschicht und kann große Protokolldateien in Sekundenschnelle laden. Weitere Informationen finden Sie unter Support Center Log Viewer-Referenz.

Konfigurieren Sie die Protokollierungsoptionen

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

• Während der Client-Installation
• Mit dem Configuration Manager Service Manager
• Mit der Windows-Registrierung
• In der Configuration Manager-Konsole

Konfigurieren der Protokollierungsoptionen während der Client-Installation

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

• CCMENABLELOGGING
• CCMDEBUGLOGGING
• CCMLOGLEVEL
• CCMLOGMAXHISTORY
• CCMLOGMAXSIZE

Weitere Informationen finden Sie unter Eigenschaften der Client-Installation.

Konfigurieren Sie die Protokollierungsoptionen mithilfe des Configuration Manager Service Managers

Sie können ändern, wo Configuration Manager die Protokolldateien speichert und wie groß sie sind.

Um die Größe von Protokolldateien zu ändern, den Namen und den Speicherort der Protokolldatei zu ändern oder mehrere Komponenten zu zwingen, in eine einzige Protokolldatei zu schreiben, führen Sie die folgenden Schritte aus:

Ändern Sie die Protokollierung für eine Komponente

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

2. Wählen Sie in der Multifunktionsleiste Start und dann Configuration Manager Service Manager.

3. Wenn Configuration Manager Service Manager geöffnet wird, stellen Sie eine Verbindung zu der Site her, die Sie verwalten möchten. Wenn die Site, die Sie verwalten möchten, nicht angezeigt wird, wählen Sie Site, wählen Sie Verbinden und geben Sie dann den Namen des Site-Servers für die richtige Site ein.

4. Erweitern Sie die Site und gehen Sie zu Komponenten oder Servern, je nachdem, wo sich die Komponenten befinden, die Sie verwalten möchten.

5. Wählen Sie im rechten Fensterbereich eine oder mehrere Komponenten aus.

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

7. Füllen Sie im Dialogfeld „Konfigurationsmanager – Komponentenprotokollierung“ die verfügbaren Konfigurationsoptionen für Ihre Auswahl aus.

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

Konfigurieren Sie die Protokollierungsoptionen mithilfe der Windows-Registrierung

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

• Verbose-Level
• Maximaler Verlauf
• Maximale Größe

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

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

• Wenn Sie die Client-Einstellungen ändern, starten Sie den SMS Agent Host-Dienst (CcmExec) neu.
• Wenn Sie die Server-Einstellungen ändern, starten Sie den SMS Executive-Dienst neu.

Die Registrierungseinstellungen hängen von der jeweiligen Komponente ab:

• Client und Verwaltungspunkt
• Seitenserver
• Seitensystemrolle
• Konsole des Konfigurationsmanagers

Protokollierungsoptionen für Client und Verwaltungspunkt

Um Protokollierungsoptionen für alle Komponenten auf einem Client- oder Verwaltungspunkt-Seitensystem 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: Verbose 1: Standard 2: Warnungen und Fehler 3: Nur Fehler	Der Detaillierungsgrad, der in die Protokolldateien geschrieben werden soll.
LogMaxHistory	Eine beliebige ganze Zahl größer oder gleich Null, zum Beispiel: 0: Kein Verlauf 1: Standard	Wenn eine Protokolldatei die maximale Größe erreicht, benennt der Client sie als Backup um und erstellt eine neue Protokolldatei. Geben Sie an, wie viele frühere Versionen aufbewahrt werden sollen.
LogMaxSize	Eine beliebige ganze Zahl größer oder gleich 10.000, zum Beispiel: 250000	Die maximale Größe der Protokolldatei in Bytes. Wenn ein Protokoll die angegebene Größe erreicht, benennt der Client es in eine Verlaufsdatei um und erstellt eine neue Datei. Der Standardwert ist 250.000 Bytes.

Für eine erweiterte Fehlersuche 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 für die Fehlersuche.

Diese Einstellung bewirkt, dass der Client Low-Level-Informationen zur Fehlersuche protokolliert. Vermeiden Sie die Verwendung dieser Einstellung in Produktionsstandorten. Es kann zu einer übermäßigen Protokollierung kommen, was das Auffinden relevanter Informationen in den Protokolldateien erschweren kann. Stellen Sie sicher, dass Sie diese Einstellung deaktivieren, nachdem Sie das Problem behoben haben.

Protokollierungsoptionen des Standortservers

Sie können die 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: SQL Server-Ablaufverfolgung deaktivieren	REG_DWORD	Die SQL Server-Ablaufverfolgungsprotokollierung zu allen Site-Server-Protokollen hinzufügen.
ArchiveEnabled	1: Aktivieren von Protokollarchiven 0: Deaktivieren von Protokollarchiven	REG_DWORD	Archivieren Sie Site-Server-Protokolle an einem separaten Speicherort zur historischen Aufbewahrung.
Archivierungspfad	Ein gültiger Ordnerpfad, z. B. C:\Logs\Archive	REG_SZ	Der Pfad zum Archivieren von Site-Server-Protokollen.

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

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: Verbose 1: Standard 2: Warnungen und Fehler 3: Nur Fehler	Der Detaillierungsgrad, der in die Protokolldateien geschrieben werden soll.
LogMaxHistory	Eine beliebige ganze Zahl größer oder gleich Null, zum Beispiel: 0: Kein Verlauf 1: Standard	Wenn eine Protokolldatei die maximale Größe erreicht, benennt der Server sie als Backup um und erstellt eine neue Protokolldatei. Geben Sie an, wie viele vorherige Versionen aufbewahrt werden sollen.
MaxFileSize	Eine beliebige ganze Zahl größer oder gleich 10.000, zum Beispiel: 250000	Die maximale Größe der Protokolldatei in Bytes. Wenn ein Protokoll die angegebene Größe erreicht, benennt der Client es in eine Verlaufsdatei um und erstellt eine neue Datei. Der Standardwert ist 250.000 Bytes.
DebugLogging	1: Debug-Protokolle aktivieren 0: Debug-Protokolle deaktivieren	Aktiviert die Debug-Protokollierung zur Fehlerbehebung.

Die Einstellung DebugLogging bewirkt, dass der Server Low-Level-Informationen zur Fehlerbehebung protokolliert. Vermeiden Sie die Verwendung dieser Einstellung in Produktionsstandorten. Es kann zu einer übermäßigen Protokollierung kommen, was das Auffinden relevanter Informationen in den Protokolldateien erschweren kann. Stellen Sie sicher, dass Sie diese Einstellung deaktivieren, nachdem Sie das Problem behoben haben.

Protokollierungsoptionen für Site-Systemrollen

Sie können die Einstellungen global oder für eine bestimmte Komponente auf einem Site-System 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

Zum Beispiel für die Verteilungspunktrolle:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging

Name	Werte	Beschreibung
LogLevel	0: Verbose 1: Standard 2: Warnungen und Fehler 3: Nur Fehler	Der Detaillierungsgrad, der in die Protokolldateien geschrieben werden soll.
LogMaxHistory	Eine beliebige ganze Zahl größer oder gleich Null, zum Beispiel: 0: Kein Verlauf 1: Standard	Wenn eine Protokolldatei die maximale Größe erreicht, benennt der Server sie als Backup um und erstellt eine neue Protokolldatei. Geben Sie an, wie viele frühere Versionen aufbewahrt werden sollen.
LogMaxSize	Eine beliebige ganze Zahl größer oder gleich 10.000, zum Beispiel: 250000	Die maximale Größe der Protokolldatei in Bytes. Wenn ein Protokoll die angegebene Größe erreicht, benennt der Server es in eine Verlaufsdatei um und erstellt eine neue Datei. Der Standardwert ist 250.000 Bytes.

Protokollierungsoptionen für die Configuration Manager-Konsole

Um die Ausführlichkeitsstufe des AdminUI.Log für die Configuration Manager-Konsole zu ändern, gehen Sie wie folgt vor:

1. Öffnen Sie die Konfigurationsdatei der Konsole, Microsoft.ConfigurationManagement.exe.config, in einem XML-Editor wie Notepad. Die Standardkonfigurationsdatei befindet sich an folgendem Ort: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

   Wichtig

   Ab Version 1910 wurde dieser Pfad geändert, um den Ordner Microsoft Endpoint Manager zu verwenden. Stellen Sie sicher, dass Sie keine ältere Version der Datei verwenden, die möglicherweise in einem anderen Ordner vorhanden ist.

2. Ändern Sie unter dem Element system.diagnostics > sources > source das Attribut switchValue von Error auf Verbose. 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 Sie die Protokollierungsoptionen in der Configuration Manager-Konsole

Ab Version 1910 können Sie die ausführliche Protokollierung auf einem Client oder einer Sammlung über die Konsole aktivieren oder deaktivieren:

1. Gehen Sie in der Configuration Manager-Konsole zum Arbeitsbereich „Assets und Compliance“, wählen Sie den Knoten „Geräte“ und wählen Sie ein Zielgerät aus.

2. Wählen Sie in der Multifunktionsleiste auf der Registerkarte Start in der Gruppe Gerät die Option Client-Diagnose. Wählen Sie eine der verfügbaren Aktionen.

Weitere Informationen finden Sie unter Client-Diagnose.

Auffinden von Protokolldateien

Der Configuration Manager und abhängige Komponenten speichern Protokolldateien an verschiedenen Orten. Diese Speicherorte hängen von dem Prozess ab, der die Protokolldatei erstellt, sowie von der Konfiguration Ihrer Umgebung.

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

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

Speicherorte der Aufgabensequenzprotokolle

Der Speicherort der Aufgabensequenzprotokolldatei smsts.log variiert je nach Phase der Aufgabensequenz:

• In Windows PE vor dem Schritt Formatieren und Partitionieren der Festplatte: X:\Windows\temp\smstslog\smsts.log (X ist das Windows PE-RAM-Laufwerk)
• In Windows PE nach dem Schritt Formatieren und Partitionieren der Festplatte: X:\smstslog\smsts.log, dann nach C:\_SMSTaskSequence\Logs\smstslog\smsts.log kopiert, wenn das Laufwerk bereit ist
• In dem 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 Beendigung der Tasksequenz: C:\Windows\CCM\Logs\smsts.log

Siehe auch