Resursstyrning med programgrupper

Med Azure Event Hubs kan du styra händelseströmningsarbetsbelastningar för klientprogram som ansluter till Event Hubs. Du kan skapa logiska grupper som kallas programgrupper där varje grupp är en samling klientprogram och sedan tillämpa principer för kvot- och åtkomsthantering för en programgrupp (grupp med klientprogram).

Kommentar

Programgrupper är endast tillgängliga på premium - och dedikerade nivåer.

Programgrupper

En programgrupp är en samling av ett eller flera klientprogram som interagerar med Event Hubs-dataplanet. Varje programgrupp kan begränsas till ett enskilt Event Hubs-namnområde eller händelsehubbar (entitet) inom ett namnområde och bör använda ett unikt identifierande villkor, till exempel säkerhetskontexten – signaturer för delad åtkomst (SAS) eller Microsoft Entra-program-ID – för klientprogrammet.

Event Hubs stöder för närvarande användning av säkerhetskontexter för att skapa programgrupper. Därför måste varje programgrupp ha en unik SAS-princip eller ett Microsoft Entra-program-ID som är associerat med dem. Om du vill kan du använda säkerhetskontext på händelsehubbnivå för att använda en programgrupp med en specifik händelsehubb inom ett namnområde.

Programgrupper är logiska entiteter som skapas på namnområdesnivå. Därför behöver klientprogram som interagerar med händelsehubbar inte vara medvetna om att det finns en programgrupp. Event Hubs kan associera alla klientprogram till en programgrupp med hjälp av det identifierande villkoret.

Som du ser nedan kan du skapa programgrupper baserat på säkerhetskontexten som varje klientprogram använder. Därför kan programgrupper sträcka sig över flera klientprogram med samma säkerhetskontext.

Programgrupper har ingen direkt koppling till en konsumentgrupp. Beroende på programgruppsidentifieraren, till exempel säkerhetskontext, kan en konsumentgrupp ha en eller flera programgrupper associerade med den, eller så kan en programgrupp sträcka sig över flera konsumentgrupper.

Det här är nyckelattributen för en programgrupp:

Parameter	Description
name	Unikt namn på en programgrupp.
clientAppGroupIdentifier	Associera en programgrupp med ett unikt identifierande villkor (t.ex. säkerhetskontext som SAS-princip eller Microsoft Entra-program-ID).
policies	Lista över principer, till exempel begränsningsprinciper som styr händelseströmning mellan klientprogram och Event Hubs-namnområdet
isEnabled	Avgör om klientprogrammen för en programgrupp kan komma åt Event Hubs-namnområden eller inte.

Principer för programgrupper

Varje programgrupp kan innehålla noll eller fler principer som styr åtkomsten till dataplanet för de klientprogram som ingår i programgruppen. Programgrupper stöder för närvarande begränsningsprinciper.

Begränsningsprinciper

Du kan ange begränsningsprinciper med olika ingress- och utgående mått. Programgrupper stöder användning av följande mått för att begränsa ingress- eller utgående arbetsbelastningar för klientprogram.

Parameter	Description
IncomingBytes	Utgivardataflöde i byte per sekund.
Utgåendebyte	Konsumentdataflöde i byte per sekund.
IncomingMessages	Antal händelser som publicerats per sekund.
OutgoingMessages	Antal händelser som förbrukas per sekund.

När principer för programgrupper tillämpas kan arbetsbelastningen för klientprogrammet sakta ned eller stöta på undantag som är upptagna av servern.

Begränsningsprincip – tröskelvärden

I följande tabell visas minsta tröskelvärdesgränser som du kan ange för olika mått-ID i begränsningsprincipen:

Mått-ID	Minimigräns
IncomingByte	1 kB
Utgåendebyte	1 kB
IncomingMessage	1
Utgående meddelande	1

Kommentar

Gränser som anges för begränsningsprincipens tröskelvärde skulle ha företräde framför alla värden som angetts för Kafka-ämnesegenskaper. Till exempel IncomingBytes skulle ha högre prioritet än message.max.bytes.
Begränsning av programgrupper förväntas begränsas konsekvent högre än tillåtna trafikscenarier (som sträcker sig över några minuter). Snabba trafiktoppar i några sekunder kanske inte påverkas av begränsning via programgrupper. Vi rekommenderar att du tittar på tillåtet dataflöde över tidshorisonten på några minuter för att verifiera begränsningen.

Protokollstöd och felkoder

Programgruppen stöder begränsningsåtgärder som utförs via följande protokoll – AMQP, Kafka och HTTP. I följande tabell visas de förväntade felkoderna som returneras av programgrupper:

Protokoll	Åtgärd	Felkod	Felmeddelande
AMQP	Skicka	50004	SubCode:50013, Programgruppen begränsas med programgrupps-ID och principnamn
HTTP	Skicka	503	Underkod: 50013. Programgruppen begränsas med programgrupps-ID och principnamn
Kafka	Skicka	PolicyViolation	Broker: principöverträdelse

På grund av begränsningar på protokollnivå stöds inte felmeddelanden under mottagningsåtgärden. När programgrupper begränsar mottagningsåtgärder skulle du uppleva en långsam förbrukning av meddelanden på konsumentsidan.

Inaktivera programgrupper

Programgruppen är aktiverad som standard och det innebär att alla klientprogram kan komma åt Event Hubs-namnområdet för publicering och användning av händelser genom att följa programgruppsprinciperna.

När en programgrupp är inaktiverad kan klienten fortfarande ansluta till händelsehubben, men auktoriseringen misslyckas och klientanslutningen stängs. Därför visas många lyckade öppna och stänga anslutningar med samma antal auktoriseringsfel i diagnostikloggarna.

Nästa steg

Anvisningar om hur du skapar och hanterar programgrupper finns i Resursstyrning för klientprogram med Hjälp av Azure-portalen