Erőforrás-szabályozás alkalmazáscsoportokkal
Az Azure Event Hubs lehetővé teszi az Event Hubshoz csatlakozó ügyfélalkalmazások eseménystreamelési számítási feladatainak szabályozását. Létrehozhat logikai csoportokat alkalmazáscsoportok néven, ahol minden csoport ügyfélalkalmazások gyűjteménye, majd kvóta- és hozzáférés-kezelési szabályzatokat alkalmazhat egy alkalmazáscsoportra (ügyfélalkalmazások csoportjára).
Megjegyzés:
Az alkalmazáscsoportok csak prémium és dedikált szinteken érhetők el.
Alkalmazáscsoportok
Az alkalmazáscsoport egy vagy több olyan ügyfélalkalmazás gyűjteménye, amely az Event Hubs adatsíkjával kommunikál. Minden alkalmazáscsoport hatóköre egyetlen Event Hubs-névtérre vagy egy névtéren belüli eseményközpontra (entitásra) terjedhet ki, és olyan egyedi azonosítási feltételt kell használnia, mint például az ügyfélalkalmazás biztonsági környezete – közös hozzáférésű jogosultságkódok (SAS) vagy Microsoft Entra-alkalmazásazonosító .
Az Event Hubs jelenleg támogatja a biztonsági környezetek használatát az alkalmazáscsoportok létrehozásához. Ezért minden alkalmazáscsoportnak egyedi SAS-szabályzattal vagy Microsoft Entra-alkalmazásazonosítóval kell rendelkeznie. Ha előnyben részesíti, az eseményközpont szintjén biztonsági környezettel használhat egy adott eseményközponttal rendelkező alkalmazáscsoportot egy névtéren belül.
Az alkalmazáscsoportok a névtér szintjén létrehozott logikai entitások. Ezért az eseményközpontokkal interakcióba lépő ügyfélalkalmazásoknak nem kell tisztában lenniük egy alkalmazáscsoport létezésével. Az Event Hubs az azonosító feltétel használatával bármilyen ügyfélalkalmazást hozzárendelhet egy alkalmazáscsoporthoz.
Az alábbiakban látható módon az egyes ügyfélalkalmazások által használt biztonsági környezet alapján hozhat létre alkalmazáscsoportokat. Ezért az alkalmazáscsoportok több ügyfélalkalmazásra is kiterjedhetnek ugyanazzal a biztonsági környezettel.
Az alkalmazáscsoportok nem rendelkeznek közvetlen társítással egy fogyasztói csoporttal. Az alkalmazáscsoport azonosítójától (például a biztonsági környezettől) függően egy fogyasztói csoporthoz hozzárendelhet egy vagy több alkalmazáscsoportot, vagy egy alkalmazáscsoport több fogyasztói csoportra is kiterjedhet.
Ezek az alkalmazáscsoportok fő attribútumai:
| Paraméter | Leírás |
|---|---|
| név | Egy alkalmazáscsoport egyedi neve. |
| clientAppGroupIdentifier | Alkalmazáscsoport társítása egyedi azonosítási feltétellel (például biztonsági környezettel, például SAS-szabályzattal vagy Microsoft Entra-alkalmazásazonosítóval). |
| policies | Szabályzatok listája, például az ügyfélalkalmazások és az Event Hubs-névtér közötti eseménystreamelést szabályozó szabályzatok szabályozása |
| isEnabled | Határozza meg, hogy egy alkalmazáscsoport ügyfélalkalmazásai hozzáférhetnek-e az Event Hubs-névterekhez, vagy sem. |
Alkalmazáscsoport-szabályzatok
Minden alkalmazáscsoport tartalmazhat nulla vagy több olyan házirendet, amelyek az alkalmazáscsoport részét képező ügyfélalkalmazások adatsík-hozzáférését szabályozzák. Az alkalmazáscsoportok jelenleg támogatják a szabályozási szabályzatokat.
Szabályozási szabályzatok
A szabályozási szabályzatokat különböző bejövő és kimenő metrikák használatával adhatja meg. Az alkalmazáscsoportok az alábbi metrikák használatával támogatják az ügyfélalkalmazások bejövő vagy kimenő számítási feladatainak szabályozását.
| Paraméter | Leírás |
|---|---|
| Bejövő bájtok | A Publisher átviteli sebessége másodpercenként bájtban. |
| Kimenő bájtok | Fogyasztói átviteli sebesség másodpercenként bájtban. |
| IncomingMessages | Másodpercenként közzétett események száma. |
| Kimenő üzenetek | Másodpercenként felhasznált események száma. |
Az alkalmazáscsoportokra vonatkozó szabályzatok alkalmazásakor az ügyfélalkalmazás számítási feladatai lelassíthatják vagy ütközhetnek a kiszolgáló foglalt kivételei alól.
Szabályzat szabályozása – küszöbértékkorlátok
Az alábbi táblázat a szabályozási szabályzat különböző metrikaazonosítóihoz megadható minimális küszöbértékeket mutatja be:
| Metrikaazonosító | Minimális korlát |
|---|---|
| Bejövő bájt | 1 KB |
| Kimenő bájt | 1 KB |
| IncomingMessage | 1 |
| Kimenő üzenet | 1 |
Megjegyzés:
A szabályozási szabályzat küszöbértékére beállított korlátok elsőbbséget élveznek a Kafka-témakörtulajdonságok bármely értékkészletével szemben. Például IncomingBytes magasabb prioritással rendelkezne a message.max.bytes.
Az alkalmazáscsoportok szabályozása várhatóan a megengedettnél nagyobb (néhány percig tartó) forgalmi forgatókönyvek konzisztens szabályozását fogja szabályozni. Előfordulhat, hogy néhány másodperces gyors adatkitörések nem tapasztalnak szabályozást az alkalmazáscsoportokon keresztül. A szabályozás ellenőrzéséhez ajánlott a néhány perces időhorizonton engedélyezett átviteli sebesség ellenőrzése.
Protokolltámogatás és hibakódok
Az alkalmazáscsoport a következő protokollok – AMQP, Kafka és HTTP – használatával történő szabályozást támogatja. Az alábbi táblázat az alkalmazáscsoportok által visszaadott várt hibakódokat tartalmazza:
| Protokoll | Operation | Error code | Hibaüzenet |
|---|---|---|---|
| AMQP | Küldés | 50004 | Alkód:50013, Az alkalmazáscsoport szabályozása az alkalmazáscsoport azonosítójával és házirend nevével történik |
| HTTP | Küldés | 503 | Alkód: 50013. Az alkalmazáscsoport szabályozása az alkalmazáscsoport azonosítójával és a szabályzat nevével történik |
| Kafka | Küldés | PolicyViolation | Közvetítő: szabályzat megsértése |
A protokollszintű korlátozások miatt a hibaüzenetek nem támogatottak a fogadási művelet során. Ha az alkalmazáscsoportok szabályozást végeznek a fogadási műveleteken, az üzenetek lassú fogyasztását tapasztalhatja a fogyasztói oldalon.
Alkalmazáscsoportok letiltása
Az alkalmazáscsoport alapértelmezés szerint engedélyezve van, és ez azt jelenti, hogy az összes ügyfélalkalmazás hozzáférhet az Event Hubs névteréhez az események közzétételéhez és felhasználásához az alkalmazáscsoport szabályzatainak betartásával.
Ha egy alkalmazáscsoport le van tiltva, az ügyfél továbbra is csatlakozhat az eseményközponthoz, de az engedélyezés sikertelen lesz, majd az ügyfélkapcsolat bezárul. Ezért sok sikeres nyitott és szoros kapcsolatot fog látni, ugyanannyi engedélyezési hibával a diagnosztikai naplókban.
További lépések
Az alkalmazáscsoportok létrehozásával és kezelésével kapcsolatos utasításokért tekintse meg az Azure Portalon futó ügyfélalkalmazások erőforrás-szabályozását ismertető cikket