Hulpprogramma voor servicetraceringsviewer (SvcTraceViewer.exe)

Windows Communication Foundation (WCF) Service Trace Viewer Tool helpt u bij het analyseren van diagnostische traceringen die worden gegenereerd door WCF. Service Trace Viewer biedt een manier om eenvoudig traceringsberichten in het logboek samen te voegen, weer te geven en te filteren, zodat u problemen met wcf-services kunt vaststellen, herstellen en verifiëren.

Tracering configureren

Diagnostische traceringen bieden u informatie die laat zien wat er gebeurt tijdens de werking van uw toepassing. Zoals de naam al aangeeft, kunt u bewerkingen volgen van hun bron naar bestemming en via tussenliggende punten.

U kunt tracering configureren met behulp van het configuratiebestand van de toepassing: Web.config voor web-gehoste toepassingen of Appname.config voor zelf-hostende toepassingen. Hier volgt een voorbeeld:

<system.diagnostics>
    <trace autoflush="true" />
    <sources>
            <source name="System.ServiceModel"
                    switchValue="Information, ActivityTracing"
                    propagateActivity="true">
            <listeners>
               <add name="sdt"
                   type="System.Diagnostics.XmlWriterTraceListener"
                   initializeData= "SdrConfigExample.e2e" />
            </listeners>
         </source>
    </sources>
</system.diagnostics>

In dit voorbeeld wordt de naam en het type van de traceringslistener opgegeven. De listener heet sdt en de standaard .NET Framework-traceerlister (System.Diagnostics.XmlWriterTraceListener) wordt toegevoegd als het type. Het initializeData kenmerk wordt gebruikt om de naam van het logboekbestand in te SdrConfigExample.e2estellen voor die listener. Voor het logboekbestand kunt u een volledig gekwalificeerde pad vervangen door een eenvoudige bestandsnaam.

In het voorbeeld wordt een bestand gemaakt in de hoofdmap met de naam SdrConfigExample.e2e. Wanneer u Trace Viewer gebruikt om het bestand te openen zoals beschreven in de sectie 'WCF-traceringsbestanden openen en weergeven', ziet u alle berichten die zijn verzonden.

Het traceringsniveau wordt bepaald door de switchValue instelling. De beschikbare traceringsniveaus worden beschreven in de volgende tabel.

Traceerniveau	Beschrijving
Kritiek	- Logboeken fail-fast- en gebeurtenislogboekvermeldingen en traceringscorrelatie-informatie. Hier volgen enkele voorbeelden van wanneer u het kritieke niveau kunt gebruiken: - Uw AppDomain is offline gegaan vanwege een niet-verwerkte uitzondering. - De toepassing kan niet worden gestart. - Het bericht dat de fout heeft veroorzaakt, is afkomstig van het proces MyApp.exe.
Error	- Registreert alle uitzonderingen. In de volgende situaties kunt u het foutniveau gebruiken: - Uw code is vastgelopen vanwege een ongeldige cast-uitzondering. - De uitzondering 'Kan eindpunt niet maken' veroorzaakt dat uw toepassing mislukt bij het opstarten.
Waarschuwing	- Er bestaat een voorwaarde die vervolgens kan leiden tot een fout of kritieke fout. U kunt dit niveau in de volgende situaties gebruiken: - De toepassing ontvangt meer aanvragen dan de beperkingsinstellingen toestaan. - De ontvangende wachtrij bevindt zich op 98 procent van de geconfigureerde capaciteit.
Gegevens	- Berichten die nuttig zijn voor het bewaken en diagnosticeren van de systeemstatus, het meten van prestaties of profilering, worden gegenereerd. U kunt dergelijke informatie gebruiken voor capaciteitsplanning en prestatiebeheer. U kunt dit niveau in de volgende situaties gebruiken: - Er is een fout opgetreden nadat het bericht het AppDomain heeft bereikt en is gedeserialiseerd. - Er is een fout opgetreden tijdens het maken van de HTTP-binding.
Uitgebreid	- Tracering op foutopsporingsniveau voor zowel gebruikerscode als onderhoud. Stel dit niveau in wanneer: - U weet niet zeker welke methode in uw code is aangeroepen toen de fout optrad. - U hebt een onjuist eindpunt geconfigureerd en de service kan niet worden gestart omdat de vermelding in het reserveringsarchief is vergrendeld.
ActivityTracing	Stroomgebeurtenissen tussen verwerkingsactiviteiten en onderdelen. Op dit niveau kunnen beheerders en ontwikkelaars toepassingen in hetzelfde toepassingsdomein correleren. - Traceringen voor activiteitsgrenzen: starten/stoppen. - Traceringen voor overdrachten.

U kunt de add naam en het type traceerlistener opgeven die u wilt gebruiken. In de voorbeeldconfiguratie heeft de listener de naam sdt en wordt de standaard .NET Framework-traceerlistener (System.Diagnostics.XmlWriterTraceListener) toegevoegd als het type. Hiermee initializeData stelt u de naam van het logboekbestand voor die listener in. Daarnaast kunt u een volledig gekwalificeerd pad vervangen door een eenvoudige bestandsnaam.

Vanaf .NET Framework 4.8 worden besturingselementen met invoervak in sommige thema's met hoog contrast in de juiste kleur weergegeven. U kunt deze wijziging uitschakelen door de volgende instelling uit het bestand svcTraceViewer.exe.config te verwijderen:

<AppContextSwitchOverrides value="Switch.UseLegacyAccessibilityFeatures=false;Switch.UseLegacyAccessibilityFeatures.2=false" />

Het hulpprogramma Service Trace Viewer gebruiken

WCF-traceringsbestanden openen en weergeven

De Service Trace Viewer ondersteunt drie bestandstypen:

• WCF-traceringsbestand (.svcLog)

• Gebeurtenistraceringsbestand (.etl)

• Crimson-traceringsbestand

Met Service Trace Viewer kunt u elk ondersteund traceringsbestand openen, aanvullende traceringsbestanden toevoegen en integreren, of een groep traceringsbestanden tegelijk openen en samenvoegen.

Een traceringsbestand openen

1. Start Service Trace Viewer met behulp van een opdrachtvenster om naar uw WCF-installatielocatie te navigeren (C:\Program Files\Microsoft SDK's\Windows\v6.0\Bin) en typ SvcTraceViewer.exevervolgens .

Notitie

Het hulpprogramma Service Trace Viewer kan worden gekoppeld aan twee bestandstypen: .svclog en .stvproj. U kunt twee parameters in de opdrachtregel gebruiken om de bestandsextensies te registreren en de registratie ervan ongedaan te maken.

/register: registreer de koppeling van bestandsextensies ".svclog" en ".stvproj" met SvcTraceViewer.exe

/unregister: de registratie van de koppeling van bestandsextensies ".svclog" en ".stvproj" met SvcTraceViewer.exe

1. Wanneer Service Trace Viewer wordt gestart, klikt u op Bestand en wijst u vervolgens openen aan. Navigeer naar de locatie waar uw traceringsbestanden zijn opgeslagen.

2. Dubbelklik op het traceringsbestand dat u wilt openen.

   Notitie

   Druk op Shift terwijl u op meerdere traceringsbestanden klikt om ze tegelijk te selecteren en te openen. Service Trace Viewer voegt de inhoud van alle bestanden samen en geeft één weergave weer. U kunt bijvoorbeeld traceringsbestanden van zowel de client als de service openen. Dit is handig wanneer u berichtlogboekregistratie en activiteitsdoorgifte hebt ingeschakeld in de configuratie. Op deze manier kunt u berichtenuitwisseling tussen client en service onderzoeken. U kunt ook meerdere bestanden naar de viewer slepen of het tabblad Project gebruiken. Zie de sectie Project beheren voor meer informatie.

3. Als u extra traceringsbestanden wilt toevoegen aan de verzameling die is geopend, klikt u op Bestand en wijst u vervolgens toevoegen aan. Navigeer in het venster dat wordt geopend naar de locatie van de traceringsbestanden en dubbelklik op het bestand dat u wilt toevoegen.

Let op

Het wordt niet aanbevolen om een traceringslogboekbestand te laden dat groter is dan 200 MB. Als u probeert een bestand te laden dat groter is dan deze limiet, kan het laadproces lang duren, afhankelijk van uw computerresource. Het hulpprogramma Service Trace Viewer reageert mogelijk lange tijd niet of maakt het geheugen van uw computer mogelijk leeg. Het wordt aanbevolen om gedeeltelijke belasting te configureren om dit te voorkomen. Zie de sectie 'Grote traceringsbestanden laden' voor meer informatie over hoe u dit doet.

Gebeurtenistracering en Crimson-tracering

De systeemeigen indeling van de viewer is de indeling voor het traceren van activiteiten die door WCF wordt verzonden. Traceringen die in een andere indeling worden verzonden, moeten worden geconverteerd voordat de viewer ze weergeeft. Momenteel ondersteunt de viewer, naast de indeling voor het traceren van activiteiten, gebeurtenistracering en crimson-tracering.

Wanneer u een bestand opent dat geen activiteitstraceringen bevat, probeert de viewer het bestand te converteren. U moet de naam en locatie opgeven van het bestand dat de geconverteerde traceringsgegevens bevat. Zodra de gegevens zijn geconverteerd, geeft de viewer de inhoud van het nieuwe bestand weer.

Notitie

Voor conversie is schijfruimte vereist om de geconverteerde traceringsgegevens op te slaan. Zorg ervoor dat er voldoende schijfruimte beschikbaar is om de gegevens op te slaan voordat u een conversie start. Anders mislukt de conversie.

Projecten beheren

De viewer ondersteunt projecten om het weergeven van meerdere traceringsbestanden te vergemakkelijken. Als u bijvoorbeeld een clienttraceringsbestand en een servicetraceringsbestand hebt, kunt u deze toevoegen aan een project. Telkens wanneer u het project opent, worden alle traceringsbestanden in het project tegelijkertijd geladen.

Er zijn twee manieren om projecten te beheren:

• In het menu Bestand kunt u projecten openen, opslaan en sluiten.

• Op het tabblad Project kunt u bestanden toevoegen aan een project.

WCF-traceringen weergeven

WCF verzendt traceringen met behulp van de indeling voor het traceren van activiteiten. In het activiteitentraceringsmodel worden afzonderlijke traceringen gegroepeerd in activiteiten op basis van hun doel. De logische controlestroom wordt overgedragen tussen activiteiten. Tijdens de levensduur van een toepassing worden bijvoorbeeld veel 'berichten verzenden'-activiteiten weergegeven en verdwijnen. Zie Service Trace Viewer gebruiken voor het weergeven van gecorreleerde traceringen en probleemoplossing voor meer informatie over het weergeven van traceringen en activiteiten en de gebruikersinterface van de Service Trace Viewer.

Overschakelen naar verschillende weergaven

De Service Trace Viewer biedt de volgende verschillende weergaven. Ze worden weergegeven als tabbladen in het linkerdeelvenster van de Viewer en kunnen ook worden geopend vanuit het menu Beeld .

• Activiteitsweergave

• Projectweergave

• Berichtweergave

• Grafiekweergave

Activiteitsweergave

Zodra de traceringsbestanden zijn geopend, kunt u de traceringen zien die zijn gegroepeerd in activiteiten en worden weergegeven in de weergave Activiteit in het linkerdeelvenster.

In de activiteitsweergave worden de namen van activiteiten, het aantal traceringen in de activiteit, de duur, de begintijd en de eindtijd weergegeven.

Door op een van de vermelde activiteiten te klikken, worden de traceringen in deze activiteit weergegeven in het traceringsvenster aan de rechterkant. Vervolgens kunt u een tracering selecteren om de details ervan weer te geven.

U kunt meerdere activiteiten selecteren door op Ctrl of Shift te drukken en op de gewenste activiteiten te klikken. In het deelvenster Tracering worden alle traceringen van de geselecteerde activiteiten weergegeven.

U kunt dubbelklikken op een activiteit om deze weer te geven in De grafiekweergave . U kunt ook een activiteit selecteren en overschakelen naar Graph View.

Notitie

De activiteit 000000000000 is een speciale activiteit die niet kan worden weergegeven in de grafiekweergave. Omdat alle andere activiteiten eraan zijn gekoppeld, heeft het weergeven van deze activiteit een ernstige invloed op de prestaties.

U kunt op de kolomtitel klikken om de lijst met activiteiten te sorteren. Activiteiten die waarschuwingstraceringen bevatten, hebben een gele achtergrond en activiteiten die fouttraceringen bevatten, hebben een rode achtergrond.

Er zijn verschillende soorten activiteiten en elk type komt overeen met een pictogram aan de linkerkant van elke activiteit. U kunt de sectie Traceringspictogrammen begrijpen raadplegen voor hun betekenis.

Projectweergave

Met deze weergave kunt u traceringsbestanden in het huidige project beheren. Zie de sectie Project beheren voor meer informatie.

Berichtweergave

Met deze weergave kunt u alle traceringen van berichtenlogboeken weergeven, waaronder actie, datum/tijd, proces, activiteit en van/naar, en naar de details van de bijbehorende tracering van het berichtenlogboek navigeren. U kunt de traceringen van het berichtenlogboek groeperen op activiteitsgrens, proces/thread of verzenden en ontvangen voor eenvoudigere navigatie van de berichtenstroom.

Grafiekweergave

In deze weergave worden de traceringsgegevens voor een bepaalde activiteit in grafiekvorm weergegeven. Met het grafiekformulier kunt u de stapsgewijze uitvoering van gebeurtenissen en de onderlinge relaties tussen meerdere activiteiten zien wanneer gegevens ertussen worden verplaatst.

Als u wilt overschakelen naar de grafiekweergave , selecteert u een activiteit in de activiteitsweergave en klikt u op het tabblad Activiteit of op een tracering van een berichtlogboek in de berichtenweergave . Als er meerdere traceringsbestanden worden geladen en de activiteit traceringen uit meer dan één bestand omvat, worden alle relevante traceringen weergegeven in de grafiekweergave. Als u dubbelklikt op de activiteiten en traceringen van berichtenlogboeken, wordt u ook naar de grafiekweergave leiden.

In de grafiekweergave vertegenwoordigt elke verticale kolom een activiteit en elk blok in de kolom vertegenwoordigt een tracering. De activiteiten worden gegroepeerd op proces (of thread). De kleine pijlen tussen activiteiten vertegenwoordigen overdrachten. De grote pijlen tussen processen vertegenwoordigen berichtuitwisseling. De activiteit in selectie is altijd geel.

Traceringen selecteren in de grafiek

1. Klik op een blok in de grafiek.

2. Gebruik de toetsen omhoog en omlaag om de aangrenzende traceringen te selecteren.

3. Bekijk de traceringsinformatie in het deelvenster Tracering en detailvenster.

Activiteitsoverdrachten uitvouwen of samenvouwen

U kunt activiteitsoverdrachten uitbreiden wanneer de activiteit in selectie wordt overgedragen naar een andere activiteit. Hiermee kunt u de overdrachten volgen.

Om activiteitsoverdrachten uit te vouwen of samen te vouwen,

1. Zoek de overdrachtstracering met een +-teken aan de linkerkant van het overdrachtspictogram.

2. Klik op +of druk op Ctrl en +met het toetsenbord.

3. De volgende activiteit wordt weergegeven in de grafiek.

4. Links van het overdrachtspictogram wordt een '-' weergegeven. Klik op het "-" teken of druk op Ctrl en "-", de activiteitsoverdracht wordt samengevouwen.

Notitie

Wanneer een activiteit meerdere overdrachten bevat en u een van de overdrachten uitbreidt, worden activiteiten die leiden tot de nieuwe activiteit van de hoofdactiviteit weergegeven. Deze nieuwe activiteiten worden samengevouwen weergegeven. Als u de details van deze activiteiten wilt zien, vouwt u ze verticaal uit door te klikken op het pictogram Uitvouwen in de koptekst van de grafiek.

Activiteiten verticaal uitvouwen of samenvouwen

De viewer verbergt onnodige details in de activiteitsgrafiek door activiteiten samen te vouwen. In een samengevouwen activiteit worden afzonderlijke traceringen niet weergegeven. Alleen overdrachtstracering wordt weergegeven. Als u alle traceringen in een activiteit wilt weergeven, vouwt u de activiteit verticaal uit door te klikken op het uitvouwssymbool van de activiteit in de koptekst van de grafiek.

Als u activiteiten verticaal wilt uitvouwen of samenvouwen,

1. Klik op het pictogram +in de koptekst van de activiteit om de activiteit verticaal uit te vouwen.

2. U ziet dat alle traceringen worden weergegeven in de grafiek.

3. Klik op het pictogram '-' in de koptekst van de activiteit om de activiteit verticaal samen te vouwen.

4. U ziet dat alleen belangrijke overdrachten, berichtlogboeken, waarschuwings- en uitzonderingstraceringen worden weergegeven in de activiteit.

Opties

U kunt twee opties selecteren in het menu Optie in de grafiekweergave.

• Activiteitsgrenstraceringen weergeven, die, wanneer uitgeschakeld, de traceringen van de activiteitsgrens in de grafiek negeren.

• Uitgebreide traceringen voor niet-berichten weergeven, die bij niet-ingeschakelde uitgebreide traceringen op uitgebreid niveau negeren, met uitzondering van berichttraceringen. In de meeste gevallen zijn uitgebreide niveautraceringen minder belangrijk voor analyse. Deze optie is handig als u geen uitgebreide traceringen op niveau wilt analyseren en alleen wilt focussen op belangrijke traceringen.

Indelingsmodus

De viewer heeft twee indelingsmodi: Proces en Thread. Met deze instelling wordt de grootste organisatie-eenheid gedefinieerd. De standaardindelingsmodus is Proces, wat betekent dat activiteiten worden gegroepeerd op processen in de grafiek.

Uitvoeringslijst

U kunt in deze vervolgkeuzelijst selecteren welk proces of de thread moet worden weergegeven in de grafiek. Als u bijvoorbeeld de traceringsbestanden van twee clients (A en B) en één service hebt geopend en u alleen de service en client A in de grafiek wilt weergeven, kunt u de selectie van client B in de lijst opheffen.

Traceringsgegevens weergeven

Als u een traceringsdetails wilt weergeven, selecteert u een tracering in het deelvenster Traceren. De details worden weergegeven in het detailvenster.

Deelvenster Traceren

Het deelvenster Rechtsboven in de Service Trace Viewer is het deelvenster Tracering. Het bevat alle traceringen in de geselecteerde activiteit met extra informatie, bijvoorbeeld traceringsniveau, thread-id en procesnaam.

U kunt de onbewerkte XML van de tracering naar het klembord kopiëren door met de rechtermuisknop op een tracering te klikken en Traceren naar Klembord te selecteren.

Detailvenster

Het linkerdeelvenster linksonder in de Service Trace Viewer is het detailvenster. Het biedt drie tabbladen om traceringsdetails weer te geven.

In de opgemaakte weergave wordt de informatie op een meer georganiseerde manier weergegeven. Hiermee worden alle bekende XML-elementen in tabellen en bomen weergegeven, zodat u de informatie gemakkelijker kunt lezen en begrijpen.

In de XML-weergave wordt XML weergegeven die overeenkomt met de geselecteerde tracering. Het biedt ondersteuning voor markeringen en syntaxiskleur. Wanneer u Zoeken gebruikt om tekenreeksen te zoeken, worden de zoekresultaten gemarkeerd.

In de berichtenweergave wordt het berichtgedeelte van de XML weergegeven in traceringen van berichtenlogboeken. Het is onzichtbaar wanneer u een niet-berichttracering selecteert.

WCF-traceringen filteren

Als u de analyse van tracering eenvoudiger wilt maken, kunt u ze op de volgende manieren filteren:

• De filterwerkbalk biedt toegang tot vooraf gedefinieerde en aangepaste filters. Deze kan worden ingeschakeld via het menu Beeld .

• Het vooraf gedefinieerde filter van de viewer kan worden gebruikt om selectief onderdelen van de WCF-traceringen te filteren. Standaard is deze ingesteld om toe te staan dat alle infrastructuurtraceringen worden doorgegeven. De instellingen van dit filter worden gedefinieerd in het submenu Filteropties onder het menu Beeld .

• Aangepaste XPath-filters geven gebruikers volledige controle over filteren. Ze kunnen worden gedefinieerd in het aangepaste filter onder het menu Beeld .

Alleen traceringen die alle filters passeren, worden weergegeven.

De filterwerkbalk gebruiken

De filterwerkbalk wordt boven aan het hulpprogramma weergegeven. Als deze niet aanwezig is, kunt u deze activeren in het menu Beeld . De balk heeft drie onderdelen:

• Zoek naar: Zoek naar het onderwerp dat moet worden gezocht in de filterbewerking. Als u bijvoorbeeld alle traceringen wilt vinden die zijn verzonden in de context van proces X, stelt u dit veld in op X en het veld Zoeken in op 'Procesnaam'. Dit veld verandert in een datum/tijdselectorbesturingselement wanneer een filter op basis van tijd is geselecteerd.

• Zoeken in: Dit veld definieert het type filter dat moet worden toegepast.

• Niveau: Met de niveauinstelling definieert u het minimale traceringsniveau dat door het filter is toegestaan. Als het niveau bijvoorbeeld is ingesteld op Fout en Omhoog, worden alleen traceringen op fout- en kritiek niveau weergegeven. Dit filter combineert met de criteria die zijn opgegeven door Zoeken naar en Zoeken in.

Met de knop Nu filteren wordt de filterbewerking gestart. Het duurt lang voordat sommige filters worden toegepast op een grote gegevensset. U kunt de filterbewerking annuleren door op de knop Stoppen te drukken die wordt weergegeven op de statusbalk onder het menu Bewerkingen .

Met de knop Wissen worden vooraf gedefinieerde en aangepaste filters opnieuw ingesteld, zodat alle traceringen kunnen worden doorgegeven.

Filteropties

De viewer kan WCF-traceringen automatisch uit de weergave verwijderen. Het kan selectief traceringen verwijderen die worden verzonden door specifieke gebieden van WCF, bijvoorbeeld door transactiegerelateerde traceringen uit de weergave te verwijderen.

De instellingen van dit filter worden gedefinieerd in het submenu Filteropties onder het menu Beeld .

Aangepaste filters

Als u bekend bent met de XML Path Language (XPath), kunt u deze gebruiken om aangepaste filters te maken om de traceringsgegevens te doorzoeken op elk xml-element van belang. De filters zijn toegankelijk via de filterwerkbalk.

Aangepaste filters kunnen parameters bevatten. U kunt ook bestaande aangepaste filters importeren.

Een aangepast filter maken

Filters kunnen op twee manieren worden gemaakt:

Een aangepast filter maken met behulp van de wizard Sjabloon

U kunt op een bestaande tracering klikken en een filter maken op basis van de structuur van de trace. In dit voorbeeld wordt een aangepast filter gemaakt op basis van thread-id.

1. Selecteer in het deelvenster Trace in de rechterbovenhoek van de viewer een tracering die het element bevat waarop u wilt filteren.

2. Klik op de knop Aangepast filter maken boven aan het traceringsvenster.

3. Voer in het dialoogvenster dat wordt weergegeven een naam in voor het filter. In dit voorbeeld voert u Thread ID in. U kunt ook een beschrijving van uw filter opgeven.

4. In de structuurweergave aan de linkerkant wordt de structuur van de traceringsrecord weergegeven die u in stap 1 hebt geselecteerd. Blader naar het element waarvoor u een voorwaarde wilt maken. Blader in dit voorbeeld naar de ThreadID die zich in het knooppunt XPath: /E2ETraceEvent/System/Execution/@ThreadID bevindt. Dubbelklik op het threadID-kenmerk in de structuurweergave. Hiermee maakt u een expressie voor het kenmerk rechts van het dialoogvenster.

5. Wijzig het parameterveld voor de ThreadID-voorwaarde van None in '{0}'. Met deze stap kan de ThreadID-waarde worden geconfigureerd wanneer het filter wordt toegepast. (Zie de sectie Een filter toepassen) U kunt maximaal vier parameters definiëren. Voorwaarden worden gecombineerd met behulp van de OR-operator.

6. Klik op OK om het filter te maken.

Notitie

Zodra een filter is gemaakt met behulp van de sjabloonwizard, kan het alleen handmatig worden bewerkt. Het is niet mogelijk om de wizard te activeren voor een filter dat eerder is gemaakt. Daarnaast worden de voorwaarden van een XPath-filter dat is gemaakt in de sjabloonwizard gecombineerd met behulp van de OPERATOR OR. Als u een AND-bewerking nodig hebt, kunt u de filterexpressie bewerken nadat deze is gemaakt.

Handmatig een aangepast filter maken

Met het menu Aangepaste filters kunt u XPath-filters handmatig invoeren.

1. Klik in het menu Beeld op de menuopdracht Aangepaste filters .

2. Klik in het dialoogvenster dat wordt weergegeven op Nieuw.

3. Geef minimaal een filternaam en XPath-expressie op.

4. Klik op OK.

Een aangepast filter toepassen

Zodra een aangepast filter is gemaakt, is het toegankelijk via de filterwerkbalk. Selecteer het filter dat u wilt toepassen in het veld Zoeken in van de filterwerkbalk. Selecteer 'Thread-id' voor het vorige voorbeeld.

1. Geef de waarde op die u zoekt in het veld Zoeken naar wat . Voer in ons voorbeeld de id in van de thread waarnaar u wilt zoeken.

2. Klik op Nu filteren en bekijk het resultaat van de bewerking.

Als uw filter meerdere parameters gebruikt, voert u deze in met ';' als scheidingsteken in het veld Zoeken naar . Met de volgende tekenreeks worden bijvoorbeeld drie parameters gedefinieerd: '1; findValue; tekst'. De viewer past '1' toe op de {0} parameter van het filter. 'findValue' en 'text' worden toegepast op {1} respectievelijk {2} .

Aangepaste filters delen

Aangepaste filters kunnen worden gedeeld tussen verschillende sessies en verschillende gebruikers. U kunt de filters exporteren naar een definitiebestand en dit bestand op een andere locatie importeren.

Een aangepast filter importeren:

1. Klik in het menu Beeld op Aangepaste filters.

2. Klik in het dialoogvenster dat wordt geopend op de knop Importeren .

3. Navigeer naar het aangepaste filterbestand (.stvcf), klik op het bestand en klik op de knop Openen .

Een aangepast filter exporteren:

1. Klik in het menu Beeld op Aangepaste filters.

2. Selecteer in het dialoogvenster dat wordt geopend het filter dat u wilt exporteren.

3. Klik op de knop Exporteren .

4. Geef de naam en locatie van het aangepaste filterdefinitiebestand (.stvcf) op en klik op de knop Opslaan .

Notitie

Deze aangepaste filters kunnen alleen worden geïmporteerd en geëxporteerd vanuit Service Trace Viewer. Ze kunnen niet worden gelezen door andere hulpprogramma's.

Gegevens zoeken

De viewer biedt de volgende manieren om gegevens te vinden:

• De werkbalk Zoeken biedt snelle toegang tot de meest voorkomende zoekopties.

• Het dialoogvenster Zoeken biedt meer opties voor zoeken. Het is toegankelijk via het menu Bewerken of met de korte toets Ctrl +F.

De werkbalk Zoeken wordt boven aan de viewer weergegeven. Als deze niet aanwezig is, kunt u deze activeren in het menu Beeld . De balk heeft twee onderdelen:

• Zoek wat: Hiermee kunt u een trefwoord invoeren.

• Zoeken in: Hiermee kunt u het zoekbereik invoeren. U kunt selecteren of u alleen wilt zoeken in alle activiteiten of in de huidige activiteit.

Het dialoogvenster Zoeken biedt twee extra opties:

• Doel zoeken:

  • De optie Onbewerkte logboekgegevens doorzoekt het trefwoord in alle onbewerkte gegevens.

  • De opties XML-tekst en XML-kenmerk zoeken alleen in XML-elementen.

  • Met de optie 'Geregistreerd bericht' wordt het trefwoord alleen in berichten doorzocht.

• Hoofdactiviteit negeren: De zoekopdracht negeert de traceringen in de activiteit '000000000000'. Dit verbetert de prestaties in grote traceringsbestanden wanneer de hoofdactiviteit duizenden traceringen heeft, waarvan de meeste overdrachten zijn.

Door traceringen navigeren

Omdat traceringen stapsgewijs worden vastgelegd tijdens de runtime van de toepassing, kan het navigeren in traceringen u helpen bij het opsporen van fouten in uw toepassing. De Service Trace Viewer biedt verschillende manieren om in traceringen te navigeren.

Naar voren of naar achteren

Als u elke tracering beschouwt als een coderegel in het programma, is stap vooruit vergelijkbaar met 'Step over' in de Visual Studio Integrated Development Environment (IDE). Het verschil is dat u ook terug kunt stappen in de traceringen. Als u vooruitgaat, gaat u naar de volgende tracering in de activiteit.

• Stap vooruit: Gebruik het menu Activiteit of druk op F10. U kunt ook de pijltoets 'omlaag' gebruiken in het traceringsvenster.

• Stap achteruit: Gebruik het menu Activiteit of druk op F9. U kunt ook de pijltoets 'omhoog' gebruiken in het traceringsvenster.

Notitie

Hiermee kunt u naar een activiteit gaan die plaatsvindt in een ander proces of zelfs op een andere computer, omdat WCF-berichten activiteits-id's kunnen bevatten die machines omvatten.

Overdracht volgen

Overdrachtstraceringen zijn speciale traceringen in het traceringsbestand. Een activiteit kan worden overgedragen naar een andere activiteit door een overdrachtstracering. Bijvoorbeeld: 'Activiteit A' kan worden overgedragen naar 'Activiteit B'. In dat geval bevindt zich een overdrachtstracering in de 'Activiteit A' met de naam 'Aan: Activiteit' en het overdrachtspictogram. Deze overdrachtstracering is een koppeling tussen de twee traceringen. In 'Activiteit B' kan er ook een overdrachtstracering aan het einde van de activiteit zijn om terug te gaan naar Activiteit A. Dit is vergelijkbaar met functie-aanroepen in programma's: A roept B aan en vervolgens B retourneert.

"Overdracht volgen" is vergelijkbaar met "Stap in" in een foutopsporingsprogramma. Het volgt de overdracht van A naar B. Het heeft geen effect op andere traceringen.

Er zijn twee manieren om een overdracht te volgen: met de muis of het toetsenbord:

• Met de muis: dubbelklik op de overdrachtstracering in het traceringsvenster.

• Op toetsenbord: selecteer een overdrachtstracering en gebruik 'Overdracht volgen' in het menu Activiteit of druk op F11

Notitie

In veel gevallen wacht Activiteit A, wanneer Activiteit A overdraagt naar Activiteit B, totdat Activiteit B weer overdraagt naar Activiteit A. Dit betekent dat activiteit A geen tracering heeft geregistreerd tijdens de periode waarin Activiteit B actief wordt getraceerd. Het is echter ook mogelijk dat Activiteit A niet wacht en traceringen blijft registreren. Het is ook mogelijk dat Activiteit B niet wordt overgedragen naar Activiteit A. Daarom verschillen activiteitsoverdrachten nog steeds van functie-aanroepen in deze zin. U kunt activiteitenoverdrachten beter begrijpen in de Graph-weergave.

Naar volgende of vorige overdracht gaan

Wanneer u de huidige activiteit analyseert of geselecteerde activiteiten wanneer er meerdere activiteiten zijn geselecteerd, wilt u mogelijk snel de activiteiten vinden waarnaar deze wordt overgedragen. Met 'Naar volgende overdracht' kunt u de volgende overdrachtstracering in de activiteit vinden. Zodra u de overdrachtstracering hebt gevonden, kunt u 'Overdracht volgen' gebruiken om naar de volgende activiteit te gaan.

• Ga naar Volgende overdracht: gebruik het menu Activiteit of druk op Ctrl +F10.

• Ga naar vorige overdracht: gebruik het menu Activiteit of druk op Ctrl +F9.

Navigeren in grafiekweergave

Hoewel navigeren in het activiteitenvenster en het traceringsvenster vergelijkbaar is met foutopsporing, biedt het gebruik van de Graph-weergave een veel betere ervaring in navigatie. Zie de sectie Grafiekweergave voor meer informatie.

Grote traceringsbestanden laden

Traceringsbestanden kunnen erg groot zijn. Als u tracering bijvoorbeeld inschakelt op het niveau Uitgebreid, kan het resulterende traceringsbestand voor het uitvoeren van een paar minuten eenvoudig honderden megabytes of zelfs groter zijn, afhankelijk van het netwerksnelheid en communicatiepatroon.

Wanneer u een zeer groot traceringsbestand opent in de Service Trace Viewer, kunnen systeemprestaties negatief worden beïnvloed. De laadsnelheid en de reactietijd na het laden kunnen traag zijn. De werkelijke snelheid verschilt van tijd tot tijd, afhankelijk van uw hardwareconfiguratie. In de meeste pc's heeft het laden van een traceringsbestand dat groter is dan 200M een ernstige invloed op de prestaties. Voor traceringen van bestanden die groter zijn dan 1G, kan het hulpprogramma al het beschikbare geheugen gebruiken of niet langer reageren.

Om de trage laad- en reactietijd bij het analyseren van grote traceringsbestanden te voorkomen, biedt de Service Trace Viewer een functie met de naam 'Gedeeltelijk laden', waarmee slechts een klein deel van de tracering tegelijk wordt geladen. U kunt bijvoorbeeld een traceringsbestand van meer dan 1 GB hebben, dat enkele dagen op de server wordt uitgevoerd. Wanneer er enkele fouten zijn opgetreden en u de tracering wilt analyseren, is het niet nodig om het hele traceringsbestand te openen. In plaats daarvan kunt u de traceringen binnen een bepaalde periode laden wanneer de fout is opgetreden. Omdat het bereik kleiner is, kan het hulpprogramma Service Trace Viewer het bestand sneller laden en kunt u de fouten identificeren met behulp van een kleinere set gegevens.

Gedeeltelijk laden inschakelen

U hoeft gedeeltelijk laden niet handmatig in te schakelen. Als de totale grootte van de traceringsbestanden die u probeert te laden groter is dan 40 MB, wordt in Service Trace Viewer automatisch een dialoogvenster voor gedeeltelijk laden weergegeven om het deel te selecteren dat u wilt laden.

Notitie

Omdat traceringen mogelijk niet gelijkmatig in de periode worden verdeeld, is de lengte van de periode die u opgeeft in de werkbalk Gedeeltelijk laden mogelijk niet evenredig met de weergegeven laadgrootte. De werkelijke laadgrootte kan kleiner zijn dan de geschatte grootte in het dialoogvenster voor gedeeltelijk laden.

Gedeeltelijke belasting aanpassen

Nadat u het traceringsbestand gedeeltelijk hebt geladen, kunt u de gegevensset wijzigen die wordt geladen. U kunt dit doen door de werkbalk Gedeeltelijk laden boven aan de viewer aan te passen.

1. Verplaats de werkbalk met de muis of voer de begin- en eindtijd in.

2. Klik op de knop Aanpassen .

Informatie over traceringspictogrammen

Hier volgt een lijst met pictogrammen die het hulpprogramma Service Trace Viewer gebruikt in de activiteitenweergave, de grafiekweergave en het deelvenster Tracering om verschillende items weer te geven.

Notitie

Sommige traceringen die niet zijn gecategoriseerd (bijvoorbeeld 'een bericht is gesloten') hebben geen pictogram.

Traceringen van activiteiten

Pictogram	Beschrijving
	Waarschuwingstracering: een tracering die wordt verzonden op het waarschuwingsniveau
	Fouttracering: een tracering die wordt verzonden op foutniveau.
	Tracering activiteitsstart: een tracering die het begin van een activiteit markeert. Deze bevat de naam van de activiteit. Als toepassingsontwerper of ontwikkelaar moet u één activiteit starten per activiteits-id per proces of thread definiëren. Als de activiteits-id wordt doorgegeven aan traceringsbronnen voor traceringscorrelatie, kunt u meerdere starts voor dezelfde activiteits-id (één per traceringsbron) zien. De starttracering wordt verzonden als ActivityTracing is ingeschakeld voor de traceringsbron.
	Tracering activiteitsstop: een tracering die het einde van een activiteit markeert. . Deze bevat de naam van de activiteit. Als toepassingsontwerper of ontwikkelaar moet u één activiteit stoppen per activiteits-id per traceringsbron definiëren. Er worden geen traceringen van een bepaalde traceringsbron weergegeven nadat de activiteit Stoppen die door die traceringsbron is verzonden, behalve als de granulariteit van de traceringstijd niet voldoende klein is. Wanneer dat gebeurt, kunnen twee traceringen met dezelfde tijd, inclusief een stop, worden interleaved wanneer ze worden weergegeven. Als de activiteits-id wordt doorgegeven aan traceringsbronnen voor traceringscorrelatie, ziet u meerdere stops voor dezelfde activiteits-id (één per traceringsbron). De stoptracering wordt verzonden als ActivityTracing is ingeschakeld voor de traceringsbron.
	Tracering activiteit onderbreken: een tracering die de tijd markeert waarop een activiteit is onderbroken. Er worden geen traceringen verzonden in een onderbroken activiteit totdat de activiteit wordt hervat. Een onderbroken activiteit geeft aan dat er geen verwerking plaatsvindt in die activiteit binnen het bereik van de traceringsbron. Traceringen onderbreken/hervatten zijn handig voor profilering. De tracering onderbreken wordt verzonden als ActivityTracing is ingeschakeld voor de traceringsbron.
	Tracering van activiteits hervat: een tracering die de tijd markeert waarop een activiteit wordt hervat nadat deze is onderbroken. Traceringen kunnen opnieuw worden verzonden in die activiteit. Traceringen onderbreken/hervatten zijn handig voor profilering. De tracering hervatten wordt verzonden als ActivityTracing is ingeschakeld voor de traceringsbron.
	Overdracht: Een tracering die wordt verzonden wanneer de logische controlestroom wordt overgedragen van de ene activiteit naar de andere. De activiteit waaruit de overdracht afkomstig is, kan parallel blijven werken aan de activiteit waar de overdracht naartoe gaat. De overdrachtstracering wordt verzonden als ActivityTracing is ingeschakeld voor de traceringsbron.
	Overdracht van: Een tracering die een overdracht van een andere activiteit naar de huidige activiteit definieert.
	Overdracht naar: Een tracering die een overdracht van een logische controlestroom van de huidige activiteit naar een andere activiteit definieert.

WCF-traceringen

Pictogram	Beschrijving
	Berichtlogboektracering: een tracering die wordt verzonden wanneer een WCF-bericht wordt geregistreerd door de functie voor berichtlogboekregistratie, wanneer de System.ServiceModel.MessageLogging traceringsbron is ingeschakeld. Als u op deze trace klikt, wordt het bericht weergegeven. Er zijn vier configureerbare logboekregistratiepunten voor een bericht: ServiceLevelSendRequest, TransportSend, TransportReceive en ServiceLevelReceiveRequest, die ook kunnen worden opgegeven door het messageSource kenmerk in de tracering van het berichtenlogboek.
	Bericht ontvangen trace: een tracering die wordt verzonden wanneer een WCF-bericht wordt ontvangen, als de System.ServiceModel traceringsbron is ingeschakeld op informatie- of uitgebreid niveau. Deze tracering is essentieel voor het weergeven van de correlatiepijl van het bericht in de weergave Activiteitsgrafiek.
	Bericht verzonden trace: een tracering die wordt verzonden wanneer een WCF-bericht wordt verzonden als de System.ServiceModel traceringsbron is ingeschakeld op informatie- of uitgebreid niveau. Deze tracering is essentieel voor het weergeven van de correlatiepijl van het bericht in de weergave Activiteitsgrafiek.

Activiteiten

Pictogram	Beschrijving
	Activiteit: Geeft aan dat de huidige activiteit een algemene activiteit is.
	Hoofdactiviteit: geeft de hoofdactiviteit van een proces aan.

WCF-activiteiten

Pictogram	Beschrijving
	Omgevingsactiviteit: een activiteit die een WCF-host of -client maakt, opent of sluit. Fouten die tijdens deze fasen zijn opgetreden, worden in deze activiteit weergegeven.
	Luisteractiviteit: een activiteit die traceringen registreert die betrekking hebben op een listener. Binnen deze activiteit kunnen we listenergegevens en verbindingsaanvragen bekijken.
	Activiteit Bytes ontvangen: een activiteit die alle traceringen groepeert die betrekking hebben op het ontvangen van binnenkomende bytes op een verbinding tussen twee eindpunten. Deze activiteit is essentieel bij het correleren van vervoersactiviteiten die hun activiteits-id zoals http.sys doorgeven. Verbinding maken iefouten, zoals afgebroken, worden in deze activiteit weergegeven.
	Activiteit Bericht verwerken: een activiteit die traceringen groeperen die betrekking hebben op het maken van een WCF-bericht. Fouten als gevolg van een ongeldige envelop of een onjuist ingedeeld bericht worden weergegeven in die activiteit. Binnen deze activiteit kunnen we berichtkoppen inspecteren om te zien of een activiteits-id is doorgegeven vanuit de beller. Als dit waar is, kunnen we, wanneer we overschakelen naar de activiteit Procesactie (het volgende pictogram), ook de doorgegeven activiteits-id toewijzen voor correlatie tussen de traceringen van de beller en de aanroeper.
	Activiteit procesactie: een activiteit die alle traceringen groepeert die betrekking hebben op een WCF-aanvraag in twee eindpunten. Als propagateActivity dit is ingesteld true op beide eindpunten in de configuratie, worden alle traceringen van beide eindpunten samengevoegd in één activiteit voor directe correlatie. Deze activiteit bevat fouten als gevolg van transport- of beveiligingsverwerking, die wordt uitgebreid naar de grens van de gebruikerscode en terug (als er een antwoord bestaat).
	Gebruikerscodeactiviteit uitvoeren: een activiteit waarmee gebruikerscodetraceringen worden gegroepeerd voor het verwerken van een aanvraag.

Probleemoplossing

Als u niet gemachtigd bent om naar het register te schrijven, wordt het volgende foutbericht weergegeven: 'De Microsoft Service Trace Viewer is niet geregistreerd bij het systeem' wanneer u de opdracht 'svctraceviewer /register' gebruikt om het hulpprogramma te registreren. Als dit het geval is, moet u zich aanmelden met een account met schrijftoegang tot het register.

Daarnaast schrijft het hulpprogramma Service Trace Viewer enkele instellingen (bijvoorbeeld aangepaste filters en filteropties) naar het bestand SvcTraceViewer.exe.settings in de assemblymap. Als u geen leesmachtiging voor het bestand hebt, kunt u het hulpprogramma nog steeds starten, maar kunt u de instellingen niet laden.

Als u het foutbericht 'Er is een onbekende fout opgetreden tijdens het verwerken van een of meer traceringen' wordt weergegeven bij het openen van het ETL-bestand, betekent dit dat de indeling van het ETL-bestand ongeldig is.

Als u een traceringslogboek opent dat is gemaakt met een Arabisch besturingssysteem, ziet u mogelijk dat het tijdfilter niet werkt. Jaar 2005 komt bijvoorbeeld overeen met jaar 1427 in de Arabische kalender. Het tijdsbereik dat wordt ondersteund door het hulpprogrammafilter Service Trace Viewer biedt echter geen ondersteuning voor een datum die ouder is dan 1752. Dit kan betekenen dat u geen juiste datum in het filter kunt selecteren. U kunt dit probleem oplossen door een aangepast filter (Weergave/aangepaste filters) te maken met behulp van een XPath-expressie om een specifiek tijdsbereik op te nemen.

Zie ook

• Service Trace Viewer gebruiken voor het weergeven van gecorreleerde traceringen en probleemoplossing
• Tracering configureren
• End-to-end tracering