Over logbestanden in Configuration Manager

• 11/29/2019
• 10 minuten om te lezen
• • a
  • d

Geldt voor: Configuration Manager (huidige tak)

In Configuration Manager leggen client- en siteservercomponenten procesinformatie vast in afzonderlijke logbestanden. U kunt de informatie in deze logbestanden gebruiken om u te helpen problemen op te lossen die zich kunnen voordoen. Configuration Manager schakelt standaard logboekregistratie in voor client- en servercomponenten.

Dit artikel bevat algemene informatie over de logbestanden van Configuration Manager. Het bevat hulpmiddelen die u kunt gebruiken, hoe u de logboeken kunt configureren en waar u ze kunt vinden. Voor meer informatie over specifieke log bestanden, zie Log bestanden referentie.

Hoe het werkt

De meeste processen in Configuration Manager schrijven operationele informatie naar een log bestand dat is gewijd aan dat proces. De logbestanden worden aangeduid met .log of .lo_ bestandsextensies. Configuration Manager schrijft naar een .log-bestand totdat dat log-bestand zijn maximale grootte heeft bereikt. Als het log vol is, wordt het .log-bestand gekopieerd naar een bestand met dezelfde naam maar met de extensie .lo_, en het proces of component blijft schrijven naar het .log-bestand. Wanneer het .log-bestand weer zijn maximale grootte bereikt, wordt het .lo_ bestand overschreven en herhaalt het proces zich. Sommige componenten leggen een geschiedenis van het logbestand vast door een datum- en tijdstempel aan de logbestandsnaam toe te voegen en door de .log-extensie te behouden.

Log viewer tools

Alle Configuration Manager logbestanden zijn platte tekst, dus je kunt ze bekijken met een tekstlezer zoals Notepad. De logboeken gebruiken een unieke opmaak die het best kan worden bekeken met een van de volgende gespecialiseerde hulpprogramma’s:

• CMTrace
• OneTrace
• Support Center log viewer

CMTrace

Om de logboeken te bekijken, gebruik je het Configuration Manager log viewer hulpprogramma CMTrace. Het bevindt zich in de \SMSSetup\Tools map van de Configuration Manager bronmedia. De CMTrace tool wordt toegevoegd aan alle boot images die worden toegevoegd aan de Software Library. Het hulpprogramma voor het bekijken van CMTrace-logboeken wordt automatisch geïnstalleerd samen met de Configuration Manager-client. Voor meer informatie, zie CMTrace.

OneTrace

Startend in versie 1906, OneTrace is een nieuwe log viewer met Support Center. Het werkt ongeveer hetzelfde als CMTrace, met verbeteringen. Voor meer informatie, zie Support Center OneTrace.

Support Center log viewer

Support Center bevat een moderne log viewer. Dit hulpprogramma vervangt CMTrace en biedt een aanpasbare interface met ondersteuning voor tabbladen en dockable vensters. Het heeft een snelle presentatielaag, en kan grote logbestanden in seconden laden. Zie voor meer informatie Support Center Log Viewer reference.

Logging opties configureren

U kunt de configuratie van de log bestanden veranderen, zoals het verbose niveau, grootte, en geschiedenis. Er zijn verschillende manieren om deze instellingen te wijzigen:

• Tijdens de installatie van de client
• In Configuration Manager Service Manager
• In het Windows-register
• In de Configuration Manager-console

Logboekopties configureren tijdens de installatie van de client

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

• CCMENABLELOGGING
• CCMDEBUGLOGGING
• CCMLOGLEVEL
• CCMLOGMAXHISTORY
• CCMLOGMAXSIZE

Zie Client installatie-eigenschappen voor meer informatie.

Configureer logging opties met behulp van Configuration Manager Service Manager

U kunt wijzigen waar Configuration Manager de log bestanden opslaat, en hun grootte.

Om de grootte van logbestanden te wijzigen, de naam en locatie van het logbestand te wijzigen, of om meerdere componenten te dwingen naar één logbestand te schrijven, voert u de volgende stappen uit:

Wijzig logboekregistratie voor een component

1. In de Configuration Manager-console gaat u naar de werkruimte Monitoring, vouwt u Systeemstatus uit en selecteert u vervolgens het knooppunt Locatiestatus of Componentstatus.

2. In het lint selecteert u Start en 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 Verbinden en voert u vervolgens de naam van de siteserver voor de juiste site in.

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

5. In het rechterdeelvenster selecteert u een of meer componenten.

6. In het menu Component selecteert u Logging.

7. In het dialoogvenster Configuration Manager Component Logging vult u de beschikbare configuratieopties voor uw selectie in.

8. Selecteer OK om de configuratie op te slaan.

Logboekopties configureren met behulp van het Windows-register

Gebruik het Windows-register op de servers of clients om de volgende logboekopties te wijzigen:

• Verbose level
• Maximum history
• Maximum size

Bij het oplossen van een probleem kunt u verbose logging inschakelen voor Configuration Manager om extra details in de logbestanden te schrijven.

Nadat u deze registerinstellingen hebt gewijzigd, start u de component opnieuw:

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

De registerinstellingen zijn afhankelijk van de component:

• Client- en beheerpunt
• Site server
• Site systeem rol
• Configuration Manager console

Logboekopties voor client- en beheerpunt

Om logboekopties te configureren voor alle componenten op een client- of beheerpunt site systeem, configureert u deze REG_DWORD waarden onder de volgende Windows registersleutel:

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

Name	Values	Description
LogLevel	0: Verbose 1: Standaard 2: Waarschuwingen en fouten 3: Alleen fouten	Het detailniveau dat naar logbestanden moet worden geschreven.
LogMaxHistory	Elk geheel getal groter dan of gelijk aan nul, bijvoorbeeld: 0: Geen geschiedenis 1: Standaard	Wanneer een logbestand de maximale grootte bereikt, hernoemt de client het als een back-up en maakt een nieuw logbestand aan. Geef aan hoeveel eerdere versies moeten worden bewaard.
LogMaxSize	Een geheel getal groter dan of gelijk aan 10.000, bijvoorbeeld: 250000	De maximale grootte van een logbestand in bytes. Wanneer een log groeit tot de gespecificeerde grootte, hernoemt de client het als een geschiedenis bestand, en maakt een nieuw bestand aan. De standaardwaarde is 250.000 bytes.

Voor geavanceerd debuggen kunt u deze REG_SZ-waarde ook toevoegen aan de volgende Windows-registersleutel:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging

Name	Values	Description
Enabled	True: debug-logs inschakelen False: debug-logs uitschakelen	Hiermee kunt u debug-logs inschakelen voor het opsporen van problemen.

Deze instelling zorgt ervoor dat de client informatie op laag niveau logt voor het oplossen van problemen. Vermijd het gebruik van deze instelling op productielocaties. Er kan overmatig loggen optreden, waardoor het moeilijk kan zijn om relevante informatie in de logbestanden te vinden. Zorg ervoor dat u deze instelling uitschakelt nadat u het probleem hebt opgelost.

Site server logging options

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

Configureer deze waarden onder de volgende Windows-registersleutel:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing

Name	Values	Type	Description
SqlEnabled	1: SQL Server tracering inschakelen 0: SQL Server tracering uitschakelen	REG_DWORD	Voeg SQL Server trace logging toe aan alle site server logs.
ArchiveEnabled	1: logarchieven inschakelen 0: logarchieven uitschakelen	REG_DWORD	Archiveer logboeken van de siteserver op een afzonderlijke locatie voor historische bewaring.
ArchivePath	Een geldig mappad, bijvoorbeeld C:\Logs\Archive	REG_SZ	Het pad voor het archiveren van de logs van de siteserver.

Sluit SQL Server-tracing alleen in voor troubleshooting-doeleinden. Vermijd het gebruik ervan in productielocaties. Er kan overmatig loggen optreden, wat het moeilijk kan maken om relevante informatie in de logbestanden te vinden. Zorg ervoor dat u deze instelling uitschakelt nadat u het probleem hebt opgelost.

Om de logboekopties voor een specifieke servercomponent te configureren, configureert u deze REG_DWORD-waarden onder de volgende Windows-registersleutel:

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

Naam	Values	Description
LoggingLevel	0: Verbose 1: Standaard 2: Waarschuwingen en fouten 3: Alleen fouten	Het detailniveau dat naar logbestanden moet worden geschreven.
LogMaxHistory	Elk geheel getal groter dan of gelijk aan nul, bijvoorbeeld: 0: Geen geschiedenis 1: Standaard	Wanneer een logbestand de maximale grootte bereikt, hernoemt de server het als een back-up en maakt een nieuw logbestand aan. Geef aan hoeveel eerdere versies moeten worden bewaard.
MaxFileSize	Een geheel getal groter dan of gelijk aan 10.000, bijvoorbeeld: 250000	De maximale grootte van het logbestand in bytes. Wanneer een log groeit tot de gespecificeerde grootte, hernoemt de client het als een geschiedenis bestand, en maakt een nieuw bestand aan. De standaardwaarde is 250.000 bytes.
DebugLogging	1: debug-logs inschakelen 0: debug-logs uitschakelen	Schakelt debug-logging in voor troubleshooting-doeleinden.

De DebugLogging-instelling zorgt ervoor dat de server low-level informatie logt voor troubleshooting. Vermijd het gebruik van deze instelling in productie sites. Overdreven logging kan optreden, wat het moeilijk kan maken om relevante informatie te vinden in de logbestanden. Zorg ervoor dat u deze instelling uitschakelt nadat u het probleem hebt opgelost.

Logboekopties voor sitesysteemrollen

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

Om logboekregistratieopties voor een specifieke servercomponent te configureren, configureert u deze REG_DWORD-waarden onder de volgende Windows-registersleutel:

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

Bijv. voor de distributiepuntrol:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging

Naam	Values	Description
LogLevel	0: Verbose 1: Standaard 2: Waarschuwingen en fouten 3: Alleen fouten	Het detailniveau dat naar logbestanden moet worden geschreven.
LogMaxHistory	Elk geheel getal groter dan of gelijk aan nul, bijvoorbeeld: 0: Geen geschiedenis 1: Standaard	Wanneer een logbestand de maximale grootte bereikt, hernoemt de server het als een back-up en maakt een nieuw logbestand aan. Geef aan hoeveel eerdere versies moeten worden bewaard.
LogMaxSize	Een geheel getal groter dan of gelijk aan 10.000, bijvoorbeeld: 250000	De maximale grootte van het logbestand in bytes. Wanneer een log groeit tot de gespecificeerde grootte, hernoemt de server het als een geschiedenis bestand, en maakt een nieuw bestand aan. De standaardwaarde is 250.000 bytes.

Configuration Manager console logging options

Om het verbose-niveau van de AdminUI.log voor de Configuration Manager-console te wijzigen, gebruikt u de volgende procedure:

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

   Belangrijk

   Met ingang van versie 1910 is dit pad gewijzigd en wordt de map Microsoft Endpoint Manager gebruikt. Zorg ervoor dat u geen oudere versie van het bestand gebruikt die mogelijk in een andere map bestaat.

2. Onder het system.diagnostics > sources > source element, verander het switchValue attribuut van Error naar Verbose. Bijvoorbeeld:

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

3. Bewaar het bestand en start de console opnieuw.

Logboekopties configureren in de console van Configuration Manager

Vanaf versie 1910 kunt u verbose-logboekregistratie op een client of verzameling in- of uitschakelen vanaf de console:

1. In de console van Configuration Manager gaat u naar de werkruimte Assets and Compliance, selecteert u het knooppunt Devices en kiest u een doelapparaat.

2. In het lint, op het tabblad Home, in de groep Apparaten, selecteert u Client Diagnostics. Kies een van de beschikbare acties.

Zie Clientdiagnostiek voor meer informatie.

Logbestanden lokaliseren

Configuration Manager en afhankelijke componenten slaan logbestanden op verschillende locaties op. Deze locaties zijn afhankelijk van het proces dat het logbestand aanmaakt en de configuratie van uw omgeving.

De volgende locaties zijn de standaardwaarden. Als u de installatiemappen in uw omgeving hebt aangepast, kunnen de werkelijke paden afwijken.

• 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 logboek taaksequentie

De locatie van het logbestand smsts.log van de taaksequentie varieert afhankelijk van de fase van de taaksequentie:

• In Windows PE vóór de stap Schijf formatteren en partitioneren: X:\Windows\temp\smstslog\smsts.log (X is het Windows PE RAM-station)
• In Windows PE na Format and Partition Disk stap: X:\smstslog\smsts.log, daarna gekopieerd naar C:\_SMSTaskSequence\Logs\smstslog\smsts.log als schijf gereed is
• In het nieuwe Windows OS voordat de client is 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

Zie ook