Share via


CMTrace

Van toepassing op: Configuration Manager (current branch)

CMTrace is een van de Configuration Manager hulpprogramma's. Hiermee kunt u logboekbestanden weergeven en bewaken, waaronder de volgende typen:

  • Logboekbestanden in Configuration Manager- of CCM-indeling (Client Component Manager)

  • Gewone ASCII- of Unicode-tekstbestanden, zoals Windows Installer-logboeken

Het hulpprogramma helpt bij het analyseren van logboekbestanden door het markeren, filteren en opzoeken van fouten.

Opmerking

CMTrace wordt niet automatisch geregistreerd bij Windows om de bestandsextensie .log te openen. Zie Bestandskoppelingen voor meer informatie.

Configuration Manager versie 2107 bevat meerdere prestatieverbeteringen voor de CMTrace-logboekviewer.

Locaties

Configuration Manager installeert CMTrace automatisch op de volgende locaties:

  • De map met hulpprogramma's van de siteserver. Bijvoorbeeld:cd.latest\SMSSETUP\Tools\CMTrace.exe
  • De installatiemap van het beheerpunt. Bijvoorbeeld:C:\SMS_CCM\CMTrace.exe
  • De clientinstallatiemap. Bijvoorbeeld:C:\Windows\CCM\CMTrace.exe
  • Installatiekopieën voor het opstarten van besturingssysteemimplementatie. Bijvoorbeeld:X:\sms\bin\x64\CMTrace.exe

Als u een kopie van CMTrace op een andere locatie hebt, kunt u deze verwijderen en een kopie in een van de standaardpaden gebruiken. Als deze zich op een aangepaste locatie bevindt die voldoet aan uw bedrijfsvereisten, zorgt u ervoor dat u een proces hebt om deze up-to-date te houden. Als uw aangepaste locatie nuttig kan zijn voor andere klanten, kunt u productfeedback indienen.

Zie Directe koppelingen naar Community Hub-items voor meer informatie.

Gebruik

Voer CMTrace.exeuit . De eerste keer dat u het hulpprogramma uitvoert, ziet u een prompt voor bestandskoppeling. Zie Bestandskoppelingen voor meer informatie.

U kunt de meeste acties uitvoeren in CMTrace vanuit de volgende menu's:

Menu Bestand

De volgende acties zijn beschikbaar in het menu Bestand :

Het menu Bestand bevat ook de laatste acht recente bestanden. Open een van deze logboeken snel opnieuw door deze te selecteren in het menu Bestand.

Openen

Geeft het dialoogvenster Openen weer om naar een logboekbestand te bladeren.

Filter de weergave op bestanden van de volgende typen:

  • Logboekbestanden (*.log)
  • Oude logboekbestanden (*.lo_)
  • Alle bestanden (*.*)

De volgende twee opties zijn niet standaard geselecteerd:

  • Bestaande regels negeren: wanneer deze optie is geselecteerd, negeert CMTrace de bestaande inhoud van het geselecteerde logboekbestand en worden nieuwe regels alleen weergegeven wanneer deze worden toegevoegd. Gebruik deze optie om alleen nieuwe acties te bewaken wanneer u niet de volledige geschiedenis van het logboekbestand nodig hebt.

  • Geselecteerde bestanden samenvoegen: als u deze optie inschakelt en meer dan één logboekbestand selecteert, voegt CMTrace de geselecteerde logboeken in de weergave samen. Ze worden weergegeven alsof ze één logboekbestand zijn. Het samengevoegde logboek wordt hetzelfde bijgewerkt en ondersteunt alle andere CMTrace-functies alsof het één logboekbestand is.

Openen op server

Blader door de map Configuration Manager logboeken op een sitesysteemcomputer met het standaardvenster Bladeren. U kunt ook door het netwerk bladeren naar een externe computer.

Wanneer u een externe computer selecteert om te bladeren, controleert CMTrace op de Configuration Manager-share. Als een share met Configuration Manager logboekbestanden niet kan worden gevonden, wordt er een foutbericht weergegeven.

Als u rechtstreeks verbinding wilt maken met een bekende computer zonder te bladeren, gebruikt u de actie Openen . Voer vervolgens een servernaam en share in met behulp van de UNC-indeling.

Afdrukken

Het standaarddialoogvenster van Windows Afdrukken weergeven. Met deze actie wordt het huidige logboekbestand naar een printer verzonden. De uitvoer wordt opgemaakt volgens de instellingen op het tabblad Afdrukken van CMTrace-voorkeuren.

Voorkeuren

Configureer instellingen voor CMTrace. De volgende opties zijn beschikbaar:

  • Tabblad Algemeen

    • Update-interval: hiermee bepaalt u hoe vaak CMTrace controleert op wijzigingen in logboekbestanden en nieuwe regels laadt. Deze waarde is standaard 500 milliseconden.

    • Markeren: hiermee stelt u de kleur in die CMTrace gebruikt bij het markeren van logboeklijnen die u kiest. Deze kleur is standaard geel (rood: 255, groen: 255, blauw: 0).

    • Kolommen: configureert de kolommen die zichtbaar zijn in de logboekweergave en de volgorde waarin ze worden weergegeven. Standaard worden logboektekst, onderdeel, datum/tijd en thread weergegeven.

  • Tabblad Afdrukken

    • Kolommen: configureer welke kolommen worden gebruikt bij het afdrukken van logboekbestanden en de volgorde waarin ze worden weergegeven. Standaard worden dezelfde kolommen afgedrukt als die worden weergegeven.

    • Afdrukstand: hiermee stelt u de standaard afdrukstand in bij het afdrukken van logboekbestanden. Overschrijf deze instelling in het dialoogvenster Afdrukken. Standaard wordt de afdrukstand Staand gebruikt.

  • Tabblad Geavanceerd

    • Vernieuwingsinterval: hiermee wordt CMTrace gedwongen de logboekweergave bij te werken met een bepaald interval bij het laden van een groot aantal regels. Deze optie is standaard uitgeschakeld met de waarde nul.

      Opmerking

      Wijzig in het algemeen het vernieuwingsinterval niet. Het kan de hoeveelheid tijd die nodig is om grote logboekbestanden te openen aanzienlijk verhogen.

Menu

De volgende acties zijn beschikbaar in het menu Extra :

Vinden

Zoek in het geopende logboekbestand naar een opgegeven tekenreeks.

Volgende zoeken

Hiermee zoekt u de volgende overeenkomende tekenreeks, zoals u eerder hebt opgegeven in het dialoogvenster Zoeken.

Naar klembord kopiëren

Kopieert de geselecteerde regels als tekst zonder opmaak naar het Windows-klembord. Als u Configuration Manager- en CCM-logboekbestanden bekijkt, worden de kolommen in dezelfde volgorde gekopieerd als de weergave. Elke kolom wordt gescheiden door een tabteken. Gebruik deze actie bij het kopiëren van logboeken naar e-mailberichten of andere documenten.

Markeren

Voer een tekenreeks in die CMTrace gebruikt om de tekst van elke logboekvermelding te doorzoeken. Vervolgens worden logboektekst gemarkeerd die overeenkomt met de tekenreeks die u invoert.

  • De markering gebruikt de kleur die u hebt opgegeven in Voorkeuren.

  • Als u markeren wilt uitschakelen, wist u de tekenreeks uit dit veld.

  • Als u een decimaal of hexadecimaal getal invoert, probeert CMTrace de waarde te vergelijken met de kolom Thread. Gebruik dit gedrag om de verwerking van één thread te markeren, zonder andere threads te filteren die ermee kunnen communiceren.

  • Als u tekenreeksen per hoofdletter wilt vergelijken, schakelt u de optie hoofdlettergevoelig in.

Filter

Logboeklijnen weergeven of verbergen op basis van de opgegeven criteria. Pas filters toe op een van de vier kolommen, ongeacht of ze zichtbaar zijn. Deze instellingen zijn van toepassing op elk geopend logboekbestand.

Voorbeelden:

  • Filter smsts.log op vermeldingstekst die 'de actie' of 'de groep' bevat.
  • Filter InventoryAgent.log waarbij de tekst 'destination' bevat.

Foutzoekactie

Typ of plak een foutcode in de decimaal- of hexadecimale notatie om een beschrijving weer te geven. Mogelijke foutbronnen zijn: Windows, WMI of Winhttp.

Pauze

Logboekbewaking onderbreken of opnieuw starten. De volgende gebruiksvoorbeelden zijn enkele van de mogelijke redenen om deze actie te gebruiken:

  • Wanneer CMTrace logboekbestandsgegevens te snel weergeeft

  • Wanneer u logboekbewaking onderbreekt, gaat de informatie die CMTrace weergeeft, niet verloren als het huidige bestand wordt overgeschakeld naar een nieuw logboek

  • Wanneer u wilt voorkomen dat CMTrace nieuwe gegevens weergeeft terwijl u het logboekbestand bekijkt

Details weergeven/verbergen

Alle kolommen behalve de logboektekst weergeven of verbergen. De kolom logboektekst wordt ook uitgebreid tot de breedte van het venster. Gebruik deze actie wanneer u logboeken bekijkt op een computer met een lage beeldschermresolutie. Er wordt meer logboektekst weergegeven.

Opmerking

Bij het weergeven van bestanden zonder opmaak worden in CMTrace automatisch details verborgen omdat ze altijd leeg zijn.

Infovenster weergeven/verbergen

Het deelvenster Info weergeven of verbergen. Gebruik deze actie wanneer u logboeken bekijkt op een computer met een lage beeldschermresolutie. Er worden meer logboekgegevens weergegeven.

Logboekvenster

Het logboekvenster bevindt zich boven aan het CMTrace-venster. Er worden regels van logboekbestanden weergegeven.

Wanneer u een lijn selecteert, wordt deze tijdelijk gemarkeerd met behulp van het Windows-kleurenschema.

Gemarkeerde lijnen komen overeen met de criteria die u definieert met de optie Markeren in het menu Extra . De markering gebruikt de kleur die u opgeeft in Voorkeuren.

CMTrace geeft regels met fouten weer met een rode achtergrond en gele tekstkleur. In logboeken met CCM-indeling hebben logboekvermeldingen een expliciete typewaarde die de vermelding aangeeft als een fout. Voor andere logboekindelingen voert CMTrace in elke vermelding een niet-hoofdlettergevoelige zoekopdracht uit naar teksttekenreeksen die overeenkomen met 'fout'.

Er worden lijnen met waarschuwingen weergegeven met een gele achtergrond. In logboeken met CCM-indeling hebben logboekvermeldingen een expliciete typewaarde die de vermelding aangeeft als een waarschuwing. Voor andere logboekindelingen voert CMTrace in elke vermelding een niet-hoofdlettergevoelige zoekopdracht uit naar teksttekenreeksen die overeenkomen met 'waarschuwing'.

Infovenster

Het deelvenster Info bevindt zich onder aan het CMTrace-venster. Het bevat de volgende functies:

  • Details over de geselecteerde logboekvermelding

  • Een tekstvak waarin de logboektekst wordt weergegeven

  • Het geeft regelterugloop weer, zodat opgemaakte tekst gemakkelijker te lezen is

  • Gemakkelijker te lezen lange vermeldingen die niet volledig zichtbaar zijn in het deelvenster Logboek

Het deelvenster Info weergeven of verbergen met de optie Infovenster weergeven/verbergen in het menu Extra . Als het deelvenster Info meer dan de helft van het logboekvenster in beslag neemt, wordt dit automatisch verborgen door CMTrace.

Voortgangsbalk

Wanneer u een logboekbestand voor het eerst opent, vervangt CMTrace het deelvenster Info door een voortgangsbalk. Deze voortgang geeft aan hoeveel van de bestaande bestandsinhoud is geladen. De voortgang bereikt 100 procent, CMTrace verwijdert de voortgangsbalk en vervangt deze door het deelvenster Info. Wanneer u grote bestanden laadt, geeft dit gedrag u een indicatie van hoe lang het laden kan duren.

Statusbalk

Voor logboekbestanden met Configuration Manager- en CCM-indeling wordt op de statusbalk de verstreken tijd voor de geselecteerde logboekvermeldingen weergegeven. Als u één vermelding selecteert, geeft het hulpprogramma de tijd weer van de eerste logboekvermelding tot de geselecteerde vermelding. Als u meerdere vermeldingen selecteert, wordt de tijd berekend van de meest geselecteerde vermelding tot de meest geselecteerde vermelding onderaan. CmTrace formatteert deze informatie als volgt:

Elapsed time is <hours>h <minutes>m <seconds>s <milliseconds>ms (<seconds+milliseconds> seconds)

Windows Shell-integratie

CMTrace ondersteunt bestandskoppelingen en slepen en neerzetten.

Bestandskoppelingen

CMTrace kan zichzelf koppelen aan .log en .lo_ bestandsnaamextensies. Wanneer het programma wordt gestart, wordt het register gecontroleerd om te bepalen of het al is gekoppeld aan deze bestandsnaamextensies. Als CMTrace nog niet is gekoppeld aan bestandsextensies, wordt u gevraagd de bestandsextensies te koppelen aan CMTrace. Als u Dit niet opnieuw vragen selecteert, slaat CMTrace deze controle over wanneer deze op deze computer wordt uitgevoerd.

Slepen en neerzetten

CMTrace ondersteunt eenvoudige functionaliteit voor slepen en neerzetten. Sleep een logboekbestand van Windows Verkenner naar CMTrace om het te openen.

Andere tips

Registersleutel last directory

Standaard slaat CMTrace de laatste logboeklocatie op die u hebt geopend. Dit gedrag is nuttig op de siteserver, omdat het standaard wordt ingesteld op het logboekpad.

De eerste keer dat u deze start op een client, wordt de standaardinstelling ingesteld op de huidige werkmap. Deze locatie kan het pad zijn waar u CMTrace hebt opgeslagen, of een pad zoals %userprofile%\Desktop.

De waarde Van laatste map in de registersleutel HKEY_CURRENT_USER\Software\Microsoft\Trace32 bepaalt deze standaardlocatie. Als u deze waarde %windir%\CCM\Logs instelt op voor uw clients, opent CMTrace bestanden in de locatie van het clientlogboek de eerste keer dat u deze uitvoert.

Volgende stappen

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