Diagnostische tracering gebruiken in System Center Operations Manager en in System Center Essentials

  • Artikel

In dit artikel wordt beschreven hoe u diagnostische tracering gebruikt in Microsoft System Center Essentials 2010 en System Center Operations Manager.

Oorspronkelijke productversie: Microsoft System Center Essentials 2010, Microsoft System Center Operations Manager 2007
Origineel KB-nummer: 942864

Belangrijk

Dit artikel bevat informatie over het wijzigen van het register. Zorg ervoor dat u een back-up van het register maakt voordat u deze wijzigt. Zorg dat u weet hoe u het register wilt herstellen als er een probleem optreedt. Raadpleeg Een back-up maken van en het herstellen van het register in Windows voor meer informatie over het maken van een back-up van het register, het herstellen en wijzigen van het register.

Inleiding

We raden u aan om diagnostische tracering alleen uit te voeren in samenwerking met een vertegenwoordiger van Microsoft Customer Support Services (CSS). We raden dit aan omdat de gegenereerde traceringen informatie bevatten over de context van een traceringsbericht op basis van tekst. In Microsoft System Center Operations Manager 2007 en in Microsoft System Center Essentials 2007 heeft deze traceringsgegevens echter geen leesbare indeling. Nadat de traceringen zijn geconverteerd door een CSS-vertegenwoordiger, is door mensen leesbare tekst beschikbaar. Deze tekst bevat echter alleen informatie op laag niveau, zoals namen van broncodebestanden, locaties, broncodefuncties en retourcodes. Deze informatie kan handig zijn als u een complex probleem moet oplossen.

In System Center Essentials 2010, System Center Operations Manager 2007 SP1 en latere versies worden traceringsberichtbestanden (TMF) geleverd waarmee binaire traceringsbestanden kunnen worden geconverteerd naar tekst. We raden u echter ten zeerste aan om alleen diagnostische tracering uit te voeren wanneer dit is vereist en alleen met overleg met een Microsoft-vertegenwoordiger.

System Center Operations Manager 2007 en System Center Essentials 2007 implementeren een diagnostische traceringsmethode die verschilt van eerdere versies van Microsoft Operations Manager. Met deze nieuwe traceringsmethode worden binaire bestanden gemaakt waarin traceringsgegevens worden opgeslagen. Omdat deze nieuwe traceringsmethode is geïmplementeerd op het niveau van de Windows-kernel, is deze zeer efficiënt en kan het tienduizenden traceringsberichten per seconde registreren.

In dit artikel worden de hulpprogramma's besproken die beschikbaar zijn om tracering te starten en te stoppen als u hiertoe wordt gevraagd door een Microsoft CSS-vertegenwoordiger. In het artikel wordt ook de nieuwe functionaliteit besproken die beschikbaar is in System Center Essentials 2010, in System Center Essentials 2007 SP1, in System Center Operations Manager 2007 SP1 en in latere versies.

Locatie van traceringshulpprogramma's

De installatiemap voor elke rol, zoals de rol Agent, de rol Beheerserver of de rol Gateway, bevat een map met de naam Hulpprogramma's. De volgende bestanden bevinden zich in de map Extra:

  • StartTracing.cmd
  • StopTracing.cmd
  • TracelogSM.exe
  • TracingGuidsBid.txt
  • TracingGuidsUI.txt
  • TracingGuidsNative.txt
  • TracingReadMe.txt

System Center Essentials 2010, System Center Essentials 2007 SP1 en System Center Operations Manager 2007 SP1 introduceren de volgende toevoegingen:

  • FormatTracing.cmd
  • ViewRealtimeTracing.cmd
  • TraceFmtSM.exe
  • OpsMgrTraceTMF.cab
  • Default.tmf
  • System.tmf

Tracering starten

Opmerking

In System Center Essentials 2010, System Center Operations Manager 2007 SP1 en latere versies wordt tracering automatisch gestart op zowel de rol Agent als de rol Beheerserver. Tracering gebruikt alleen foutuitvoer. Binaire traceringsbestanden worden naar de windows\logs\OpsMgrTrace map geschreven. Voordat het traceringsniveau voor traceringsuitvoer kan worden gewijzigd, moet de tracering eerst worden gestopt.

Voer de volgende stappen uit om diagnostische tracering te starten:

  1. Selecteer op de computer waarop u de tracering wilt starten , start, selecteer Uitvoeren, typ cmd en klik vervolgens op OK.

  2. Gebruik de opdracht bij de cd opdrachtprompt om naar de map Extra te gaan.

  3. Typ StartTracing LEVELen druk op Enter. Vervang in deze opdracht NIVEAU door het gewenste traceringsniveau. Gebruik hoofdletters om het traceringsniveau op te geven. De volgende niveaus zijn beschikbaar:

    • ERR
    • WRN
    • INF
    • VER

    Typ StartTracing WRNbijvoorbeeld .

Wanneer u begint met traceren, wordt de traceringsuitvoer geschreven naar de volgende binaire bestanden:

  • MOMTraceNative.etl
  • MOMTraceBID.etl
  • MOMTraceUI.etl

Voor Windows 7, Windows Server 2008, Windows Server 2008 R2 en latere versies bevinden de bestanden zich op windows\logs\OpsMgrTrace.

Tracering stoppen

Volg deze stappen om diagnostische tracering te stoppen:

  1. Selecteer Start, selecteer Uitvoeren, typ cmd en klik vervolgens op OK.
  2. Gebruik de opdracht bij de cd opdrachtprompt om naar de map Extra te gaan.
  3. Typ StopTracing.cmden druk op Enter.

Bestaande traceringen converteren naar tekstindeling

Als u bestaande traceringsbestanden wilt converteren naar teksttracering, moet u eerst stoppen met traceren met behulp van de StopTracing.cmd opdracht.

Opmerking

Informatie in de geconverteerde traceringen heeft een zeer laag detailniveau (foutopsporingsniveau). Daarom vereisen de geconverteerde traceringen kennis van de broncode en van het onderdeel dat wordt getraceerd. We raden u aan om traceringsconversie alleen uit te voeren wanneer dit is vereist door een CSS-vertegenwoordiger.

  1. Selecteer Start, selecteer Uitvoeren, typ cmd en klik vervolgens op OK.
  2. Gebruik de opdracht bij de cd opdrachtprompt om naar de map Extra te gaan.
  3. Typ FormatTracing.cmden druk op Enter.

De eerste keer dat de FormatTracing.cmd opdracht wordt uitgevoerd, worden de traceringsbestanden die nodig zijn om traceringen te converteren, geëxtraheerd naar de map SystemDrive\Program Files\System Center Operations Manager\Tools\TMF . Vervolgens somt het FormatTracing.cmd batchbestand elk traceringsbestand (*.etl) in de windows\logs\OpsMgrTrace map op. Vervolgens converteert het hulpprogramma TraceFMTSM.exe de bestanden naar tekst. De tekstuitvoer wordt naar een bestand met dezelfde naam geschreven met de extensie .log in de windows\logs\OpsMgrTrace map. Een samenvattingsbestand (.sum) wordt ook geschreven naar dezelfde locatie voor elk bestand dat wordt geconverteerd. In dit bestand wordt elke conversie van traceringsberichten weergegeven.

Geconverteerde traceringsbestanden weergeven

Traceringsbestanden die worden geconverteerd naar tekst met behulp van het FormatTracing.cmd batchbestand, kunnen worden weergegeven met behulp van een teksteditor, zoals Kladblok.

Tracering van opstarttijd is standaard ingeschakeld

Op een typische beheerserverinstallatie beginnen drie traceringssessies wanneer de HealthService-service wordt gestart. Standaard wordt alleen fouttracering uitgevoerd. Er wordt weinig informatie naar de traceringsbestanden geschreven. De standaardlocatie van het traceringsbestand en de namen die worden gemaakt, zijn als volgt:

Map Bestandsnaam Beschrijving
windows\logs\OpsMgrTrace TracingGuidsBID.etl Uitvoer traceren voor beheerde codeonderdelen
windows\logs\OpsMgrTrace TracingGuidsNative.etl Traceringsuitvoer voor systeemeigen codeonderdelen
windows\logs\OpsMgrTrace TracingGuidsUI.etl Traceringsuitvoer voor de gebruikersinterface van beheerde code (OpsMgr-gebruikersinterface)

Elke sessie is ingeschakeld met circulaire tracering en heeft een maximale bestandsgrootte van 100 MB (MEGABYTES). De normale etl-bestandsgrootte voor een nieuw gemaakt ETL-bestand is 16 kB (kB).

Opmerking

Hoewel een Operations Manager-rol, zoals een agentrol, geen beheerde of traceringsberichten voor de gebruikersinterface bevat, worden de drie standaard tracering.etl-bestanden standaard gemaakt wanneer de HealthService-service wordt gestart. Standaard worden er geen traceringssessies gestart voor alleen een gebruikersinterfacerol.

Tracering van opstarttijd uitschakelen

Waarschuwing

Er kunnen zich ernstige problemen voordoen als u het register met de Register-editor of met een andere methode foutief wijzigt. Wellicht moet u door deze problemen het besturingssysteem opnieuw installeren. Microsoft kan niet garanderen dat deze problemen kunnen worden opgelost. Het wijzigen van het register is op eigen risico.

Drie traceringsproviders worden automatisch gestart voor elke rol die de HealthService-service bevat. De traceringsbestanden worden naar de windows\logs\OpsMgrTrace map geschreven. Doorgaans zijn de ETL-bestanden in deze map klein, met name voor de rol Agent. Als de Operations Manager-installatie echter beschadigd raakt voor de beheerserverfunctie, kunnen een of meer van deze bestanden worden uitgebreid tot de maximaal geconfigureerde grootte van 100 MB. Deze bestanden omvatten het volgende:

  • TracingGuidsBid.etl
  • TracingGuidsNative.etl
  • TracingGuidsUI.etl
  • vorige ETL-bestanden

Als u tracering op foutopsporingsniveau moet uitschakelen vanwege een kleine opstartpartitiegrootte, kunt u een registerwaarde toevoegen aan de computer met de rol Beheerserver of de rol Agent waarop u tracering wilt uitschakelen. Volg hiertoe de volgende stappen.

Opmerking

Als tracering is uitgeschakeld, kan dit van invloed zijn op toekomstige probleemoplossing van Operations Manager omdat traceringsgegevens op laag niveau verloren gaan. Toekomstige hotfixes, servicepacks of productupdates kunnen de registervermelding verwijderen en tracering opnieuw inschakelen. Deze registersleutel bestaat standaard niet. Standaardtracering is ingeschakeld als u deze registersleutel verwijdert of de waarde ervan wijzigt in 0.

  1. Selecteer Start, selecteer Uitvoeren, typ regedit en klik vervolgens op OK.

  2. Selecteer de volgende registersubsleutel:

    HKEY_LOCAL_MACHINE\Software\Microsoft\Microsoft Operations Manager\3.0\

  3. Maak een subsleutel met de naam Tracing.

  4. Maak in het deelvenster Details een REG_DWORD-waarde met de naam DisableAutoTracing.

  5. Typ 1 in het veld Waardegegevens en klik op OK.

  6. Sluit de Register-editor af.

Als u het StopTracing.cmd batchbestand uitvoert vanuit de map Extra, worden de Operations Manager-traceringssessies gestopt. De ETL-bestanden in de windows\logs\OpsMgrTrace map kunnen worden verwijderd als ze geen schijfruimte meer nodig hebben.

De standaardlocatie van uitvoer van traceringsbestand verplaatsen

Als een Operations Manager-serverfunctie of -rol is geïnstalleerd op een computer waarop de ruimte voor de opstartpartitie beperkt is, moet u mogelijk de standaardlocatie van traceringsbestanden (*.etl) verplaatsen. Ga hiervoor als volgt te werk:

  1. Maak een nieuwe map op een lokale schijf die voldoende capaciteit heeft om de bestanden te plaatsen. Drie standaardtraceringsbestanden met een maximum van 100 MB elk en drie eerder gebruikte traceringsbestanden met een maximum van 100 MB elk is gelijk aan een totale potentiële traceringsbestandscapaciteit van 600 MB.

  2. Stel ten minste de volgende NTFS-machtigingen (NT File System) in voor de map, SYSTEM = Volledig beheer, Beheerders = Volledig beheer.

  3. Zoek en open het StartTracing.cmd batchbestand in de installatiemap Extra. Gebruik een teksteditor, zoals Kladblok.

  4. Zoek SET OpsMgrTracePath de instructie in het StartTracing.cmd batchbestand. Vervang de standaardwaarde door het pad van de nieuwe locatie. Begrenzing van het pad met spraakmarkeringen (") als het pad een spatieteken bevat.

  5. Sla de wijzigingen in het StartTracing.cmd-bestand op.

  6. Als u wilt beginnen met traceren naar de nieuwe map, voert u het StopTracing.cmd batchbestand uit. Voer vervolgens het StartTracing.cmd batchbestand uit. Nadat u het StartTracing.cmd batchbestand hebt uitgevoerd, worden de volgende bestanden naar de nieuwe map geschreven:

    • TracingGuidsBid.etl
    • TracingGuidsNative.etl
    • TracingGuidsUI.etl

  7. Voordat u de FormatTracing.cmd opdracht gebruikt om traceringen naar tekst te converteren, moet u de FormatTracing.cmd opdracht bewerken om de OpsMgrTracePath variabele te wijzigen zodat deze verwijst naar de nieuwe traceringsbestandsmap.

Toekomstige hotfixes, servicepacks of productupdates kunnen de bestanden in de map Extra wijzigen. Hierdoor wordt de functionaliteit teruggezet naar de standaardfunctionaliteit. We raden u aan om te controleren op meer wijzigingen nadat u updates hebt uitgevoerd.

Realtime tracering weergeven

We raden u aan het ViewRealTimeTracing.cmd batchbestand niet te gebruiken om realtime traceringen in een productieomgeving te bekijken zonder advies van Microsoft CSS. Het weergeven van traceringen in realtime, met name wanneer u instellingen voor informatietraceringsniveau of uitgebreide instellingen voor traceringsniveaus gebruikt, kan de serverprestaties ernstig beïnvloeden.

De eerste keer dat het ViewRealTimeTracing.cmd bestand wordt uitgevoerd, worden de traceringsbestanden die nodig zijn om traceringen te converteren, uitgepakt naar de map SystemDrive\Program Files\System Center Operations Manager\Tools\TMF . Het ViewRealTimeTracing.cmd batchbestand somt vervolgens elk traceersessiedefinitiebestand (Tools\TracingGuids*.txt) op in de map Extra. Vervolgens wordt een afzonderlijk exemplaar van TraceFmtSM gestart in een opdrachtpromptvenster. Uitvoer van traceringssessies voor beheerde, systeemeigen en door de gebruikersinterface beheerde traceringen wordt naar elk venster uitgevoerd.

Het ViewRealTimeTracing.cmd batchbestand accepteert één, optionele opdrachtregelparameter (-ods). Als u deze parameter opgeeft, worden er bovendien traceringsgegevens naar een foutopsporingsprogramma uitgevoerd.

Verwijzingen

Ga naar Microsoft Learn voor meer informatie over diagnostische tracering. Zoek vervolgens gebeurtenistracering voor Windows.