Service Trace Viewer tool (SvcTraceViewer.exe)
A Windows Communication Foundation (WCF) szolgáltatáskövetési eszközével elemezheti a WCF által létrehozott diagnosztikai nyomkövetéseket. A Service Trace Viewer lehetővé teszi a nyomkövetési üzenetek egyszerű egyesítését, megtekintését és szűrését a naplóban, így diagnosztizálhatja, kijavíthatja és ellenőrizheti a WCF szolgáltatással kapcsolatos problémákat.
Nyomkövetés konfigurálása
A diagnosztikai nyomkövetések olyan információkat biztosítanak, amelyek bemutatják, mi történik az alkalmazás működése során. Ahogy a neve is mutatja, a műveleteket a forrástól a célig és a köztes pontokon keresztül is követheti.
A nyomkövetést az alkalmazás konfigurációs fájljával konfigurálhatja – webalapú alkalmazások web.konfigurációja vagy saját üzemeltetésű alkalmazásokhoz készült Appname.config használatával. Például:
<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>
Ebben a példában meg van adva a nyomkövetési figyelő neve és típusa. A figyelő neve sdt és a standard .NET-keretrendszer nyomkövetési figyelő (System.Diagnostics.XmlWriterTraceListener) lesz hozzáadva típusként. Az initializeData attribútum a figyelő SdrConfigExample.e2enaplófájljának nevének beállítására szolgál. A naplófájlban egy teljesen minősített elérési utat helyettesíthet egy egyszerű fájlnévvel.
A példa létrehoz egy fájlt az SdrConfigExample.e2e gyökérkönyvtárban. Ha a Nyomkövetési megjelenítővel nyitja meg a fájlt a "WCF-nyomkövetési fájlok megnyitása és megtekintése" szakaszban leírtak szerint, az összes elküldött üzenet megjelenik.
A nyomkövetési szintet a switchValue beállítás szabályozza. Az elérhető nyomkövetési szinteket az alábbi táblázat ismerteti.
| Nyomkövetési szint | Leírás |
|---|---|
| Kritikus | - Naplózza a feladat-gyors és az eseménynapló bejegyzéseit, valamint a nyomkövetés korrelációs adatait. Az alábbiakban néhány példát láthat arra, hogy mikor használhatja a kritikus szintet: - Az AppDomain nem kezelt kivétel miatt leállt. - Az alkalmazás nem indul el. - A hibát okozó üzenet a folyamat MyApp.exe származik. |
| Hiba | - Naplózza az összes kivételt. A hibaszintet a következő helyzetekben használhatja: - A kód egy érvénytelen leadott kivétel miatt összeomlott. - A "végpont létrehozása sikertelen" kivétel miatt az alkalmazás indításkor meghiúsul. |
| Figyelmeztetés | - Létezik olyan feltétel, amely később hibát vagy kritikus hibát eredményezhet. Ezt a szintet a következő helyzetekben használhatja: - Az alkalmazás több kérést kap, mint amennyit a szabályozási beállítások megengednek. - A fogadó üzenetsor a konfigurált kapacitás 98 százalékában található. |
| Tájékoztatás | – A rendszerállapot figyeléséhez és diagnosztizáléséhez, a teljesítmény méréséhez vagy a profilkészítéshez hasznos üzenetek jönnek létre. Ezeket az információkat felhasználhatja a kapacitástervezéshez és a teljesítménykezeléshez. Ezt a szintet a következő helyzetekben használhatja: - Hiba történt, miután az üzenet elérte az AppDomaint, és deszerializálva lett. - Hiba történt a HTTP-kötés létrehozása közben. |
| Részletezés | - Hibakeresési szintű nyomkövetés a felhasználói kódhoz és a karbantartáshoz. Ezt a szintet a következő esetekben állíthatja be: - Nem biztos abban, hogy a kód melyik metódusát hívták meg a hiba bekövetkezésekor. – Helytelen végpont van konfigurálva, és a szolgáltatás nem indult el, mert a foglalási tár bejegyzése zárolva van. |
| ActivityTracing | Folyamatesemények a feldolgozási tevékenységek és összetevők között. Ez a szint lehetővé teszi, hogy a rendszergazdák és a fejlesztők egy adott alkalmazástartományban lévő alkalmazásokat korreláljanak. - Tevékenységhatárok nyomkövetése: start/stop. - Nyomkövetések átvitelekhez. |
Megadhatja add a használni kívánt nyomkövetési figyelő nevét és típusát. A példakonfigurációban a figyelő neve sdt és a standard .NET-keretrendszer nyomkövetési figyelő (System.Diagnostics.XmlWriterTraceListener) lesz hozzáadva típusként. A figyelő naplófájljának nevének beállítására használható initializeData . Emellett egy teljesen minősített elérési utat is helyettesíthet egy egyszerű fájlnévre.
A .NET-keretrendszer 4.8-tól kezdődően néhány kontrasztos téma Kombinált lista vezérlői a megfelelő színnel jelennek meg. A módosítás letiltásához távolítsa el a következő beállítást a svcTraceViewer.exe.config fájlból:
<AppContextSwitchOverrides value="Switch.UseLegacyAccessibilityFeatures=false;Switch.UseLegacyAccessibilityFeatures.2=false" />
A Service Trace Viewer eszköz használata
WCF-nyomkövetési fájlok megnyitása és megtekintése
A Service Trace Viewer három fájltípust támogat:
WCF nyomkövetési fájl (.svcLog)
Eseménykövetési fájl (.etl)
Crimson-nyomkövetési fájl
A Service Trace Viewer lehetővé teszi a támogatott nyomkövetési fájlok megnyitását, további nyomkövetési fájlok hozzáadását és integrálását, illetve a nyomkövetési fájlok egy csoportjának egyidejű megnyitását és egyesítését.
Nyomkövetési fájl megnyitása
- Indítsa el a Service Trace Viewert egy parancsablak használatával a WCF telepítési helyére való navigáláshoz (C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin), majd írja be a kívánt
SvcTraceViewer.exeelemet.
Feljegyzés
A Service Trace Viewer eszköz két fájltípushoz társítható: .svclog és .stvproj. A parancssorban két paramétert használhat a fájlkiterjesztések regisztrálásához és regisztrációjának törléséhez.
/register: regisztrálja a ".svclog" és a ".stvproj" fájlkiterjesztések társítását SvcTraceViewer.exe
/unregister: unregister the association of file extensions ".svclog" and ".stvproj" with SvcTraceViewer.exe
Amikor elindul a Szolgáltatáskövetési megjelenítő, kattintson a Fájl gombra, majd mutasson a Megnyitás gombra. Keresse meg a nyomkövetési fájlok tárolási helyét.
Kattintson duplán a megnyitni kívánt nyomkövetési fájlra.
Feljegyzés
A SHIFT billentyűt lenyomva több nyomkövetési fájlra kattintva kijelölheti és megnyithatja őket egyszerre. A Service Trace Viewer egyesíti az összes fájl tartalmát, és egy nézetet jelenít meg. Megnyithatja például az ügyfél és a szolgáltatás nyomkövetési fájljait is. Ez akkor hasznos, ha engedélyezte az üzenetek naplózását és a tevékenységek propagálását a konfigurációban. Ily módon megvizsgálhatja az ügyfél és a szolgáltatás közötti üzenetcserét. Több fájlt is áthúzhat a megtekintőbe, vagy használhatja a Project lapot. További részletekért tekintse meg a Projekt kezelése szakaszt.
Ha további nyomkövetési fájlokat szeretne hozzáadni a megnyitott gyűjteményhez, kattintson a Fájl gombra, majd mutasson a Hozzáadás gombra. A megnyíló ablakban keresse meg a nyomkövetési fájlok helyét, és kattintson duplán a hozzáadni kívánt fájlra.
Figyelemfelhívás
Nem ajánlott 200 MB-nál nagyobb nyomkövetési naplófájlt betölteni. Ha ennél a korlátnál nagyobb fájlt próbál betölteni, a betöltési folyamat a számítógép erőforrásától függően hosszú időt vehet igénybe. Előfordulhat, hogy a Service Trace Viewer eszköz hosszú ideig nem válaszol, vagy kimeríti a gép memóriáját. Ennek elkerülése érdekében javasoljuk, hogy a részleges betöltést konfigurálja. Ennek módjáról további információt a "Nagy nyomkövetési fájlok betöltése" című szakaszban talál.
Eseménykövetés és Crimson-nyomkövetés
A megtekintő natív formátuma a WCF által kibocsátott tevékenységkövetési formátum. A más formátumban kibocsátott nyomkövetéseket konvertálni kell, mielőtt a megtekintő megjelenítené őket. Jelenleg a tevékenységkövetési formátum mellett a megtekintő támogatja az eseménykövetést és a krimson-nyomkövetést.
Ha olyan fájlt nyit meg, amely nem tartalmaz tevékenységkövetéseket, a megtekintő megpróbálja átalakítani a fájlt. Meg kell adnia a konvertált nyomkövetési adatokat tartalmazó fájl nevét és helyét. Az adatok konvertálása után a megtekintő megjeleníti az új fájl tartalmát.
Feljegyzés
Az átalakításhoz lemezterület szükséges a konvertált nyomkövetési adatok tárolásához. A konvertálás megkezdése előtt győződjön meg arról, hogy elegendő lemezterület áll rendelkezésre az adatok tárolásához. Ellenkező esetben az átalakítás meghiúsul.
Projektek kezelése
A megtekintő több nyomkövetési fájl megtekintését megkönnyítő projekteket támogat. Ha például ügyfél-nyomkövetési fájllal és szolgáltatás-nyomkövetési fájllal rendelkezik, felveheti őket egy projektbe. Ezután a projekt minden megnyitásakor a projekt összes nyomkövetési fájlja egyszerre lesz betöltve.
A projektek kétféleképpen kezelhetők:
A Fájl menüben megnyithatja, mentheti és bezárhatja a projekteket.
A Projekt lapon fájlokat adhat hozzá egy projekthez.
WCF-nyomkövetések megtekintése
A WCF nyomkövetéseket bocsát ki a tevékenységkövetési formátum használatával. A tevékenységkövetési modellben az egyes nyomkövetések tevékenységekbe vannak csoportosítva a céljuknak megfelelően. A logikai vezérlőfolyamat át lesz osztva a tevékenységek között. Egy alkalmazás élettartama alatt például számos "üzenetküldési tevékenység" jelenik meg és tűnik el. A nyomkövetések és tevékenységek megtekintéséről, valamint a Szolgáltatás nyomkövetési megjelenítőjének felhasználói felületéről további információt a Service Trace Viewer használata a korrelált nyomkövetések és hibaelhárítás megtekintéséhez című témakörben talál.
Váltás különböző nézetekre
A Service Trace Viewer a következő különböző nézeteket biztosítja. A Megtekintő bal oldali ablaktábláján lapként jelennek meg, és a Nézet menüből is elérhetők.
Tevékenység nézet
Projektnézet
Üzenetnézet
Gráfnézet
Tevékenység nézet
A nyomkövetési fájlok megnyitása után a nyomkövetések tevékenységekbe vannak csoportosítva, és a bal oldali panel Tevékenység nézetében jelennek meg.
A Tevékenység nézet megjeleníti a tevékenység nevét, a tevékenységben lévő nyomkövetések számát, az időtartamot, a kezdési időt és a befejezési időt.
A felsorolt tevékenységek bármelyikére kattintva a tevékenységben lévő nyomkövetések megjelennek a jobb oldali nyomkövetési panelen. Ezután kiválaszthat egy nyomkövetést a részleteinek megtekintéséhez.
Több tevékenységet is kijelölhet a Ctrl vagy a Shift billentyű lenyomásával, majd a kívánt tevékenységekre kattintva. A nyomkövetési panel megjeleníti a kijelölt tevékenységek összes nyomkövetését.
Egy tevékenységre duplán kattintva megjelenítheti azt Graph nézetben. Másik lehetőségként válasszon ki egy tevékenységet, és váltson a Graph View nézetre.
Feljegyzés
A "000000000000" tevékenység egy speciális tevékenység, amely nem jeleníthető meg a Gráf nézetben. Mivel minden más tevékenység hozzá van kapcsolva, a tevékenység megjelenítése súlyos teljesítménybeli hatással van.
A tevékenységlista rendezéséhez kattintson az oszlop címére. A figyelmeztető nyomokat tartalmazó tevékenységek háttere sárga, a hibanyomokat tartalmazó tevékenységeké pedig piros.
Különböző típusú tevékenységek léteznek, és mindegyik típus egy ikonnak felel meg az egyes tevékenységek bal oldalán. A jelentésükért tekintse meg a Nyomkövetési ikonok ismertetése szakaszt.
Projektnézet
Ez a nézet lehetővé teszi a nyomkövetési fájlok kezelését az aktuális projektben. További részletekért tekintse meg a Projekt kezelése szakaszt.
Üzenetnézet
Ez a nézet lehetővé teszi az összes üzenetnapló-nyomkövetés megtekintését, beleértve a művelet, a dátum/idő, a folyamat, a tevékenység és a feladó/címzett nyomkövetést, és navigálhat a társított üzenetnapló-nyomkövetés részleteire. Az üzenetnapló-nyomkövetéseket a tevékenységhatár, a folyamat/szál vagy a Küldés és fogadás szerint csoportosíthatja az üzenetfolyam könnyebb navigálásához.
Gráfnézet
Ez a nézet egy adott tevékenység nyomkövetési adatait jeleníti meg diagram formájában. A diagraműrlapon megtekintheti az események lépésenkénti végrehajtását és a több tevékenység közötti összefüggéseket, miközben az adatok mozognak közöttük.
Ha Gráfnézetreszeretne váltani, jelöljön ki egy tevékenységet a Tevékenység nézetben, majd kattintson a Tevékenység fülre, vagy egy üzenetnapló-nyomkövetésre az Üzenet nézetben. Ha több nyomkövetési fájl van betöltve, és a tevékenység több fájlból is tartalmaz nyomkövetést, az összes releváns nyomkövetés megjelenik a gráfnézetben. A tevékenységekre és az üzenetnaplók nyomkövetésére duplán kattintva a Graph nézethez is el kell jutnia.
Gráf nézetben minden függőleges oszlop egy tevékenységet jelöl, az oszlop minden blokkja pedig egy nyomkövetést. A tevékenységek folyamat (vagy szál) szerint vannak csoportosítva. A tevékenységek közötti kis nyilak átviteleket jelölnek. A folyamatok közötti nagy nyilak az üzenetcserét jelölik. A kijelölési tevékenység mindig sárga színű.
Nyomkövetések kiválasztása a gráfban
Kattintson egy blokkra a gráfban.
A fel- és le billentyűkkel válassza ki a szomszédos nyomkövetéseket.
Figyelje meg a nyomkövetési információkat a Nyomkövetés panelen és a Részletek panelen.
Tevékenységátvitelek kibontása vagy összecsukása
Kibonthatja a tevékenységátviteleket, ha a kijelölésben szereplő tevékenység átkerül egy másik tevékenységbe. Lehetővé teszi az átvitelek követését.
Tevékenységátvitelek kibontásához vagy összecsukásához
Keresse meg az átviteli nyomkövetést az átviteli ikon bal oldalán található "+" jellel.
Kattintson a "+" gombra, vagy nyomja le a Ctrl és a "+" billentyűkombinációt a billentyűzettel.
A következő tevékenység megjelenik a gráfban.
Az átvitel ikon bal oldalán megjelenik egy "-" szöveg. Kattintson a "-" jelre, vagy nyomja le a Ctrl és a "-" billentyűkombinációt, a tevékenységátvitel összecsukható.
Feljegyzés
Ha egy tevékenység több átvitelt is tartalmaz, és kibontja az egyik átvitelt, megjelennek azok a tevékenységek, amelyek a gyökértevékenységből az új tevékenységhez vezetnek. Ezek az új tevékenységek összecsukott formában jelennek meg. Ha meg szeretné tekinteni ezeknek a tevékenységeknek a részleteit, akkor függőlegesen bontsa ki őket a gráf fejlécében található kibontás ikonra kattintva.
Tevékenységek vertikális kibontása vagy összecsukása
A megtekintő a tevékenységek összecsukásával elrejti a felesleges részleteket a tevékenységgráfban. Összecsukott tevékenységekben az egyes nyomkövetések nem jelennek meg. Csak az átvitelek nyomkövetése jelenik meg. Ha egy tevékenység összes nyomát meg szeretné tekinteni, bontsa ki függőlegesen a tevékenységet a tevékenység kibontási jelére kattintva a gráf fejlécében.
Tevékenységek függőleges kibontásához vagy összecsukásához
A tevékenység fejlécében kattintson a "+" ikonra a tevékenység függőleges kibontásához.
Figyelje meg, hogy az összes nyomkövetés megjelenik a gráfban.
A tevékenység fejlécében található "-" ikonra kattintva függőlegesen összecsukhatja a tevékenységet.
Figyelje meg, hogy a tevékenységben csak a fontos átvitelek, üzenetnaplók, figyelmeztetési és kivételkövetések jelennek meg.
Beállítások
A Graph nézetben a Beállítás menüből két lehetőséget választhat.
Tevékenységhatár-nyomkövetések megjelenítése, amelyek ha nincs bejelölve, figyelmen kívül hagyják a gráf tevékenységhatár-nyomkövetéseit.
Nem üzenetes részletes nyomkövetések megjelenítése, amelyek ha nincs bejelölve, figyelmen kívül hagyják a részletes szintű nyomkövetéseket, kivéve az üzenetkövetéseket. A legtöbb esetben a részletes szintű nyomkövetések kevésbé fontosak az elemzéshez. Ez a beállítás akkor hasznos, ha nem szeretne részletes szintű nyomkövetéseket elemezni, és csak a fontosabb nyomkövetésekre szeretne összpontosítani.
Elrendezési mód
A megjelenítő két elrendezési móddal rendelkezik: folyamat és szál. Ez a beállítás határozza meg a legnagyobb szervezeti egységet. Az alapértelmezett elrendezési mód a Folyamat, ami azt jelenti, hogy a tevékenységek a gráf folyamatai szerint vannak csoportosítva.
Végrehajtási lista
A legördülő listában kiválaszthatja, hogy melyik folyamat vagy szál jelenjen meg a gráfban. Ha például két ügyfél (A és B) és egy szolgáltatás nyomkövetési fájljait nyitotta meg, és csak a szolgáltatást és az A ügyfelet szeretné megjeleníteni a gráfban, a B ügyfelet a listából törölheti.
Nyomkövetés részleteinek megtekintése
A nyomkövetés részleteinek megtekintéséhez jelöljön ki egy nyomkövetést a Nyomkövetés panelen. A részletek a Részletek panelen jelennek meg.
Nyomkövetési ablaktábla
A Szolgáltatás nyomkövetési megjelenítőjének jobb felső ablaktáblája a Nyomkövetés ablaktábla. Felsorolja a kijelölt tevékenység összes nyomkövetését további információkkal, például nyomkövetési szinttel, szálazonosítóval és folyamatnévvel.
A nyomkövetés nyers XML-fájlját a vágólapra másolhatja úgy, hogy a jobb gombbal kattint egy nyomkövetésre, és kiválasztja a Nyomkövetés másolása vágólapra lehetőséget.
Részletek ablaktábla
A Szolgáltatáskövetés-megjelenítő bal alsó ablaktáblája a Részletek ablaktábla. Három fület biztosít a nyomkövetési adatok megtekintéséhez.
A Formázott nézet rendezettebb módon jeleníti meg az információkat. Felsorolja a táblák és fák összes ismert XML-elemét, így könnyebben olvashatók és értelmezhetők az információk.
Az XML-nézetben a kijelölt nyomkövetésnek megfelelő XML jelenik meg. Támogatja a kiemelést és a szintaxis színét. Ha a Keresés parancsot használja a sztringek keresésére, az kiemeli a keresési eredményeket.
Az Üzenet nézet az XML üzenetrészét jeleníti meg az üzenetnapló-nyomkövetésekben. Ez nem látható, ha nem üzenetkövetést választ.
WCF-nyomkövetések szűrése
A nyomkövetés elemzésének megkönnyítése érdekében a következő módokon szűrheti őket:
A szűrőpult hozzáférést biztosít az előre definiált és egyéni szűrőkhöz. A Nézet menüben engedélyezhető.
A megtekintő előre definiált szűrője a WCF-nyomkövetések egyes részeinek szelektív szűrésére használható. Alapértelmezés szerint úgy van beállítva, hogy minden infrastruktúra-nyomkövetés áthaladjon rajta. A szűrő beállításai a Nézet menü Szűrőbeállítások almenüjében vannak definiálva.
Az egyéni XPath-szűrők teljes körű ellenőrzést biztosítanak a felhasználók számára a szűrés felett. Ezek definiálhatók a Nézet menü Egyéni szűrőmenüjében.
Csak az összes szűrőn áthaladó nyomkövetések jelennek meg.
A szűrőpult használata
A szűrő eszköztár az eszköz tetején jelenik meg. Ha nincs jelen, a Nézet menüben aktiválhatja. A sáv három összetevőből áll:
Keresés: A keresés a szűrőműveletben keresendő tárgyat határozza meg. Ha például az X folyamat kontextusában kibocsátott összes nyomkövetést meg szeretné keresni, állítsa ezt a mezőt X értékre, a Keresés mezőben pedig a "Folyamat neve" értékre. Ez a mező dátumalapú szűrő kiválasztásakor Dátum/idő választó vezérlőelemre változik.
Keresés a következőben: Ez a mező határozza meg az alkalmazandó szűrő típusát.
Szint: A szintbeállítás határozza meg a szűrő által megengedett minimális nyomkövetési szintet. Ha például a szint Hiba és Fel értékre van állítva, csak a hiba és a kritikus szinten lévő nyomkövetések jelennek meg. Ez a szűrő kombinálja a Keresés és a Keresés funkció által megadott feltételekkel.
A Szűrő most gomb elindítja a szűrési műveletet. Egyes szűrők, különösen nagy adathalmazokra való alkalmazása esetén hosszú időt vesz igénybe. A szűrőművelet megszakításához nyomja le a Művelet menü állapotsorában megjelenő Leállítás gombot.
A Törlés gomb alaphelyzetbe állítja az előre definiált és egyéni szűrőket, hogy az összes nyomkövetés áthaladhasson.
Szűrési beállítások
A megjelenítő automatikusan eltávolíthatja a WCF-nyomkövetéseket a nézetből. Szelektíven eltávolíthatja a WCF adott területei által kibocsátott nyomkövetéseket, például eltávolíthatja a tranzakcióval kapcsolatos nyomkövetéseket a nézetből.
A szűrő beállításai a Nézet menü Szűrőbeállítások almenüjében vannak definiálva.
Egyéni szűrők
Ha ismeri az XML Path Language (XPath) nyelvet, egyéni szűrőket hozhat létre a nyomkövetési adatok kereséséhez bármely érdekes XML-elemhez. A szűrők a szűrő eszköztárán keresztül érhetők el.
Az egyéni szűrők tartalmazhatnak paramétereket. A már meglévő egyéni szűrőket is importálhatja.
Egyéni szűrő létrehozása
A szűrők kétféleképpen hozhatók létre:
Egyéni szűrő létrehozása a Sablon varázslóval
Kattintson egy meglévő nyomkövetésre, és hozzon létre egy szűrőt a nyomkövetés struktúrája alapján. Ez a példa egy egyéni szűrőt hoz létre a szálazonosító alapján.
A megjelenítő jobb felső részén található nyomkövetési panelen válasszon ki egy nyomkövetést, amely tartalmazza a szűrni kívánt elemet.
Kattintson a nyomkövetési panel tetején található Egyéni szűrő létrehozása gombra.
A megjelenő párbeszédpanelen adja meg a szűrő nevét. Ebben a példában adja meg a következőt
Thread ID: A szűrő leírását is megadhatja.A bal oldali fanézet az 1. lépésben kiválasztott nyomkövetési rekord struktúráját jeleníti meg. Keresse meg azt az elemet, amelyhez feltételt szeretne létrehozni. Ebben a példában keresse meg a Szálazonosítót, amely az XPath: /E2ETraceEvent/System/Execution/@ThreadID csomópontban található. Kattintson duplán a ThreadID attribútumra a fa nézetben. Ez létrehoz egy kifejezést az attribútumhoz a párbeszédpanel jobb oldalán.
Módosítsa a ThreadID feltétel paramétermezőjének értékét a None (Nincs{0}) paraméterre. Ez a lépés lehetővé teszi a ThreadID érték konfigurálását a szűrő alkalmazásakor. (Lásd a Szűrő alkalmazása szakaszt) Legfeljebb négy paraméter definiálható. A feltételek az OR operátorral vannak kombinálva.
Kattintson az OK gombra a szűrő létrehozásához.
Feljegyzés
Miután létrehozott egy szűrőt a sablonvarázslóval, csak manuálisan szerkeszthető. A korábban létrehozott szűrőhöz nem lehet aktiválni a varázslót. Emellett a sablonvarázslóban létrehozott XPath-szűrő feltételei az OR operátorral vannak kombinálva. Ha AND műveletet igényel, a szűrőkifejezést a létrehozás után szerkesztheti.
Egyéni szűrő manuális létrehozása
Az Egyéni szűrők menü lehetővé teszi az XPath-szűrők manuális megadását.
A Nézet menüben kattintson az Egyéni szűrők menüelemre .
A megjelenő párbeszédpanelen kattintson az Új gombra .
Legalább adjon meg egy szűrőnevet és egy XPath-kifejezést.
Kattintson az OK gombra.
Egyéni szűrő alkalmazása
Miután létrehozott egy egyéni szűrőt, a szűrő eszköztára is elérhető lesz. Válassza ki a szűrő eszköztár Keresés mezőjében alkalmazni kívánt szűrőt. Az előző példában válassza a "Szálazonosító" lehetőséget.
Adja meg a keresett értéket a Keresett érték mezőben. A példában adja meg annak a szálnak az azonosítóját, amelyet keresni szeretne.
Kattintson a Szűrés most gombra, és figyelje meg a művelet eredményét.
Ha a szűrő több paramétert használ, adja meg őket a ";" elválasztó elemként a Keresés mit mezőben. A következő sztring például 3 paramétert határoz meg: "1; findValue; szöveg". A megjelenítő az "1" paramétert alkalmazza a {0} szűrő paraméterére. A rendszer a "findValue" és a "text" szöveget alkalmazza, illetve {2} azokra is.{1}
Egyéni szűrők megosztása
Az egyéni szűrők különböző munkamenetek és különböző felhasználók között oszthatók meg. A szűrőket exportálhatja egy definíciós fájlba, és importálhatja ezt a fájlt egy másik helyre.
Egyéni szűrő importálása:
A Nézet menüben kattintson az Egyéni szűrők elemre.
A megnyíló párbeszédpanelen kattintson az Importálás gombra.
Lépjen az egyéni szűrőfájlra (.stvcf), kattintson a fájlra, és kattintson a Megnyitás gombra.
Egyéni szűrő exportálása:
A Nézet menüben kattintson az Egyéni szűrők elemre.
A megnyíló párbeszédpanelen válassza ki az exportálni kívánt szűrőt.
Kattintson az Exportálás gombra.
Adja meg az egyéni szűrődefiníciós fájl (.stvcf) nevét és helyét, majd kattintson a Mentés gombra.
Feljegyzés
Ezek az egyéni szűrők csak a Service Trace Viewerből importálhatók és exportálhatók. Más eszközök nem tudják olvasni őket.
Adatok keresése
A megjelenítő a következő módszereket kínálja az adatok keresésére:
A Keresés eszköztár gyors hozzáférést biztosít a leggyakoribb keresési lehetőségekhez.
A Keresés párbeszédpanel további keresési lehetőségeket biztosít. Elérhető a Szerkesztés menüben vagy a Ctrl + F billentyűkombinációval.
A keresési eszköztár a megtekintő tetején jelenik meg. Ha nincs jelen, a Nézet menüben aktiválhatja. A sáv két összetevőből áll:
Keresés: Lehetővé teszi a keresési kulcsszó megadását.
Look In: Lehetővé teszi a keresési tartomány megadását. Kiválaszthatja, hogy az összes tevékenységben vagy csak az aktuális tevékenységben szeretne-e keresni.
A keresés párbeszédpanelen két további lehetőség érhető el:
Cél keresése:
A "Nyers naplóadatok" lehetőség az összes nyers adatban megkeresi a kulcsszót.
Az "XML-szöveg" és az "XML-attribútum" beállítás csak XML-elemekben keres.
A "Naplózott üzenet" beállítás csak az üzenetekben keres a kulcsszóban.
Gyökértevékenység mellőzése: A keresés figyelmen kívül hagyja a "000000000000" tevékenység nyomkövetéseit. Ez javítja a nagy nyomkövetési fájlok teljesítményét, ha a gyökértevékenység több ezer nyomkövetést tartalmaz, amelyek többsége átvitel.
Nyomkövetések navigálása
Mivel a nyomkövetések lépésről lépésre vannak rögzítve az alkalmazás futásideje során, a nyomkövetések navigálása segíthet az alkalmazás hibakeresésében. A Szolgáltatás nyomkövetési megjelenítője különböző módszereket kínál a nyomkövetések közötti navigálásra.
Lépés előre vagy hátra
Ha az egyes nyomkövetéseket kódsorként tekinti a programban, a továbblépés nagyon hasonlít a Visual Studio Integrált Fejlesztési Környezet (IDE) "Lépésre" eleméhez. A különbség az, hogy visszaléphet a nyomkövetésekben is. Az előrelépés azt jelenti, hogy a tevékenység következő nyomkövetésére lép.
Lépés előre: Használja a Tevékenység menüt, vagy nyomja le az "F10" billentyűt. A nyomkövetési panelen a "lefelé" nyílbillentyűt is használhatja.
Visszalépés: Használja a Tevékenység menüt, vagy nyomja le az "F9" billentyűt. A nyomkövetési panelen a "fel" nyílbillentyűt is használhatja.
Feljegyzés
Ez egy másik folyamatban vagy akár egy másik számítógépen zajló tevékenységhez is vezethet, mivel a WCF-üzenetek gépekre kiterjedő tevékenységazonosítókat is tartalmazhatnak.
Átvitel követése
Az átviteli nyomkövetések speciális nyomkövetések a nyomkövetési fájlban. A tevékenységek átviteli nyomkövetéssel átvihetők egy másik tevékenységbe. Az "A" tevékenység például átkerülhet a "B" tevékenységre. Ilyen esetben az "A" tevékenységben van egy átviteli nyomkövetés a "Cél: Tevékenység" névvel és az átvitel ikonnal. Ez az átviteli nyomkövetés a két nyomkövetés közötti kapcsolat. A "B" tevékenységben a tevékenység végén lehet egy átviteli nyomkövetés is, amely visszakerül az "A" tevékenységhez. Ez hasonló a programok függvényhívásaihoz: A B hívás, majd B visszatér.
A "Követés átvitele" hasonló a hibakeresőben lévő "Lépés a következőbe" kifejezéshez. Az A-ból B-be történő átvitelt követi. Nincs hatása más nyomokra.
Az átvitel kétféleképpen követhető: egérrel vagy billentyűzettel:
Egérrel: Kattintson duplán az átviteli nyomkövetésre a nyomkövetési panelen.
Billentyűzettel: Válasszon ki egy átviteli nyomkövetést, és használja az "Átvitel követése" lehetőséget a Tevékenység menüben, vagy nyomja le az "F11" billentyűt
Feljegyzés
Sok esetben, amikor az A tevékenység átkerül a B tevékenységbe, az A tevékenység megvárja, amíg a B tevékenység vissza nem lép az A tevékenységbe. Ez azt jelenti, hogy az A tevékenység nem naplózott nyomkövetést abban az időszakban, amikor a B tevékenység aktív nyomkövetést végez. Előfordulhat azonban, hogy az A tevékenység nem várakozik, és továbbra is naplózza a nyomkövetéseket. Az is lehetséges, hogy a B tevékenység nem kerül vissza az A tevékenységhez. Ezért a tevékenységátvitelek ebben az értelemben még mindig eltérnek a függvényhívásoktól. Graph nézetben jobban megértheti a tevékenységátviteleket.
Ugrás a Következő vagy az Előző átvitelre
Ha több tevékenység kijelölésekor elemzi az aktuális tevékenységet vagy a kijelölt tevékenységeket, érdemes lehet gyorsan megkeresni azokat a tevékenységeket, amelyekbe átviszi őket. A "Jump to next transfer" (Ugrás a következő átvitelre) funkcióval megkeresheti a következő átviteli nyomkövetést a tevékenységben. Miután megtalálta az átviteli nyomkövetést, a "Follow transfer" (Átvitel követése) használatával léphet a következő tevékenységbe.
Ugrás a Következő átvitelre: Használja a Tevékenység menüt, vagy nyomja le a "Ctrl + F10" billentyűkombinációt.
Ugrás az előző átvitelre: Használja a Tevékenység menüt, vagy nyomja le a "Ctrl + F9" billentyűkombinációt.
Navigálás Graph nézetben
Bár a tevékenységpanelen és a nyomkövetési panelen való navigálás hasonló a hibakereséshez, a Graph nézet használata sokkal jobb élményt nyújt a navigációban. További információt a "Graph View" (Gráfnézet) szakaszban talál.
Nagyméretű nyomkövetési fájlok betöltése
A nyomkövetési fájlok nagyon nagyok lehetnek. Ha például bekapcsolja a nyomkövetést a "Részletes" szinten, az eredményként kapott nyomkövetési fájl a hálózati sebességtől és a kommunikációs mintától függően egyszerűen több száz megabájt vagy akár nagyobb is lehet.
Ha egy nagyon nagy nyomkövetési fájlt nyit meg a Szolgáltatás nyomkövetési megjelenítőjében, a rendszer teljesítménye negatívan befolyásolhatja. A betöltési sebesség és a betöltés utáni válaszidő lassú lehet. A tényleges sebesség időről időre eltér a hardverkonfigurációtól függően. A legtöbb pc-n a 200 M-nél nagyobb nyomkövetési fájl betöltése súlyos hatással van a teljesítményre. Az 1G-nél nagyobb nyomkövetési fájlok esetében az eszköz használhatja az összes rendelkezésre álló memóriát, vagy nagyon hosszú ideig leállhat a válaszadás.
A nagy nyomkövetési fájlok elemzésének lassú betöltési és válaszidejének elkerülése érdekében a Service Trace Viewer egy "Részleges betöltés" nevű funkciót biztosít, amely egyszerre csak a nyomkövetés egy kis részét tölti be. Előfordulhat például, hogy egy 1 GB-nál nagyobb nyomkövetési fájl több napig fut a kiszolgálón. Ha hiba történt, és elemezni szeretné a nyomkövetést, nem szükséges megnyitni a teljes nyomkövetési fájlt. Ehelyett betöltheti a nyomkövetéseket egy bizonyos időtartamon belül, amikor a hiba bekövetkezhetett. Mivel a hatókör kisebb, a Service Trace Viewer eszköz gyorsabban betöltheti a fájlt, és kisebb adatkészlettel azonosíthatja a hibákat.
Részleges betöltés engedélyezése
Nem kell manuálisan engedélyeznie a részleges betöltést. Ha a betölteni kívánt nyomkövetési fájl(ok) teljes mérete meghaladja a 40 MB-ot, a Service Trace Viewer automatikusan megjeleníti a Részleges betöltés párbeszédpanelt a betölteni kívánt rész kiválasztásához.
Feljegyzés
Mivel előfordulhat, hogy a nyomkövetések nem egyenletesen oszlanak el az időtartományban, előfordulhat, hogy a részleges betöltési eszköztárban megadott időtartam hossza nem arányos a megjelenített betöltési méretekkel. A tényleges betöltési méret kisebb lehet, mint a részleges betöltési párbeszédpanel becsült mérete.
Részleges betöltés beállítása
Miután részben betöltötte a nyomkövetési fájlt, érdemes lehet módosítania a betöltendő adatkészletet. Ezt a megtekintő tetején található Részleges betöltési eszköztár módosításával teheti meg.
Vigye az eszköztárat egérrel, vagy adja meg a kezdési és befejezési időpontot.
Kattintson a Kiigazítás gombra.
A nyomkövetési ikonok ismertetése
Az alábbiakban felsoroljuk azokat az ikonokat, amelyeket a Service Trace Viewer eszköz a Tevékenység nézetben, a Gráf nézetben és a Nyomkövetés panelen használ a különböző elemek megjelenítéséhez.
Feljegyzés
Egyes nem kategorizált nyomkövetések (például "egy üzenet bezárva") nem rendelkeznek ikonnal.
Tevékenységkövetési nyomkövetések
| Ikon | Leírás |
|---|---|
 |
Figyelmeztetési nyomkövetés: A figyelmeztető szinten kibocsátott nyomkövetés |
 |
Hibakövetés: Hibaszinten kibocsátott nyomkövetés. |
 |
Tevékenységindítási nyomkövetés: Egy tevékenység kezdetét jelző nyomkövetés. A tevékenység nevét tartalmazza. Alkalmazástervezőként vagy fejlesztőként folyamatonként vagy szálonként egy tevékenységindítási nyomkövetést kell meghatároznia tevékenységazonosítónként. Ha a tevékenységazonosítót nyomkövetési korreláció céljából propagálja a nyomkövetési források között, akkor ugyanahhoz a tevékenységazonosítóhoz több indítást is láthat (nyomkövetési forrásonként egyet). A start nyomkövetés akkor lesz kibocsátva, ha az ActivityTracing engedélyezve van a nyomkövetési forráshoz. |
 |
Tevékenység leállítása nyomkövetés: Egy tevékenység végét jelző nyomkövetés. . A tevékenység nevét tartalmazza. Alkalmazástervezőként vagy fejlesztőként nyomkövetési forrásonként egy tevékenység leállítása nyomkövetési azonosítót kell meghatároznia. Az adott nyomkövetési forrásból származó nyomok nem jelennek meg a nyomkövetési forrás által kibocsátott stop tevékenység után, kivéve, ha a nyomkövetési idő részletessége nem elég kicsi. Ha ez történik, két azonos idejű nyomkövetés , köztük a Stop is interleaved lehet, amikor megjelenik. Ha a tevékenységazonosítót nyomkövetési korreláció céljából propagálja a nyomkövetési források között, ugyanazon tevékenységazonosítóhoz több stop is látható (nyomkövetési forrásonként egyet). A leállítási nyomkövetés akkor lesz kibocsátva, ha az ActivityTracing engedélyezve van a nyomkövetési forráshoz. |
 |
Tevékenység felfüggesztése nyomkövetés: A tevékenység szüneteltetési idejét jelző nyomkövetés. A felfüggesztett tevékenységekben a rendszer nem bocsát ki nyomkövetést, amíg a tevékenység nem folytatódik. A felfüggesztett tevékenység azt jelzi, hogy ebben a tevékenységben nem történik feldolgozás a nyomkövetési forrás hatókörében. A felfüggesztési/folytatási nyomkövetések hasznosak a profilkészítéshez. A felfüggesztési nyomkövetés akkor lesz kibocsátva, ha az ActivityTracing engedélyezve van a nyomkövetési forráshoz. |
 |
Tevékenység folytatása nyomkövetése: A tevékenység felfüggesztését követően a tevékenység folytatásának időpontját jelző nyomkövetés. Előfordulhat, hogy a nyomkövetések ismét kibocsáthatók ebben a tevékenységben. A felfüggesztési/folytatási nyomkövetések hasznosak a profilkészítéshez. Az Önéletrajz nyomkövetés akkor lesz kibocsátva, ha az ActivityTracing engedélyezve van a nyomkövetési forráshoz. |
 |
Átvitel: A logikai vezérlési folyamat egyik tevékenységből a másikba történő átvitelekor kibocsátott nyomkövetés. A tevékenység, amelyből az átvitel származik, továbbra is végezheti a munkát az átadással párhuzamosan. Az átviteli nyomkövetés akkor lesz kibocsátva, ha az ActivityTracing engedélyezve van a nyomkövetési forráshoz. |
 |
Átvitel innen: Egy nyomkövetés, amely egy másik tevékenységből az aktuális tevékenységbe való átvitelt határozza meg. |
 |
Átvitel erre: Egy nyomkövetés, amely meghatározza a logikai vezérlési folyamat átvitelét az aktuális tevékenységből egy másik tevékenységbe. |
WCF-nyomkövetések
| Ikon | Leírás |
|---|---|
 |
Üzenetnapló nyomkövetése: Az üzenetnaplózási funkció által naplózott WCF-üzenetek nyomkövetése, amikor a System.ServiceModel.MessageLogging nyomkövetési forrás engedélyezve van. A nyomkövetésre kattintva megjelenik az üzenet. Egy üzenethez négy konfigurálható naplózási pont tartozik: ServiceLevelSendRequest, TransportSend, TransportReceive és ServiceLevelReceiveRequest, amelyeket az messageSource üzenetnapló nyomkövetési attribútuma is megadhat. |
 |
Fogadott üzenet nyomkövetése: Egy WCF-üzenet fogadásakor kibocsátott nyomkövetés, ha a System.ServiceModel nyomkövetési forrás engedélyezve van az Információ vagy a Részletes szinten. Ez a nyomkövetés elengedhetetlen az üzenet korrelációs nyilat az Activity Graph nézetben való megtekintéséhez. |
 |
Üzenetküldési nyomkövetés: Egy WCF-üzenet küldésekor kibocsátott nyomkövetés, ha a System.ServiceModel nyomkövetési forrás engedélyezve van az Információ vagy a Részletes szinten. Ez a nyomkövetés elengedhetetlen az üzenet korrelációs nyilat az Activity Graph nézetben való megtekintéséhez. |
Tevékenységek
| Ikon | Leírás |
|---|---|
 |
Tevékenység: Azt jelzi, hogy az aktuális tevékenység általános tevékenység. |
 |
Gyökértevékenység: Egy folyamat gyökértevékenységét jelzi. |
WCF-tevékenységek
| Ikon | Leírás |
|---|---|
 |
Környezeti tevékenység: WCF-gazdagépet vagy -ügyfelet létrehozó, megnyitó vagy bezáró tevékenység. Az ezekben a fázisokban előforduló hibák megjelennek ebben a tevékenységben. |
 |
Figyelési tevékenység: Olyan tevékenység, amely naplózza a figyelőhöz kapcsolódó nyomkövetéseket. Ebben a tevékenységben megtekintheti a figyelő adatait és a kapcsolatkéréseket. |
 |
Bájtok fogadása tevékenység: Olyan tevékenység, amely a bejövő bájtok fogadásával kapcsolatos összes nyomkövetést két végpont közötti kapcsolaton csoportosítja. Ez a tevékenység elengedhetetlen az olyan szállítási tevékenységekkel való korrelációban, amelyek a tevékenységazonosítójukat propagálják, például http.sys. ebben a tevékenységben Csatlakozás ionhibák, például megszakítások jelennek meg. |
 |
Folyamatüzenet-tevékenység: WCF-üzenet létrehozásához kapcsolódó nyomkövetéseket csoportosító tevékenység. A hibás borítékból vagy hibásan formázott üzenetből eredő hibák megjelennek ebben a tevékenységben. Ebben a tevékenységben az üzenetfejléceket megvizsgálva megállapíthatjuk, hogy a hívótól propagált-e tevékenységazonosítót. Ha ez igaz, a folyamatműveleti tevékenységre (a következő ikonra) való átvitelkor a propagált tevékenység azonosítóját is hozzárendelhetjük a hívó és a hívó nyomkövetései közötti korrelációhoz. |
|
Folyamatműveleti tevékenység: Egy WCF-kérelemhez kapcsolódó összes nyomkövetést két végponton csoportosító tevékenység. Ha propagateActivity a konfiguráció mindkét végpontján be van állítva true , a két végpont összes nyomkövetése egyetlen tevékenységbe egyesül a közvetlen korreláció érdekében. Az ilyen tevékenység átviteli vagy biztonsági feldolgozás miatti hibákat tartalmaz, amelyek a felhasználói kód határáig és vissza (ha van válasz). |
|
Felhasználói kód-tevékenység végrehajtása: Olyan tevékenység, amely felhasználói kódkövetéseket csoportosít egy kérés feldolgozásához. |
Hibaelhárítás
Ha nem rendelkezik engedéllyel a beállításjegyzékbe való íráshoz, a következő hibaüzenet jelenik meg: "A Microsoft Service Trace Viewer nem lett regisztrálva a rendszerben" hibaüzenet jelenik meg, amikor a "svctraceviewer /register" paranccsal regisztrálja az eszközt. Ha ez történik, akkor olyan fiókkal kell bejelentkeznie, amely írási hozzáféréssel rendelkezik a beállításjegyzékhez.
Emellett a Service Trace Viewer eszköz néhány beállítást (például egyéni szűrőket és szűrési beállításokat) ír a SvcTraceViewer.exe.settings fájlba a szerelvénymappájában. Ha nem rendelkezik olvasási engedéllyel a fájlhoz, akkor is elindíthatja az eszközt, de nem töltheti be a beállításokat.
Ha a .etl fájl megnyitásakor az "Ismeretlen hiba történt egy vagy több nyomkövetés feldolgozása során" hibaüzenet jelenik meg, az azt jelenti, hogy az .etl fájl formátuma érvénytelen.
Ha arab operációs rendszerrel létrehozott nyomkövetési naplót nyit meg, észreveheti, hogy az időszűrő nem működik. A 2005-ös év például az 1427-es évnek felel meg arab naptárban. A Service Trace Viewer eszközszűrő által támogatott időtartomány azonban nem támogatja az 1752-nél korábbi dátumot. Ez azt jelentheti, hogy nem tud megfelelő dátumot kiválasztani a szűrőben. A probléma megoldásához létrehozhat egy egyéni szűrőt (nézet-/egyéni szűrőket) egy XPath-kifejezéssel egy adott időtartomány belefoglalásához.