Logboekbestanden in Configuration Manager

  • Artikel
  • 10 minuten om te lezen

Van toepassing op: Configuration Manager (current branch)

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

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

Hoe het werkt

De meeste processen in Configuration Manager schrijven operationele informatie 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 dat logboek de maximale grootte heeft bereikt. Wanneer het logboek vol is, wordt het bestand gekopieerd naar een bestand met dezelfde naam, maar met de extensie, en blijft het proces of .log onderdeel naar het bestand .lo_ .log schrijven. Wanneer het bestand opnieuw de maximale grootte heeft bereikt, wordt het .log bestand .lo_ overschreven en wordt het proces herhaald. Sommige onderdelen stellen een logboekbestandsgeschiedenis vast door een datum- en tijdstempel toe te staan aan de naam van het logboekbestand en door de extensie te .log behouden.

Hulpprogramma's voor logboekviewers

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

CMTrace

Als u de logboeken wilt weergeven, gebruikt u het hulpprogramma Configuratiebeheer-logboekviewer CMTrace. De map bevindt zich in de \SMSSetup\Tools map van de bronmedia van Configuration Manager. Het hulpmiddel CMTrace wordt toegevoegd aan alle opstartafbeeldingen die worden toegevoegd aan de softwarebibliotheek. Het weergaveprogramma voor CMTrace-logboeken wordt automatisch geïnstalleerd samen met de Configuration Manager-client. Zie CMTracevoor meer informatie.

OneTrace

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

Logboekbestandsviewer van ondersteuningscentrum

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 binnen enkele seconden grote logboekbestanden laden. Zie Logboekbestandsviewer van het Ondersteuningscentrum voor meer informatie.

Notitie

Logboekviewer van ondersteuningscentrum en OneTrace gebruiken Windows Presentation Foundation (WPF). Dit onderdeel is niet beschikbaar in Windows PE. Blijf CMTrace gebruiken in opstartafbeeldingen met taakreeksimplementaties.

Logboekregistratieopties 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 hardwarevoorraad gebruiken om logboekinstellingen van clients te verzamelen.

Logboekregistratieopties configureren tijdens de installatie van de client

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

  • CCMENABLELOGGING
  • CCMDEBUGLOGGING
  • CCMLOGLEVEL
  • CCMLOGMAXHISTORY
  • CCMLOGMAXSIZE

Zie Eigenschappen voor clientinstallatie voor meer informatie.

Logboekregistratieopties configureren met Configuration Manager Service Manager

U kunt wijzigen waar de logboekbestanden en de grootte van de logboekbestanden worden opgeslagen in Configuration Manager.

Als u de grootte van logboekbestanden wilt wijzigen, wijzigt u de naam en locatie van het logboekbestand of gaat u als volgt te werk om meerdere onderdelen te dwingen om naar één logboekbestand te schrijven:

Logboekregistratie voor een onderdeel wijzigen

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

  2. Selecteer op het lint Start 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 typt u vervolgens de naam 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 Component.

  7. Vul in het dialoogvenster Configuratiebeheer-onderdeelregistratie de beschikbare configuratieopties voor uw selectie in.

  8. Selecteer OK om de configuratie op te slaan.

Logboekregistratieopties configureren met behulp van Windows register

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

  • Verbose niveau
  • Maximale geschiedenis
  • Maximale grootte

Wanneer u een probleem oplost, kunt u uitgebreide logboekregistratie voor Configuration Manager inschakelen 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 oplogt. Hoewel deze gegevens nuttig kunnen zijn voor het oplossen van problemen, moet u voorzichtig zijn bij het wijzigen van deze waarden op productiesites. Test deze wijzigingen altijd eerst in een labomgeving. Er kan sprake zijn van overmatige logboekregistratie, waardoor het lastig kan zijn om relevante informatie in de logboekbestanden te vinden.

Nadat u deze registerinstellingen hebt gewijzigd, start u het onderdeel opnieuw:

  • Als u de clientinstellingen wijzigt, start u de sms-agent hostservice (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 beheerpunt

Als u logboekregistratieopties wilt configureren voor alle onderdelen van 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 Omschrijving
LogLevel 0: Verbose
1: Standaard
2: Waarschuwingen en fouten
3: Alleen fouten		 Het detailniveau om bestanden te schrijven.
LogMaxHistory Een geheel getal dat groter is dan of gelijk is aan nul, bijvoorbeeld:
0: Geen geschiedenis
1: Standaard		 Wanneer een logboekbestand de maximale grootte heeft bereikt, wordt het bestand door de client hernoemd als back-up en wordt een nieuw logboekbestand gemaakt. Geef op hoeveel vorige versies u wilt behouden.
LogMaxSize Een geheel getal groter dan of gelijk aan 10.000, bijvoorbeeld:
250000		 De maximale bestandsgrootte in bytes. Wanneer een logboek groter wordt dan de opgegeven grootte, wordt de naam van het logboek gewijzigd in een geschiedenisbestand en wordt er een nieuw bestand gemaakt. De standaardwaarde is 250.000 bytes.

Notitie

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

Voor geavanceerde debuggen kunt u ook deze waarde REG_SZ onder de volgende Windows registersleutel:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging

Naam Waarden Omschrijving
Ingeschakeld True: foutopsporingslogboeken inschakelen
False: foutopsporingslogboeken uitschakelen		 Hiermee kunt u foutopsporing voor probleemoplossingsdoeleinden inschakelen.

Deze instelling zorgt ervoor dat de client gegevens op laag niveau bijlogt voor probleemoplossing. Gebruik deze instelling niet op productiesites. Er kan sprake zijn van overmatige logboekregistratie, waardoor het lastig kan zijn om relevante informatie in de logboekbestanden te vinden. Schakel deze instelling uit nadat u het probleem hebt opgelost.

Opties voor logboekregistratie van siteserver

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

Configureer deze waarden onder de volgende Windows registersleutel:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing

Naam Waarden Type Omschrijving
SqlEnabled 1: tracering SQL Server inschakelen
0: het traceren SQL Server uitschakelen		 REG_DWORD Voeg SQL Server trace logging toe aan alle siteserverlogboeken.
ArchiveEnabled 1: logboekarchieven inschakelen
0: logboekarchieven uitschakelen		 REG_DWORD Archiveer siteserverlogboeken op een afzonderlijke locatie voor historische bewaring.
ArchivePath Een geldig mappad, bijvoorbeeld C:\Logs\Archive REG_SZ Het pad naar het archiveren van siteserverlogboeken.

Schakel alleen SQL Server voor probleemoplossing in. Vermijd het gebruik ervan op productiesites. Er kan sprake zijn van overmatige logboekregistratie, waardoor het lastig kan zijn om relevante informatie in de logboekbestanden te vinden. Schakel deze instelling uit nadat u het probleem hebt opgelost.

Notitie

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

Als u logboekregistratieopties voor een specifiek serveronderdeel wilt configureren, configureert u deze REG_DWORD onder de volgende Windows registersleutel:

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

Naam Waarden Omschrijving
LoggingLevel 0: Verbose
1: Standaard
2: Waarschuwingen en fouten
3: Alleen fouten		 Het detailniveau om bestanden te schrijven.
LogMaxHistory Een geheel getal dat groter is dan of gelijk is aan nul, bijvoorbeeld:
0: Geen geschiedenis
1: Standaard		 Wanneer een logboekbestand de maximale grootte heeft bereikt, wordt het bestand door de server hernoemd als back-up en wordt een nieuw logboekbestand gemaakt. Geef op hoeveel vorige versies u wilt behouden.
MaxFileSize Een geheel getal groter dan of gelijk aan 10.000, bijvoorbeeld:
250000		 De maximale bestandsgrootte in bytes. Wanneer een logboek groter wordt dan de opgegeven grootte, wordt de naam van het logboek gewijzigd in een geschiedenisbestand en wordt er een nieuw bestand gemaakt. De standaardwaarde is 250.000 bytes.
FoutopsporingLogging 1: foutopsporingslogboeken inschakelen
0: foutopsporingslogboeken uitschakelen		 Hiermee kunt u foutopsporing voor probleemoplossingsdoeleinden inschakelen.

De instelling FoutopsporingLogging zorgt ervoor dat de server gegevens op laag niveau bijlogt voor probleemoplossing. Gebruik deze instelling niet op productiesites. Er kan sprake zijn van overmatige logboekregistratie, waardoor het lastig kan zijn om relevante informatie in de logboekbestanden te vinden. Schakel deze instelling uit nadat u het probleem hebt opgelost.

Notitie

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

Opties voor rolregistratie van sitesysteem

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

Als u logboekregistratieopties voor een specifiek serveronderdeel wilt configureren, configureert u deze REG_DWORD onder de volgende Windows registersleutel:

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

Bijvoorbeeld voor de rol van het distributiepunt:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging

Naam Waarden Omschrijving
LogLevel 0: Verbose
1: Standaard
2: Waarschuwingen en fouten
3: Alleen fouten		 Het detailniveau om bestanden te schrijven.
LogMaxHistory Een geheel getal dat groter is dan of gelijk is aan nul, bijvoorbeeld:
0: Geen geschiedenis
1: Standaard		 Wanneer een logboekbestand de maximale grootte heeft bereikt, wordt het bestand door de server hernoemd als back-up en wordt een nieuw logboekbestand gemaakt. Geef op hoeveel vorige versies u wilt behouden.
LogMaxSize Een geheel getal groter dan of gelijk aan 10.000, bijvoorbeeld:
250000		 De maximale bestandsgrootte in bytes. Wanneer een logboek groter wordt dan de opgegeven grootte, wordt het bestand door de server hernoemd als een geschiedenisbestand en wordt er een nieuw bestand gemaakt. De standaardwaarde is 250.000 bytes.

Notitie

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

Configuratiebeheer-opties voor consoleregistratie

Als u het uitgebreide niveau van het AdminUI.log voor de configuration manager-console wilt wijzigen, gebruikt u de volgende procedure:

  1. Open het configuratiebestand van de console,Microsoft.ConfigurationManagement.exe.config, in 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 het bronelement system.diagnostics sources het > > schakelkenmerkValue 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.

Logboekregistratieopties configureren in de configuration manager-console

Uitgebreide logboekregistratie voor een client of verzameling in- of uitschakelen vanaf de console:

  1. Ga in de console Configuration Manager 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 Apparaat de optie Clientdiagnose. Kies een van de beschikbare acties.

Zie Clientdiagnose voor meer informatie.

Hardwarevoorraad voor instellingen voor clientlogboek

Vanaf versie 2107 kunt u hardwarevoorraad inschakelen om bestandsinstellingen voor clientlogboek te verzamelen. Schakel de hardwarevoorraadklasse clientdiagnose (CCM_ClientDiagnostics) in en selecteer de volgende kenmerken:

  • Foutopsporing logboekregistratie ingeschakeld
  • Logboekregistratie ingeschakeld
  • Logboekniveau
  • Aantal geschiedenisbestanden
  • Maximale logbestandsgrootte

Notitie

Deze voorraadklasse is standaard niet ingeschakeld.

Zie Bestaande hardwarevoorraadklassen in- of uitschakelen voor meer informatie.

Logboekbestanden zoeken

In Configuration Manager en afhankelijke onderdelen worden logboekbestanden op verschillende locaties opgeslagen. Deze locaties zijn afhankelijk van het proces dat het logboekbestand en de configuratie van uw omgeving maakt.

De volgende locaties zijn de standaardlocaties. Als u de installatie directories 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 logboeken van taakreeksen

De locatie van het logboekbestand van de taakreeks smsts.log is afhankelijk van de fase van de taakreeks:

  • In Windows stap PE vóór Opmaak en Partitieschijf: X:\Windows\temp\smstslog\smsts.log (X is het Windows PE-RAM-station)
  • In Windows stap PE na de stap Opmaak en Partitieschijf: , vervolgens gekopieerd X:\smstslog\smsts.log naar wanneer station klaar C:\_SMSTaskSequence\Logs\smstslog\smsts.log 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 taakreeks is voltooid:C:\Windows\CCM\Logs\smsts.log

Tip

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

Volgende stappen