Over logboekbestanden in Configuration Manager
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:
- Tijdens de clientinstallatie
- Configuration Manager Service Manager gebruiken
- Het Windows-register gebruiken
- In de Configuration Manager-console
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
Ga in de Configuration Manager-console naar de werkruimte Bewaking, vouw Systeemstatus uit en selecteer vervolgens het knooppunt Sitestatus of Onderdeelstatus.
Selecteer start op het lint en selecteer vervolgens Configuration Manager Service Manager.
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.
Vouw de site uit en ga naar Onderdelen of Servers, afhankelijk van waar de onderdelen die u wilt beheren zich bevinden.
Selecteer in het rechterdeelvenster een of meer onderdelen.
Selecteer logboekregistratie in het menu Onderdeel.
Vul in het dialoogvenster Configuration Manager Logboekregistratie van onderdelen de beschikbare configuratieopties voor uw selectie in.
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 :Uitgebreide1 :Standaard2 : Waarschuwingen en fouten3 : alleen fouten |
Het detailniveau om naar logboekbestanden te schrijven. |
LogMaxHistory | Een geheel getal groter dan of gelijk aan nul, bijvoorbeeld:0 : Geen geschiedenis1 :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 inschakelenFalse : 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 inschakelen0 : tracering van SQL Server uitschakelen |
REG_DWORD | Voeg SQL Server traceringslogboeken toe aan alle logboeken van de siteserver. |
ArchiveEnabled |
1 : logboekarchieven inschakelen0 : 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 :Uitgebreide1 :Standaard2 : Waarschuwingen en fouten3 : alleen fouten |
Het detailniveau om naar logboekbestanden te schrijven. |
LogMaxHistory | Een geheel getal groter dan of gelijk aan nul, bijvoorbeeld:0 : Geen geschiedenis1 :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 inschakelen0 : 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 :Uitgebreide1 :Standaard2 : Waarschuwingen en fouten3 : alleen fouten |
Het detailniveau om naar logboekbestanden te schrijven. |
LogMaxHistory | Een geheel getal groter dan of gelijk aan nul, bijvoorbeeld:0 : Geen geschiedenis1 :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:
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
Wijzig onder hetbronelementsystem.diagnostics-bronnen>> het kenmerk switchValue van
Error
inVerbose
. Bijvoorbeeld:Origineel:
<source name="SmsAdminUISnapIn" switchValue="Error">
Nieuw:<source name="SmsAdminUISnapIn" switchValue="Verbose" >
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:
Ga in de Configuration Manager-console naar de werkruimte Activa en naleving, selecteer het knooppunt Apparaten en kies een doelapparaat.
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 naarC:\_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.