Over logboekbestanden in Configuration Manager

  • Artikel

Van toepassing op: Configuration Manager (current branch)

In Configuration Manager registreren client- en siteserveronderdelen procesgegevens in afzonderlijke logboekbestanden. U kunt de informatie in deze logboekbestanden gebruiken om problemen op te lossen die zich kunnen voordoen. Standaard schakelt Configuration Manager logboekregistratie in voor client- en serveronderdelen.

Dit artikel bevat algemene informatie over de Configuration Manager logboekbestanden. Het bevat hulpprogramma's om te gebruiken, hoe u de logboeken configureert en waar u ze kunt vinden. Zie Naslaginformatie over logboekbestanden voor meer informatie over specifieke logboekbestanden.

Hoe het werkt

De meeste processen in Configuration Manager operationele informatie schrijven naar een logboekbestand dat is toegewezen aan dat proces. De logboekbestanden worden geïdentificeerd door .log of .lo_ bestandsextensies. Configuration Manager schrijft naar een .log bestand totdat het logboek de maximale grootte heeft bereikt. Wanneer het logboek vol is, wordt het .log bestand gekopieerd naar een bestand met dezelfde naam, maar met de .lo_ extensie en blijft het proces of onderdeel naar het .log bestand schrijven. Wanneer het bestand opnieuw de .log maximale grootte heeft bereikt, wordt het .lo_ bestand overschreven en wordt het proces herhaald. Sommige onderdelen stellen een logboekbestandsgeschiedenis vast door een datum- en tijdstempel toe te voegen aan de naam van het logboekbestand en door de .log extensie te behouden.

Hulpprogramma's voor logboekviewer

Alle Configuration Manager logboekbestanden zijn tekst zonder opmaak, zodat u ze kunt weergeven met elke tekstlezer, zoals Kladblok. De logboeken gebruiken unieke opmaak die het beste kan worden weergegeven met een van de volgende gespecialiseerde hulpprogramma's:

CMTrace

Als u de logboeken wilt weergeven, gebruikt u cmtrace van het hulpprogramma Configuration Manager logboekviewer. Deze bevindt zich in de \SMSSetup\Tools map van de Configuration Manager bronmedia. Het hulpprogramma CMTrace wordt toegevoegd aan alle opstartinstallatiekopieën die worden toegevoegd aan de softwarebibliotheek. Het hulpprogramma CMTrace-logboekweergave wordt automatisch samen met de Configuration Manager-client geïnstalleerd. Zie CMTrace voor meer informatie.

OneTrace

OneTrace is een logboekviewer met het ondersteuningscentrum. Het werkt op dezelfde manier als CMTrace, met verbeteringen. Zie Ondersteuningscentrum OneTrace voor meer informatie.

Logboekbestandenviewer van het ondersteuningscentrum

Het ondersteuningscentrum bevat een moderne logboekviewer. Dit hulpprogramma vervangt CMTrace en biedt een aanpasbare interface met ondersteuning voor tabbladen en dockbare vensters. Het heeft een snelle presentatielaag en kan grote logboekbestanden in enkele seconden laden. Zie Logboekbestandenviewer van het Ondersteuningscentrum voor meer informatie.

Opmerking

Logboekviewer van het ondersteuningscentrum en OneTrace gebruiken Windows Presentation Foundation (WPF). Dit onderdeel is niet beschikbaar in Windows PE. Blijf CMTrace gebruiken in opstartinstallatiekopieën met takenreeksimplementaties.

Opties voor logboekregistratie configureren

U kunt de configuratie van de logboekbestanden wijzigen, zoals het uitgebreide niveau, de grootte en de geschiedenis. U kunt deze instellingen op verschillende manieren wijzigen:

U kunt ook hardware-inventaris gebruiken om logboekinstellingen van clients te verzamelen .

Opties voor logboekregistratie configureren tijdens de clientinstallatie

U kunt de configuratie van de clientlogboekbestanden instellen tijdens de installatie. Gebruik de volgende eigenschappen:

  • CCMENABLELOGGING
  • CCMDEBUGLOGGING
  • CCMLOGLEVEL
  • CCMLOGMAXHISTORY
  • CCMLOGMAXSIZE

Zie Eigenschappen van clientinstallatie voor meer informatie.

Opties voor logboekregistratie configureren met behulp van Configuration Manager Service Manager

U kunt wijzigen waar Configuration Manager de logboekbestanden opslaat en de grootte ervan.

Voer de volgende stappen uit om de grootte van logboekbestanden te wijzigen, de naam en locatie van het logboekbestand te wijzigen of om meerdere onderdelen af te dwingen om naar één logboekbestand te schrijven:

Logboekregistratie voor een onderdeel wijzigen

  1. Ga in de Configuration Manager-console naar de werkruimte Bewaking, vouw Systeemstatus uit en selecteer vervolgens het knooppunt Sitestatus of Onderdeelstatus.

  2. Selecteer start op het lint en selecteer vervolgens Configuration Manager Service Manager.

  3. Wanneer Configuration Manager Service Manager wordt geopend, maakt u verbinding met de site die u wilt beheren. Als de site die u wilt beheren niet wordt weergegeven, selecteert u Site, selecteert u Verbinding maken en voert u de naam in van de siteserver voor de juiste site.

  4. Vouw de site uit en ga naar Onderdelen of Servers, afhankelijk van waar de onderdelen die u wilt beheren zich bevinden.

  5. Selecteer in het rechterdeelvenster een of meer onderdelen.

  6. Selecteer logboekregistratie in het menu Onderdeel.

  7. Vul in het dialoogvenster Configuration Manager Logboekregistratie van onderdelen de beschikbare configuratieopties voor uw selectie in.

  8. Selecteer OK om de configuratie op te slaan.

Opties voor logboekregistratie configureren met behulp van het Windows-register

Gebruik het Windows-register op de servers of clients om de volgende opties voor logboekregistratie te wijzigen:

  • Uitgebreid niveau
  • Maximale geschiedenis
  • Maximumgrootte

Wanneer u een probleem wilt oplossen, kunt u uitgebreide logboekregistratie inschakelen voor Configuration Manager om aanvullende details in de logboekbestanden te schrijven.

Waarschuwing

Onjuiste configuratie van deze instellingen kan ertoe leiden dat Configuration Manager grote hoeveelheden gegevens of helemaal geen gegevens vastleggen. Hoewel deze gegevens nuttig kunnen zijn voor het oplossen van problemen, moet u voorzichtig zijn met het wijzigen van deze waarden in productiesites. Test deze wijzigingen altijd eerst in een testomgeving. Overmatige logboekregistratie kan optreden, waardoor het lastig kan zijn om relevante informatie in de logboekbestanden te vinden.

Nadat u wijzigingen hebt aangebracht in deze registerinstellingen, start u het onderdeel opnieuw op:

  • Als u de clientinstellingen wijzigt, start u de SERVICE SMS Agent Host (CcmExec) opnieuw.
  • Als u de serverinstellingen wijzigt, start u de SMS Executive-service opnieuw.

De registerinstellingen variëren, afhankelijk van het onderdeel:

Opties voor logboekregistratie van client- en beheerpunten

Als u opties voor logboekregistratie wilt configureren voor alle onderdelen op een client- of beheerpuntsitesysteem, configureert u deze REG_DWORD waarden onder de volgende Windows-registersleutel:

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

Naam Waarden Beschrijving
Loglevel 0:Uitgebreide
1:Standaard
2: Waarschuwingen en fouten
3: alleen fouten		 Het detailniveau om naar logboekbestanden te schrijven.
LogMaxHistory Een geheel getal groter dan of gelijk aan nul, bijvoorbeeld:
0: Geen geschiedenis
1:Standaard		 Wanneer een logboekbestand de maximale grootte bereikt, wijzigt de client de naam ervan als een back-up en maakt een nieuw logboekbestand. Geef op hoeveel eerdere versies u wilt behouden.
LogMaxSize Een geheel getal groter dan of gelijk aan 10.000, bijvoorbeeld:
250000		 De maximale grootte van het logboekbestand in bytes. Wanneer een logboek de opgegeven grootte heeft, wijzigt de client de naam van het logboek in een geschiedenisbestand en maakt een nieuw bestand. De standaardwaarde is 250.000 bytes.

Opmerking

Wijzig geen andere waarden die in deze registersleutel aanwezig kunnen zijn.

Voor geavanceerde foutopsporing kunt u deze REG_SZ waarde ook toevoegen onder de volgende Windows-registersleutel:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging

Naam Waarden Beschrijving
Ingeschakeld True: foutopsporingslogboeken inschakelen
False: foutopsporingslogboeken uitschakelen		 Hiermee schakelt u logboekregistratie voor foutopsporing in voor probleemoplossingsdoeleinden.

Deze instelling zorgt ervoor dat de client informatie op laag niveau vastmelt voor probleemoplossing. Vermijd het gebruik van deze instelling op productiesites. Overmatige logboekregistratie kan optreden, waardoor het lastig kan zijn om relevante informatie in de logboekbestanden te vinden. Zorg ervoor dat u deze instelling uitschakelt nadat u het probleem hebt opgelost.

Opties voor logboekregistratie van siteserver

U kunt instellingen globaal of voor een specifiek onderdeel configureren op de Configuration Manager siteserver.

Configureer deze waarden onder de volgende Windows-registersleutel:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing

Naam Waarden Type Beschrijving
SqlEnabled 1: SQL Server tracering inschakelen
0: tracering van SQL Server uitschakelen		 REG_DWORD Voeg SQL Server traceringslogboeken toe aan alle logboeken van de siteserver.
ArchiveEnabled 1: logboekarchieven inschakelen
0: logboekarchieven uitschakelen		 REG_DWORD Archief siteserverlogboeken op een afzonderlijke locatie voor historische bewaring.
ArchivePath Een geldig mappad, bijvoorbeeld C:\Logs\Archive REG_SZ Het pad naar de logboeken van de siteserver.

Schakel SQL Server tracering alleen in voor probleemoplossingsdoeleinden. Vermijd het gebruik ervan in productiesites. Overmatige logboekregistratie kan optreden, waardoor het lastig kan zijn om relevante informatie in de logboekbestanden te vinden. Zorg ervoor dat u deze instelling uitschakelt nadat u het probleem hebt opgelost.

Opmerking

Wijzig geen andere waarden die in deze registersleutel aanwezig kunnen zijn.

Als u opties voor logboekregistratie wilt configureren voor een specifiek serveronderdeel, configureert u deze REG_DWORD waarden onder de volgende Windows-registersleutel:

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

Naam Waarden Beschrijving
LoggingLevel 0:Uitgebreide
1:Standaard
2: Waarschuwingen en fouten
3: alleen fouten		 Het detailniveau om naar logboekbestanden te schrijven.
LogMaxHistory Een geheel getal groter dan of gelijk aan nul, bijvoorbeeld:
0: Geen geschiedenis
1:Standaard		 Wanneer een logboekbestand de maximale grootte bereikt, wijzigt de server de naam van het logboek als een back-up en maakt een nieuw logboekbestand. Geef op hoeveel eerdere versies u wilt behouden.
MaxFileSize Een geheel getal groter dan of gelijk aan 10.000, bijvoorbeeld:
250000		 De maximale grootte van het logboekbestand in bytes. Wanneer een logboek de opgegeven grootte heeft, wijzigt de client de naam van het logboek in een geschiedenisbestand en maakt een nieuw bestand. De standaardwaarde is 250.000 bytes.
FoutopsporingLogging 1: foutopsporingslogboeken inschakelen
0: foutopsporingslogboeken uitschakelen		 Hiermee schakelt u logboekregistratie voor foutopsporing in voor probleemoplossingsdoeleinden.

De instelling FoutopsporingLogging zorgt ervoor dat de server informatie op laag niveau vaststelt voor probleemoplossing. Vermijd het gebruik van deze instelling op productiesites. Overmatige logboekregistratie kan optreden, waardoor het lastig kan zijn om relevante informatie in de logboekbestanden te vinden. Zorg ervoor dat u deze instelling uitschakelt nadat u het probleem hebt opgelost.

Opmerking

Wijzig geen andere waarden die in deze registersleutel aanwezig kunnen zijn.

Opties voor logboekregistratie van sitesysteemrollen

U kunt instellingen globaal configureren of voor een specifiek onderdeel op een sitesysteem dat als host fungeert voor een Configuration Manager-serverfunctie.

Als u opties voor logboekregistratie wilt configureren voor een specifiek serveronderdeel, configureert u deze REG_DWORD waarden onder de volgende Windows-registersleutel:

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

Bijvoorbeeld voor de distributiepuntrol:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging

Naam Waarden Beschrijving
Loglevel 0:Uitgebreide
1:Standaard
2: Waarschuwingen en fouten
3: alleen fouten		 Het detailniveau om naar logboekbestanden te schrijven.
LogMaxHistory Een geheel getal groter dan of gelijk aan nul, bijvoorbeeld:
0: Geen geschiedenis
1:Standaard		 Wanneer een logboekbestand de maximale grootte bereikt, wijzigt de server de naam van het logboek als een back-up en maakt een nieuw logboekbestand. Geef op hoeveel eerdere versies u wilt behouden.
LogMaxSize Een geheel getal groter dan of gelijk aan 10.000, bijvoorbeeld:
250000		 De maximale grootte van het logboekbestand in bytes. Wanneer een logboek de opgegeven grootte breidt, wijzigt de server de naam van het logboek in een geschiedenisbestand en wordt er een nieuw bestand gemaakt. De standaardwaarde is 250.000 bytes.

Opmerking

Wijzig geen andere waarden die in deze registersleutel aanwezig kunnen zijn.

Opties voor logboekregistratie van Configuration Manager console

Als u het uitgebreide niveau van adminUI.log voor de Configuration Manager-console wilt wijzigen, gebruikt u de volgende procedure:

  1. Open het consoleconfiguratiebestand Microsoft.ConfigurationManagement.exe.configin een XML-editor zoals Kladblok. Het standaardconfiguratiebestand bevindt zich op de volgende locatie: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. Wijzig onder hetbronelementsystem.diagnostics-bronnen>> het kenmerk switchValue van Error in Verbose. Bijvoorbeeld:

    Origineel: <source name="SmsAdminUISnapIn" switchValue="Error"> Nieuw: <source name="SmsAdminUISnapIn" switchValue="Verbose" >

  3. Sla het bestand op en start de console opnieuw op.

Opties voor logboekregistratie configureren in de Configuration Manager-console

Uitgebreide logboekregistratie op een client of verzameling in- of uitschakelen vanuit de console:

  1. Ga in de Configuration Manager-console naar de werkruimte Activa en naleving, selecteer het knooppunt Apparaten en kies een doelapparaat.

  2. Selecteer op het lint op het tabblad Start in de groep Apparaatde optie Clientdiagnose. Kies een van de beschikbare acties.

Zie Clientdiagnose voor meer informatie.

Hardware-inventaris voor clientlogboekinstellingen

Vanaf versie 2107 kunt u hardware-inventaris inschakelen om instellingen voor clientlogboekbestanden te verzamelen. Schakel de hardware-inventarisklasse Client Diagnostics (CCM_ClientDiagnostics) in en selecteer vervolgens de volgende kenmerken:

  • Logboekregistratie voor fouten opsporen ingeschakeld
  • Logboekregistratie ingeschakeld
  • Logboekniveau
  • Aantal geschiedenisbestanden
  • Maximale grootte van logboekbestand

Opmerking

Deze inventarisklasse is niet standaard ingeschakeld.

Zie Bestaande hardware-inventarisklassen in- of uitschakelen voor meer informatie.

Logboekbestanden zoeken

Configuration Manager en afhankelijke onderdelen slaan logboekbestanden op verschillende locaties op. Deze locaties zijn afhankelijk van het proces waarmee het logboekbestand wordt gemaakt en de configuratie van uw omgeving.

De volgende locaties zijn de standaardinstellingen. Als u de installatiemappen in uw omgeving hebt aangepast, kunnen de werkelijke paden variëren.

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

Locaties van takenreekslogboeken

De locatie van het takenreekslogboekbestand smsts.log varieert afhankelijk van de fase van de takenreeks:

  • Stap in Windows PE vóór formatteren en partitieschijf : X:\Windows\temp\smstslog\smsts.log (X is het Windows PE RAM-station)
  • In Windows PE na stap Format and Partition Disk : X:\smstslog\smsts.log, vervolgens gekopieerd naar C:\_SMSTaskSequence\Logs\smstslog\smsts.log wanneer het station gereed is
  • In het nieuwe Windows-besturingssysteem voordat de client wordt geïnstalleerd: C:\_SMSTaskSequence\Logs\smstslog\smsts.log
  • In Windows nadat de client is geïnstalleerd: C:\Windows\CCM\Logs\smstslog\smsts.log
  • In Windows nadat de takenreeks is voltooid: C:\Windows\CCM\Logs\smsts.log

Tip

De takenreeksvariabele alleen-lezen _SMSTSLogPath bevat altijd het pad van het huidige logboekbestand.

Volgende stappen