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 Actor
eseté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 Method
eseté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ő |
Színészreplikákkal kapcsolatos események
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 |