A Reliable Actors diagnosztizálása és teljesítményfigyelése

A Reliable Actors futtatókörnyezet EventSource-eseményeket és teljesítményszámlálókat bocsát ki. Ezek betekintést nyújtanak a futtatókörnyezet működésébe, és segítenek a hibaelhárításban és a teljesítményfigyelésben.

EventSource-események

A Reliable Actors futtatókörnyezet EventSource-szolgáltatójának neve "Microsoft-ServiceFabric-Actors". Az eseményforrásból származó események a Diagnosztikai események ablakban jelennek meg, amikor az aktoralkalmazás hibakeresése folyamatban van a Visual Studióban.

Az EventSource-események gyűjtésében és/vagy megtekintésében segítő eszközök és technológiák például a PerfView, az Azure Diagnostics, a Szemantikus naplózás és a Microsoft TraceEvent könyvtár.

Kulcsszavak

A Reliable Actors EventSource-hoz tartozó összes esemény egy vagy több kulcsszóhoz van társítva. Ez lehetővé teszi az összegyűjtött események szűrését. A következő kulcsszóbitek vannak definiálva.

Kicsit Leírás
0x1 A Fabric Actors-futtatókörnyezet működését összegző fontos események készlete.
0x2 Az aktormetódus-hívásokat leíró események készlete. További információkért tekintse meg a színészek bevezető témakörét.
0x4 Az aktorállapothoz kapcsolódó események halmaza. További információkért tekintse meg az aktorállapot-kezelésről szóló témakört.
0x8 Az aktor fordulatalapú egyidejűségével kapcsolatos események készlete. További információkért tekintse meg az egyidejűségről szóló témakört.

Performance counters

A Reliable Actors futtatókörnyezet a következő teljesítményszámlálókat határozza meg.

Kategória Leírás
Service Fabric-színész Az Azure Service Fabric-szereplőkre jellemző számlálók, például az aktor állapotának mentéséhez szükséges idő
Service Fabric actor metódus A Service Fabric-szereplők által implementált metódusokra jellemző számlálók, például az aktormetódus meghívásának gyakorisága

A fenti kategóriák mindegyike egy vagy több számlálóval rendelkezik.

A Windows operációs rendszerben alapértelmezés szerint elérhető Windows teljesítményfigyelő alkalmazás a teljesítményszámláló adatainak gyűjtésére és megtekintésére használható. Az Azure Diagnostics egy másik lehetőség a teljesítményszámláló adatainak gyűjtésére és azure-táblákba való feltöltésére.

Teljesítményszámláló-példányok nevei

A nagy számú aktorszolgáltatással vagy színészszolgáltatás-partícióval rendelkező fürtön nagy számú színészi teljesítményszámláló példány fog rendelkezni. A teljesítményszámláló-példányok nevei segíthetnek azonosítani azt a partíciót és színészmetódust (ha van), amelyhez a teljesítményszámláló-példány társítva van.

Service Fabric Actor kategória

A kategória Service Fabric Actoresetében a számlálópéldányok nevei a következő formátumban vannak:

ServiceFabricPartitionID_ActorsRuntimeInternalID

A ServiceFabricPartitionID annak a Service Fabric-partícióazonosítónak a sztringképe, amelyhez a teljesítményszámláló-példány társítva van. A partícióazonosító egy GUID, a sztring-ábrázolása pedig a Guid.ToString "D" formátumjelölővel rendelkező metóduson keresztül jön létre.

Az ActorRuntimeInternalID egy 64 bites egész szám sztring-reprezentációja, amelyet a Fabric Actors-futtatókörnyezet generál a belső használatra. Ez szerepel a teljesítményszámláló példányának nevében annak egyediségének biztosítása és a teljesítményszámláló más példányneveivel való ütközés elkerülése érdekében. A felhasználók nem kísérelhetik meg értelmezni a teljesítményszámláló-példány nevének ezt a részét.

Az alábbi példa egy számlálópéldány nevére mutat be egy, a kategóriához tartozó számlálót Service Fabric Actor :

2740af29-78aa-44bc-a20b-7e60fb783264_635650083799324046

A fenti 2740af29-78aa-44bc-a20b-7e60fb783264 példában a Service Fabric partícióazonosítójának sztringképe látható, és 635650083799324046 a futtatókörnyezet belső használatához létrehozott 64 bites azonosító.

Service Fabric actor method category

A kategória Service Fabric Actor Methodesetében a számlálópéldányok nevei a következő formátumban vannak:

MethodName_ActorsRuntimeMethodId_ServiceFabricPartitionID_ActorsRuntimeInternalID

A MethodName annak az aktormetódusnak a neve, amelyhez a teljesítményszámláló-példány társítva van. A metódusnév formátuma a Fabric Actors futtatókörnyezetben található valamilyen logika alapján van meghatározva, amely a név olvashatóságát és a Teljesítményszámláló-példányok windowsos példányneveinek maximális hosszára vonatkozó korlátozásokat is kiegyensúlyozza.

Az ActorsRuntimeMethodId egy 32 bites egész szám sztring-ábrázolása, amelyet a Fabric Actors-futtatókörnyezet generál a belső használatra. Ez szerepel a teljesítményszámláló példányának nevében annak egyediségének biztosítása és a teljesítményszámláló más példányneveivel való ütközés elkerülése érdekében. A felhasználók nem kísérelhetik meg értelmezni a teljesítményszámláló-példány nevének ezt a részét.

A ServiceFabricPartitionID annak a Service Fabric-partícióazonosítónak a sztringképe, amelyhez a teljesítményszámláló-példány társítva van. A partícióazonosító egy GUID, a sztring-ábrázolása pedig a Guid.ToString "D" formátumjelölővel rendelkező metóduson keresztül jön létre.

Az ActorRuntimeInternalID egy 64 bites egész szám sztring-reprezentációja, amelyet a Fabric Actors-futtatókörnyezet generál a belső használatra. Ez szerepel a teljesítményszámláló példányának nevében annak egyediségének biztosítása és a teljesítményszámláló más példányneveivel való ütközés elkerülése érdekében. A felhasználók nem kísérelhetik meg értelmezni a teljesítményszámláló-példány nevének ezt a részét.

Az alábbi példa egy számlálópéldány nevére mutat be egy, a kategóriához tartozó számlálót Service Fabric Actor Method :

ivoicemailboxactor.leavemessageasync_2_89383d32-e57e-4a9b-a6ad-57c6792aa521_635650083804480486

A fenti ivoicemailboxactor.leavemessageasync példában a metódus neve, 2 a futtatókörnyezet belső használatához létrehozott 32 bites azonosító, 89383d32-e57e-4a9b-a6ad-57c6792aa521 a Service Fabric partícióazonosítójának sztringképe, valamint 635650083804480486 a futtatókörnyezet belső használatához létrehozott 64 bites azonosító.

Események és teljesítményszámlálók listája

Aktor metóduseseményei és teljesítményszámlálói

A Reliable Actors futtatókörnyezet a következő eseményeket bocsátja ki a színészi módszerekhez kapcsolódóan.

Esemény neve Eseményazonosító Level Kulcsszó Leírás
ActorMethodStart 7 Részletezés 0x2 Az Actors runtime egy színészmetódus meghívására készül.
ActorMethodStop 8 Részletezés 0x2 Az aktormetódus végrehajtása befejeződött. Ez azt jelentette, hogy a futtatókörnyezet aszinkron hívása az aszinkron módon vissza lett adva, és az aktor metódus által visszaadott feladat befejeződött.
ActorMethodThrewException 9 Figyelmeztetés 0x3 Kivétel történt egy színészmetódus végrehajtása során, vagy a futtatókörnyezet aszinkron hívása során, vagy az aktor metódus által visszaadott feladat végrehajtása során. Ez az esemény valamilyen hibát jelez az aktorkódban, amely vizsgálatra szorul.

A Reliable Actors futtatókörnyezet a következő teljesítményszámlálókat teszi közzé a színészi metódusok végrehajtásával kapcsolatban.

Kategória neve Számláló neve Leírás
Service Fabric actor metódus Hívás/mp Az aktorszolgáltatás metódus másodpercenkénti meghívásának száma
Service Fabric actor metódus Hívásonkénti átlagos ezredmásodperc Az aktorszolgáltatás-metódus végrehajtásához szükséges idő ezredmásodpercben
Service Fabric actor metódus Kidobott kivételek/másodperc Az aktorszolgáltatás-metódus másodpercenkénti kivételének száma

Egyidejűségi események és teljesítményszámlálók

A Reliable Actors futtatókörnyezet az alábbi, egyidejűséggel kapcsolatos eseményeket bocsátja ki.

Esemény neve Eseményazonosító Level Kulcsszó Leírás
ActorMethodCallsWaitingForLock 12 Részletezés 0x8 Ez az esemény minden egyes színészi fordulat elején meg van írva. Tartalmazza azoknak a függőben lévő színészi hívásoknak a számát, amelyek arra várnak, hogy megszerezze az aktoronkénti zárolást, amely a turn-alapú egyidejűséget kényszeríti ki.

A Reliable Actors futtatókörnyezet az egyidejűséghez kapcsolódó alábbi teljesítményszámlálókat teszi közzé.

Kategória neve Számláló neve Leírás
Service Fabric-színész A színészi hívások száma, amely a színész zárolására vár A függőben lévő színészi hívások száma, amelyek a fordulatalapú egyidejűséget kényszerítő, a színészenkénti zárolás beszerzésére várnak
Service Fabric-színész Zárolási várakozásonkénti átlagos ezredmásodperc Az aktoronkénti zárolás beszerzéséhez szükséges idő (ezredmásodpercben), amely a fordulási alapú egyidejűséget kényszeríti ki
Service Fabric-színész Átlagos ezredmásodperc aktorzár megtartva Az az idő (ezredmásodpercben), amelyre a színészenkénti zárolást tartják

Aktorállapot-kezelési események és teljesítményszámlálók

A Reliable Actors futtatókörnyezet a következő eseményeket bocsátja ki az aktorállapot-kezeléssel kapcsolatban.

Esemény neve Eseményazonosító Level Kulcsszó Leírás
ActorSaveStateStart 10 Részletezés 0x4 Az Actors-futtatókörnyezet a színész állapotának mentésére készül.
ActorSaveStateStop 11 Részletezés 0x4 Az Actors-futtatókörnyezet befejezte az aktorállapot mentését.

A Reliable Actors futtatókörnyezet a következő teljesítményszámlálókat teszi közzé az aktorállapot-kezeléshez kapcsolódóan.

Kategória neve Számláló neve Leírás
Service Fabric-színész Mentési állapot műveletenkénti átlagos ezredmásodperc A színész állapotának ezredmásodpercben történő mentéséhez szükséges idő
Service Fabric-színész Terhelésállapot-műveletenkénti átlagos ezredmásodperc Az aktor állapotának ezredmásodpercben történő betöltéséhez szükséges idő

A Reliable Actors futtatókörnyezet a következő eseményeket bocsátja ki a színészreplikákhoz kapcsolódóan.

Esemény neve Eseményazonosító Level Kulcsszó Leírás
ReplicaChangeRoleToPrimary 1 Tájékoztató 0x1 Az aktorreplika elsődleges szerepkörre változott. Ez azt jelenti, hogy a partíció szereplői ebben a replikában lesznek létrehozva.
ReplicaChangeRoleFromPrimary 2 Tájékoztató 0x1 Az aktorreplika szerepköre nem elsődlegesre változott. Ez azt jelenti, hogy a partíció szereplői többé nem lesznek létrehozva ebben a replikában. A replikán belül már létrehozott szereplők nem kapnak új kéréseket. A folyamatban lévő kérések befejeződése után a szereplők el lesznek pusztítva.

A színész aktiválási és inaktiválási eseményei és teljesítményszámlálói

A Reliable Actors futtatókörnyezet a következő eseményeket bocsátja ki a színészek aktiválásával és deaktiválásával kapcsolatban.

Esemény neve Eseményazonosító Level Kulcsszó Leírás
ActorActivated 5 Tájékoztató 0x1 Egy színészt aktiváltak.
ActorDeactivated 6 Tájékoztató 0x1 Egy színész inaktiválva lett.

A Reliable Actors futtatókörnyezet a következő teljesítményszámlálókat teszi közzé a színészek aktiválásával és deaktiválásával kapcsolatban.

Kategória neve Számláló neve Leírás
Service Fabric-színész Átlagos OnActivateAsync ezredmásodperc Az OnActivateAsync metódus végrehajtásához szükséges idő ezredmásodpercben

Aktor kérése a teljesítményszámlálók feldolgozásához

Amikor egy ügyfél egy aktorproxy-objektumon keresztül hív meg egy metódust, az azt eredményezi, hogy a rendszer kérésüzenetet küld a hálózaton keresztül az aktorszolgáltatásnak. A szolgáltatás feldolgozza a kérési üzenetet, és választ küld az ügyfélnek. A Reliable Actors futtatókörnyezet a következő teljesítményszámlálókat teszi közzé az aktorkérések feldolgozásával kapcsolatban.

Kategória neve Számláló neve Leírás
Service Fabric-színész A függőben lévő kérelmek száma A szolgáltatásban feldolgozott kérések száma
Service Fabric-színész Átlagos ezredmásodperc kérésenként A szolgáltatás által a kérés feldolgozásához szükséges idő (ezredmásodpercben)
Service Fabric-színész Kérelem deszerializálásának átlagos ezredmásodpercei Az aktorkérési üzenet deszerializálásához szükséges idő (ezredmásodpercben), amikor az a szolgáltatásban érkezik
Service Fabric-színész Válasz szerializálásának átlagos ezredmásodpercei Az aktor válaszüzenetének szerializálásához szükséges idő (ezredmásodpercben) a szolgáltatásban, mielőtt a választ elküldené az ügyfélnek

További lépések