Az .NET.NET Aspire irányítópult felfedezése

A következő szakaszokban megtudhatja, hogyan hozhat létre .NET.NET Aspire projektet, és hogyan kezdheti el a következő feladatokat:

A cikkben szereplő képernyőképek a sötét témát mutatják be. További információ a témaválasztásról: Témaválasztási.

Irányítópult-hitelesítés

.NET .NET Aspire alkalmazásgazda futtatásakor a vezénylő elindítja az alkalmazás összes függő erőforrását, majd megnyit egy böngészőablakot az irányítópulton. A .NET.NET Aspire irányítópult jogkivonatalapú hitelesítést igényel a felhasználók számára, mivel környezeti változókat és egyéb bizalmas információkat jelenít meg.

Amikor az irányítópult Visual Studio vagy Visual Studio Code (a C# Dev Kit kiterjesztéssel) indul el, a böngésző automatikusan bejelentkezik, és az irányítópult közvetlenül megnyílik. Ez a tipikus fejlesztői F5 felület, és a hitelesítési bejelentkezési folyamatot a .NET.NET Aspire eszköz automatizálja.

Ha azonban a parancssorból indítja el az alkalmazás gazdagépét, megjelenik a bejelentkezési oldal. A konzolablakban megjelenik egy URL-cím, amelyet kiválasztva megnyithatja az irányítópultot a böngészőben.

Az URL-cím tartalmaz egy jogkivonat-lekérdezési sztringet (a jogkivonat értéke a t névrészre van megfeleltetve), amely az irányítópultra való bejelentkezés . Ha a konzol támogatja, a Ctrl billentyűt lenyomva tartva megnyithatja az irányítópultot a böngészőben. Ez a módszer egyszerűbb, mint a jogkivonat másolása a konzolról, és beillesztés a bejelentkezési oldalra. Ha a korábban ismertetett módszerek bármelyike nélkül az irányítópult bejelentkezési oldalán végzi, a jogkivonat másolásához bármikor visszatérhet a konzolra.

A bejelentkezési oldal elfogad egy jogkivonatot, és hasznos útmutatást nyújt a jogkivonat beszerzéséhez az alábbi képernyőképen látható módon:

Miután átmásolta a jogkivonatot a konzolról, és beillesztte a bejelentkezési lapra, válassza a Bejelentkezés gombot.

Az irányítópult böngészőbeli állandó cookieként megőrzi a jogkivonatot, amely három napig érvényes marad. Az állandó cookie-k lejárati dátummal rendelkeznek, és a böngésző bezárása után is érvényesek maradnak. Ez azt jelenti, hogy a felhasználóknak nem kell újból bejelentkezniük, ha bezárják és újra megnyitják a böngészőt. További információkért tekintse meg a irányítópult dokumentációjának biztonsági szempontjait.

Erőforrások lap

Az Erőforrások lap az .NET.NET Aspire irányítópult alapértelmezett kezdőlapja. Ez a lap felsorolja a .NET megoldásban található összes .NET Aspire projektet, tárolót és végrehajtható fájlt. A kezdőalkalmazás például két projektet tartalmaz:

• apiservice: A minimal API-k használatával létrehozott háttér API-projekt.
• webfrontend: A Blazorhasználatával készült előtérbeli felhasználói felületi projekt.

Az irányítópult az egyes erőforrások alapvető adatait is tartalmazza:

• Típus: Megjeleníti, hogy az erőforrás projekt, tároló vagy végrehajtható-e.
• Név: Az erőforrás neve.
• Állapot: Megjeleníti, hogy az erőforrás jelenleg fut-e.
  • hibák: Az Állapot oszlopban a hibák jelvényként jelennek meg a hibaszámmal. Hasznos gyorsan megérteni, hogy milyen erőforrások jelentenek hibákat. A jelvény kiválasztásával a szemantikai naplókhoz az erőforráshoz, és a szűrő hibaszinten van.
• Kezdési idő: Az erőforrás futásának megkezdése.
• Forrás: Az erőforrás helye az eszközön.
• végpontok: Egy vagy több URL-cím a futó erőforrás közvetlen eléréséhez.
• Naplók: Az erőforrásnaplók lapra mutató hivatkozás.
• Műveletek: Az erőforráson végrehajtható műveletek készlete:
  • Leállítás/Indítás: Állítsa le (vagy indítsa el) az erőforrást az aktuális állapottól függően.
  • konzolnaplók: Keresse meg az erőforrás konzolnaplóit.
  • Három pont: Egy további erőforrásspecifikus műveletekkel rendelkező almenü:
    • Részletek megtekintése: Az erőforrás részleteinek megtekintése.
    • konzolnapló: Keresse meg az erőforrás konzolnaplóit.
    • strukturált naplók: Keresse meg az erőforrás strukturált naplóit.
    • nyomkövetési: Keresse meg az erőforrás nyomkövetéseit.
    • Metrikák: Navigáljon az erőforrás metrikáihoz.
    • Újraindítás: Állítsa le, majd indítsa el az erőforrást.

Tekintse meg a következő képernyőképet az erőforrások oldaláról:

Erőforrásműveletek

Minden erőforrás rendelkezik olyan elérhető műveletekkel, amelyek feltételesen engedélyezve vannak az erőforrás aktuális állapota alapján. Ha például egy erőforrás fut, a Stop művelet engedélyezve van. Ha az erőforrás le van állítva, a Start művelet engedélyezve van. Hasonlóképpen, egyes műveletek le vannak tiltva, ha nem érhetők el, például egyes erőforrások nem rendelkeznek strukturált naplókkal. Ilyen esetekben a strukturált naplók művelet le van tiltva.

Erőforrás leállítása vagy indítása

A .NET.NET Aspire irányítópulton az Műveletek oszlopban található Leállítás vagy Start gombot választva állíthat le vagy indíthat el egy erőforrást. Tekintse meg az erőforrások lapjának alábbi képernyőképét, amelyen a leállítása gomb van kiválasztva:

Ha a Leállításlehetőséget választja, az erőforrás nem fut, és a Állapot oszlop frissül a változásnak megfelelően.

Ekkor a Start gomb engedélyezve van, így újra elindíthatja az erőforrást. Az irányítópult emellett bejelentési értesítést is jelenít meg a művelet eredményéről:

Ha egy erőforrás nem futó állapotban van, a Start gomb engedélyezve van. A Start kiválasztása elindítja az erőforrást, és a Állapot oszlop frissül a változásnak megfelelően. Ekkor engedélyezve van a leállítása gomb, így ismét leállíthatja az erőforrást. Az irányítópult egy bejelentési értesítést jelenít meg a művelet eredményéről:

Erőforrás-almenüműveletek

Ha a Műveletek oszlopban a vízszintes három pont ikont választja, egy további erőforrásspecifikus műveletekkel rendelkező almenü nyílik meg. A beépített erőforrás-almenüműveletek mellett egyéni parancsok definiálásával egyéni erőforrásműveleteket is definiálhat. További információ: .NET.NET Aspireegyéni erőforrásparancsai. A beépített erőforrás-almenüműveletek esetében tekintse meg a következő képernyőképet:

A következő almenüműveletek érhetők el:

• Részletek megtekintése: Az erőforrás részleteinek megtekintése.
• konzolnapló: Keresse meg az erőforrás konzolnaplóit.
• strukturált naplók: Keresse meg az erőforrás strukturált naplóit.
• nyomkövetési: Keresse meg az erőforrás nyomkövetéseit.
• Metrikák: Navigáljon az erőforrás metrikáihoz.
• Újraindítás: Állítsa le, majd indítsa el az erőforrást.

Másolás vagy megnyitás szövegábrázolóban

Ha bizonyos oszlopok szövegábrázolót szeretne megtekinteni, az egérmutatón egy függőleges három pont ikon látható. Válassza az ikont az elérhető beállítások megjelenítéséhez:

• Másolás vágólapra
• Megnyitás szövegábrázolóban

Vegye figyelembe a három pont menübeállításainak alábbi képernyőképét:

Ha a Megnyitás szövegábrázolóban lehetőséget választja, megnyílik egy modális párbeszédpanel, amelyen a szöveg nagyobb formátumban jelenik meg. Tekintse meg a szövegábrázoló modális párbeszédpaneljének alábbi képernyőképét:

Egyes értékek JSON vagy XML formátumban vannak formázva. Ezekben az esetekben a szövegábrázoló lehetővé teszi a Formátum kiválasztása legördülő menüt a különböző formátumok közötti váltáshoz.

Erőforrás részletei

Az egyes erőforrások részletes adatait a Műveletek oszlop három pont gombjára kattintva, majd a Részletek megtekintésegombra kattintva szerezheti be. A Részletek oldal átfogó képet nyújt az erőforrásról:

Az irányítópult jobb felső sarkában található keresősáv lehetővé teszi a lista szűrését is, amely .NET.NET Aspire sok erőforrással rendelkező projektek esetében hasznos. A megjelenő erőforrástípusok kiválasztásához a szűrő szövegmezőjének bal oldalán található nyílra kell húznia:

Ebben a példában csak a tárolók jelennek meg a listában. Ha például engedélyezi a Redis gyorsítótárazási használata .NET Aspire-projekt létrehozásakor, egy Redis tárolónak kell megjelennie a listában:

A végrehajtható fájlok önálló folyamatok. A .NET.NET Aspire projekteket úgy konfigurálhatja, hogy az indítás során önálló végrehajtható fájlt futtasson, de az alapértelmezett kezdősablonok alapértelmezés szerint nem tartalmaznak végrehajtható fájlokat.

Az alábbi képernyőkép egy hibával rendelkező projekt példáját mutatja be:

A hibaszámjelvény kiválasztásával a Strukturált naplók lapra lép egy szűrő alkalmazásával, amely csak az erőforráshoz kapcsolódó naplókat jeleníti meg:

A hiba naplóbejegyzésének részletes megtekintéséhez válassza a Nézet gombot a lista alatti ablak megnyitásához a strukturált naplóbejegyzés részleteivel:

A strukturált naplókról további információt és példákat a Strukturált naplók lap szakaszában talál.

Figyelési lapok

A .NET.NET Aspire irányítópult különböző módokon jeleníti meg az alkalmazás naplóit, nyomkövetéseit és metrikáit. Ezek az információk lehetővé teszik az alkalmazás viselkedésének és teljesítményének nyomon követését, valamint a felmerülő problémák diagnosztizálását.

Konzolnaplók lap

A konzol naplói lapon az alkalmazás minden erőforrása által a standard kimenetre küldött szöveg jelenik meg. A naplók segítségével monitorozhatja az alkalmazás állapotát, és diagnosztizálhatja a problémákat. A naplók a forrástól függően eltérően jelennek meg, például projekttől, tárolótól vagy végrehajthatótól függően.

A Konzolnaplók lap megnyitásakor ki kell választania egy forrást a Erőforrás kiválasztása legördülő listában.

Ha kiválaszt egy projektet, az élő naplók stilizált színkészlettel jelennek meg, amelyek megfelelnek a napló súlyosságának; például az információk zöld színnel jelölve. Tekintse meg a projektnaplók alábbi képernyőképét a kiválasztott apiservice projekttel:

Hibák esetén a naplók úgy vannak formázva, hogy könnyen azonosíthatók legyenek. Tekintse meg a következő példa képernyőképet a hibákkal rendelkező projektnaplókról:

Tároló vagy végrehajtható fájl kiválasztása esetén a formázás eltér a projekttől, de részletes viselkedési információk továbbra is elérhetők. Tekintse meg a következő példa képernyőképét egy tárolónaplóról, amelyen a cache tároló van kiválasztva:

Erőforrásreplikák

Ha a projekterőforrásokat a WithReplicas API használatával replikálják, azokat egy felső szintű, elnevezett erőforrás-bejegyzés alatt, az erőforrás-választóban jelenítik meg, ikonnal jelölve. Minden replikált erőforrás a legfelső szintű erőforrás-bejegyzés alatt látható, annak megfelelő egyedi nevével. Tekintse meg a replikált projekterőforrás alábbi képernyőképét:

Az előző képernyőképen a catalogservice (application) projekt látható két replikával, catalogservice-2bpj2qdq6k és catalogservice-6ljdin0hc0. Minden replika saját naplókészlettel rendelkezik, amelyet a replika nevének kiválasztásával tekinthet meg.

Strukturált naplók lap

.NET Aspire automatikusan konfigurálja a projekteket a OpenTelemetryhasználatával történő naplózással. Lépjen a Strukturált naplók lapra a .NET.NET Aspire projekt szemantikai naplóinak megtekintéséhez. szemantikai vagy strukturált naplózási megkönnyíti a naplóesemények tárolását és lekérdezését, mivel a naplóesemény üzenetsablonja és üzenetparaméterei megmaradnak, ahelyett, hogy formázott üzenetté alakítanák őket. A lapon oszlopok használatával megjelenő különböző naplók tiszta struktúráját láthatja:

• Erőforrás: Az az erőforrás, amelyből a napló származik.
• szint: A bejegyzés naplószintje, például információ, figyelmeztetés vagy hiba.
• időbélyeg: A napló előfordulásának időpontja.
• üzenet: A napló részletei.
• nyomkövetési: A napló megfelelő nyomkövetésére mutató hivatkozás, ha van ilyen.
• Részletek: További részletek vagy metaadatok a naplóbejegyzésről.

Tekintse meg a szemantikai naplók alábbi képernyőképét:

Strukturált naplók szűrése

A strukturált naplók oldal egy keresősávot is biztosít a naplók szolgáltatás, szint vagy üzenet szerinti szűréséhez. A Szint legördülő listával naplószint szerint szűrhet. Bármely naplótulajdonság alapján is szűrhet a szűrő ikon gombjára kattintva, amely megnyitja a speciális szűrő párbeszédpanelt.

Vegye figyelembe a következő képernyőképeket, amelyek a strukturált naplókat jelenítik meg, és szűrve jelennek meg a "Hosting" elemekkel az üzenet szövegében:

Nyomkövetési oldal

Lépjen a Nyomkövetések lapra az alkalmazás összes nyomkövetésének megtekintéséhez. .NET .NET Aspire automatikusan konfigurálja az alkalmazás különböző projektjeinek nyomkövetését. Az elosztott nyomkövetés egy diagnosztikai technika, amely segít a mérnököknek az alkalmazások hibáinak és teljesítményproblémáinak honosításában, különösen azokban, amelyek több gépen vagy folyamaton keresztül terjeszthetők. További információ: .NET elosztott nyomkövetési. Ez a technika egy alkalmazáson keresztül követi nyomon a kérelmeket, és korrelálja a különböző alkalmazásintegrációk által végzett munkát. A nyomkövetések azt is azonosítják, hogy a kérés különböző szakaszai mennyi ideig tartottak. A nyomkövetési oldal a következő információkat jeleníti meg:

• időbélyeg: Ha a nyomkövetés befejeződött.
• Név: A nyomkövetés neve a projekt nevével előtaggal.
• : A kérelemben érintett erőforrások.
• időtartam: A kérés teljesítéséhez eltelt idő. Ez az oszlop egy radiális ikont tartalmaz, amely a kérelem időtartamát mutatja a listában szereplő többivel összehasonlítva.

Nyomkövetések szűrése

A nyomkövetési oldal egy keresősávot is biztosít a nyomkövetések név vagy span szerinti szűréséhez. Alkalmazzon szűrőt, és figyelje meg, hogy a nyomkövetési eredmények azonnal frissülnek. Tekintse meg az alábbi képernyőképet a nyomkövetésről, amelyen egy szűrő van alkalmazva weather, és figyelje meg, hogy a keresési kifejezés hogyan van kiemelve az eredmények között:

A nyomkövetések szűrésekor a Szűrő hozzáadása párbeszédpanelen egy paraméter és a megfelelő feltételkiválasztása után a Érték kijelölés előre ki lesz töltve a kiválasztott paraméterhez elérhető értékekkel. Tekintse meg a következő képernyőképet a Szűrő hozzáadása párbeszédpanelről, amelyen a http.route paraméter van kiválasztva:

Telemetriai adatok kombinálása több erőforrásból

Ha egy erőforrás több replikával rendelkezik, a telemetriát szűrve egyszerre tekintheti meg az összes példány adatait. Válassza ki a szülőerőforrást (application)címkével, ahogy az alábbi képernyőképen látható:

összes példánya alapján

A szülőerőforrás kiválasztása után a nyomkövetési oldal telemetriát jelenít meg az erőforrás összes példányából.

Nyomkövetés részletei

A nyomkövetés részleteinek lapja a kérelemhez tartozó különböző részleteket tartalmazza, többek között a következőket:

• Nyomkövetés részletei: A nyomkövetés indításakor.
• időtartam: A kérés teljesítéséhez eltelt idő.
• Erőforrások: A kérelemben érintett erőforrások száma.
• Mélységi: A kérelemben részt vevő rétegek száma.
• Összes spans: A kérelemben érintett spanok teljes száma.

Minden span a táblázat soraként jelenik meg, és egy Névtartalmaz. A spanok a hibaikont is megjelenítik, ha hiba történt a nyomkövetés adott időtartamán belül. Azok a spanok, amelyek ügyfél-fogyasztó típusúak, de nem rendelkeznek spannal a kiszolgálón, megjelenítenek egy nyíl ikont, majd a célcímet. Ez a .NET.NET Aspire projekten kívüli rendszer ügyfélhívását jelenti. Például egy HTTP külső webes API-t vagy egy adatbázis-hívást kér.

A nyomkövetési részletek lapon található egy Naplók megtekintése gomb, amely a strukturált naplók lapjára viszi, és egy szűrőt alkalmaz, amely csak a kérelem szempontjából releváns naplókat jeleníti meg. Vegyünk egy példa képernyőképet, amely a strukturált naplók lapját ábrázolja egy szűrővel, amely csak a nyomkövetés szempontjából releváns naplókat jeleníti meg:

A strukturált naplók lapját részletesebben a Strukturált naplók lap szakasz ismerteti.

Nyomkövetési példák

Minden nyomkövetésnek van egy színe, amely a spanok megkülönböztetése érdekében jön létre – az egyes erőforrásokhoz egy színt. A színek mind a nyomkövetési oldal, mind a nyomkövetési részletek lapjelennek meg. Ha a nyomok egy nyíl ikont ábrázolnak, ezek az ikonok is színezve lesznek a célkövetés hatókörének megfelelően. Tekintse meg a nyomkövetések alábbi példa képernyőképét:

A Nézet gombra kattintva megtekintheti a kérés részletes nézetét és az egyes alkalmazásrétegeken való áthaladás időtartamát. Vegyünk egy példát egy nyomkövetés kiválasztására a részleteinek megtekintéséhez:

A nyomkövetés minden egyes spanja esetében válassza a Nézet lehetőséget a további részletek megtekintéséhez:

Görgessen le a span részletek fájdalom, hogy teljes információt. A span details panel alján egyes spantípusok, például a gyorsítótár hívása, a span eseményidőzítéseket jelenítik meg:

Ha hibák lépnek fel, a lap egy hibaikont jelenít meg a nyomkövetés neve mellett. Vegyünk egy példa képernyőképet a hibákkal rendelkező nyomkövetésekről:

És a nyomkövetés megfelelő részletes nézete hibákkal:

Metrikák lap

Lépjen a Metrikák lapra az alkalmazás metrikáinak megtekintéséhez. .NET .NET Aspire automatikusan konfigurálja a metrikákat az alkalmazás különböző projektjeihez. A metrikák az alkalmazás állapotának mérésére szolgálnak, és az alkalmazás teljesítményének időbeli monitorozására használhatók.

Az alkalmazás minden metrika-közzétételi projektje saját metrikákkal rendelkezik. A metrikák lapon megjelenik az egyes felső szintű mérőszámok kijelölési panelje, valamint a metrikák megtekintéséhez kiválasztható megfelelő eszközök.

Tekintse meg a metrikák lap alábbi képernyőképét, amelyen a webfrontend projekt van kiválasztva, és a System.Net.Http mérőszám http.client.request.duration metrika van kiválasztva:

A metrikák diagramon kívül a metrikák lapon lehetőség van az adatok táblázatként való megtekintésére is. Vegye figyelembe a metrikák lap alábbi képernyőképét, amelyen a táblázatnézet van kiválasztva:

A diagram alatt található egy szűrőlista, amellyel az Önt érdeklő adatokra összpontosíthat. Az alábbi képernyőképen például a http.request.method mező szűrve van, hogy csak GET kéréseket jelenítsen meg:

Azt is választhatja, hogy az értékek helyett a függőleges hozzáférésen lévő megjelenített metrikák számát választja ki:

A metrikákkal kapcsolatos további információkért lásd .NETbeépített metrikáit.

Példaképek

Az .NET Aspire irányítópult támogatja és megjeleníti OpenTelemetryPéldaképek. Egy példakép összekapcsol egy metrikaadat-pontot a rögzített művelettel, amely hidat képez a metrikák és a nyomkövetések között.

A példaképek azért hasznosak, mert további kontextust biztosítanak egy adott metrikaérték rögzítésének okáról. Ha például a http.client.request.duration metrika késésének megugrását észleli, egy példakép egy adott nyomkövetésre vagy időtartamra mutathat, amely a kiugró értéket okozta, segít megérteni a kiváltó okot.

A példaképek az adatpont melletti kis kerek pontként jelennek meg a metrikák diagramjában. Amikor a mutató fölé viszi az egérmutatót, egy elemleírás megjeleníti a példamutató részleteit az alábbi képernyőképen látható módon:

Az előző képernyőképen a http.client.request.duration metrika mintaadatai láthatók. A példakép részletei a következők:

• Erőforrás neve.
• A művelet végrehajtva, ebben az esetben a HTTP GET a /catalog/images/{id}.
• Megfelelő érték és időbélyeg.

A példamutató kiválasztásával megnyílik a nyomkövetés részleteinek lapja, ahol megtekintheti a társított nyomkövetést, például az alábbi képernyőképet:

További információ: OpenTelemetry Docs: Exemplars.

Témaválasztás

Alapértelmezés szerint a téma a Rendszer témát követi, ami azt jelenti, hogy az irányítópult ugyanazt a témát használja, mint az operációs rendszer. A rendszertémát felülbírálhatja a Világos vagy Sötét témát is. A témaválasztások megmaradnak.

Az alábbi képernyőképen a témaválasztási párbeszédpanel látható, amelyen az alapértelmezett rendszertéma van kiválasztva:

Ha inkább a Világos témát választja, a témaválasztási párbeszédpanelen választhatja ki:

Irányítópult-billentyűparancsok

A .NET.NET Aspire irányítópult különböző parancsikonokat biztosít, amelyekkel segíthet az irányítópult különböző részeinek navigálásában és szabályozásában. A billentyűparancsok megjelenítéséhez nyomja le Shift + ?, vagy válassza a kérdőjel ikont az irányítópult jobb felső sarkában:

A következő billentyűparancsok érhetők el:

panelek:

• +: A panel méretének növelése.
• -: A panel méretének csökkentése.
• Shift + r: Resetpanel mérete.
• Shift + t: Tkapcsolópanel tájolása.
• Shift + x: Panel bezárása.

lapnavigációs:

• r: Lépjen Resources.
• c: Lépjen Console logs.
• s: Lépjen Structured logs.
• t: Ugrás Tversenyekre.
• m: Ugrás Metrics.

webhelyszintű navigációs:

• ?: súgó.
• Shift + : Ugrás Settings.

Következő lépések