SPDConvert

A(z) SPDConvert használatával mintaprofil-adatokat készíthet elő és kezelhet a mintaprofil-vezérelt optimalizáláshoz (SPGO).

Ez az eszköz korrelálja az SPT-fájlok nyers hardvermintáit az SPD kódstruktúrájában. Ez a lépés végrehajtja a minta korrelációt, a folyamatsimítást és a méret-/sebességdöntéseket, és egy bővített SPD-fájlt hoz létre a folyamatgráfon jegyzetekkel ellátott végrehajtási számokkal.

Egyetlen átalakítással több forrásból, például tesztkörnyezeti teljesítménytesztekből, belső monitorozásból és éles telemetriából származó adatokat kombinálhat. Egy adott forgatókönyv fontosságának hangsúlyozásához többször is megadhatja az SPT-fájlt. Egy kritikus SPT benchmark háromszori felsorolása ténylegesen megháromszorozza a súlyát.

Ez az eszköz három módban működik:

• importálja az .SPT-adatokat egy .SPD-fájlba /SPGO-buildekhez
• beágyazott fájl kinyerése . SPD-fájl egy . PDB
• több .SPD-fájl egyesítése külön profilozási futásokból

SPDConvert Három fájltípussal működik:

• ETL (Event Trace Log) A xperf által rögzített nyers hardverteljesítmény-eseményadatok
• SPT (mintaprofil-nyomkövetés) SPTAggregate ETL-fájlokból származó, csomagolt mintaesemények
• SPD (mintaprofil-adatbázis) A fordító által egy optimalizált build során használt feldolgozott profiladatok. SPD-fájlokat is beágyazhat PDB-szimbólumfájlokba a /spdembed buildelés során

Szemantika

SpT-adatok importálása meglévő SPD-fájlba:

SPDConvert [beállítások] spdfilesptfile(k)

Beágyazott SPD-fájl kinyerése PDF-fájlból:

SPDConvert /extractpdbfilespdfile

Több SPD-fájl egyesítése egybe:

SPDConvert /mergeoutputspdfilespdfile(s)

Paraméterek

IMPORTÁLÁSI ÜZEMMÓD

beállítások
Adja meg a következő beállításokat importálási módban:

• /Mód:<IP|LBR> Válassza ki a profil módot. Használja az IP értéket az utasításmutatóhoz tartozó profiladatokhoz (alapértelmezett), vagy az LBR értéket az utolsó elágazásrekord profiladataihoz.
• /reset: Állítsa vissza a számlálót 0-ra. Ez a művelet figyelmen kívül hagyja az SPT-ket. Ezzel a beállítással új adatok importálása előtt visszaállíthat egy SPD-fájlt, vagy üres SPD-fájlt hozhat létre, ha a megadott fájl nem létezik.
• /sptlist:<Fájl> Adja meg az SPT-fájlneveket egy szövegfájlban, soronként egy fájlnévvel.
• /Összefoglaló Az SPD-fájl összegzésének nyomtatása.
• /segítség Súgóinformációk megjelenítése.

spdfile
A mintaadatokat importáló SPD-fájl.

sptfiles
Egy vagy több importálandó SPT-fájl. Az SPT-fájlokat az SPTAggregate hozza létre.

KINYERÉSI MÓD (/kivonat)

pdbfile
A beágyazott SPD-t tartalmazó PDB-fájl.

spdfile
A létrehozandó kimeneti SPD-fájl.

EGYESÍTÉSI MÓD (/merge)

outputspdfile
A létrehozandó kimeneti SPD-fájl.

/Nyugdíjba:<N> Állítsa a profiladatok kivonási arányát N/16 értékre, ahol 0 ≤ N ≤ 16. Az alapértelmezett érték 8. Ez az érték azt szabályozza, hogy az SPD-ben lévő meglévő adatok mekkora részét törölje új SPT-adatok hozzáadásakor. Például /retire:8 törli a meglévő adatok 8/16-át (fele) az új SPT-adatok hozzáadása előtt. Ez a beállítás nagyobb súlyt ad az újabb profiladatoknak, mert a régebbi adatok felét elveti. A két leggyakoribb használat /retire:0 egyenlő súlyt ad az összes profilfuttatásnak, vagy /retire:16 csak a legújabb adatok számát adja meg, mert törli az összes régi adatot. A /retire:N használatával szabályozhatja, hogy a SPDConvert milyen mértékben csökkentse a régebbi profiladatok hangsúlyát. Ez a "továbbítás" koncepció lehetővé teszi egy profil frissítését meglévő SPD-adatokkal anélkül, hogy új profilkészítési adatokkal kezdene, ami időigényes. Ezt a koncepciót részletesebben az SPGO-oktatóanyag ismerteti – Az SPD-információk újrafelhasználása a buildekben.

spdfiles
Egy vagy több egyesítendő SPD-fájl.

Remarks

Note

Ezt az eszközt egy Visual Studio Fejlesztői parancssorból indítsa el.

SPDConvert az SPGO-munkafolyamat fő konverziós eszköze. Miután a xperf használatával összegyűjtötte a nyomkövetési adatokat, majd a SPTAggregate használatával SPT-fájllá alakította őket, a SPDConvert használatával importálja a mintaadatokat egy SPD-fájlba. Adja át az eredményként kapott SPD-fájlt a fordítónak úgy, hogy a /SPGO jelzővel létrehoz egy optimalizált bináris fájlt.

A /extract használatával helyreállítható egy SPD-fájl, amely egy /SPGO build során lett beágyazva egy PDB-fájlba. Az újraépítés előtt több profilkészítési munkamenetből származó SPD-fájlok kombinálására használható /merge .

Egy bináris GUID-jának és korának meg kell egyeznie az SPT és az SPD fájlok között. Ha nem egyeznek, SPDConvert az "SPD-verzió nem kompatibilis" hibaüzenetet jelent. Az SPT-fájl bináris azonosítóinak ellenőrzéséhez használja a(z) SPTDump /progid elemet, az SPD-fájl ellenőrzéséhez pedig a(z) SPDDump /header elemet.

Az SPD-fájlban rögzített bináris guid-jának és korának meg kell egyeznie az SPT-fájllal. A hiba diagnosztizálásához használja SPTDump /progid az SPT-fájl bináris azonosítóinak vizsgálatára és SPDDump /header az SPD-fájl vizsgálatára. A rendszer a lehető legnagyobb mértékben érvényes SPD-fájlt használ. A kód olyan kisebb frissítései, amelyek nem módosítják a program vezérlőfolyamatát, tolerálhatók. A változatlan függvények az adatokat is használják az optimalizáláshoz. Ha érvényes, de egyébként nem független SPD-t ad meg, a folyamat működik, de valószínűleg nincs használható adat az optimalizáláshoz.

Example

Ez a példa LBR-profiladatokat importál egy SPT-fájlból egy SPD-fájlba:

SPDConvert /mode:LBR sample.spd sample.spt

Ez a példa ip-profiladatokat importál az SPT-fájlok listájával:

SPDConvert /mode:IP /sptlist:mysptfiles.txt sample.spd

Ez a példa egy SPD-fájl profiladatainak összegzését nyomtatja ki:

SPDConvert /summary sample.spd

Ez a példa egy PDB-fájlból nyeri ki a beágyazott SPD-t:

SPDConvert /extract sample.pdb sample_extracted.spd

Ez a példa két SPD-fájlt egyesít különböző profilkészítési futtatásokból:

SPDConvert /merge combined.spd run1.spd run2.spd

Lásd még

Oktatóanyag: A mintavételes profilvezérelt optimalizálás (SPGO) használata a teljesítmény javításához
SPDDump
SPTAggregate
SPTDump