Resources beheren voor clienttoepassingen met toepassingsgroepen

Met Azure Event Hubs kunt u workloads voor gebeurtenisstreaming beheren voor clienttoepassingen die verbinding maken met Event Hubs met behulp van toepassingsgroepen. Zie Resourcebeheer met toepassingsgroepen voor meer informatie.

In dit artikel wordt beschreven hoe u de volgende taken kunt uitvoeren:

• Maak een toepassingsgroep.
• Een toepassingsgroep in- of uitschakelen
• Drempelwaarden definiëren en beperkingsbeleid toepassen op een toepassingsgroep
• Beperking valideren met diagnostische logboeken

Notitie

Toepassingsgroepen zijn alleen beschikbaar in premium - en toegewezen lagen.

Een toepassingsgroep maken

In deze sectie wordt beschreven hoe u een toepassingsgroep maakt met behulp van Azure Portal, CLI, PowerShell en een ARM-sjabloon (Azure Resource Manager).

Azure-portal

U kunt een toepassingsgroep maken met behulp van Azure Portal door deze stappen uit te voeren.

1. Navigeer naar uw Event Hubs-naamruimte.

2. Selecteer in het linkermenu toepassingsgroepen onder Instellingen.

3. Selecteer + Toepassingsgroep op de opdrachtbalk op de pagina Toepassingsgroepen.

   

4. Voer op de pagina Toepassingsgroep toevoegen de volgende stappen uit:

   1. Geef een naam op voor de toepassingsgroep.

   2. Controleer of Ingeschakeld is geselecteerd. Als u wilt dat de toepassingsgroep eerst de status Uitgeschakeld heeft, schakelt u de optie Ingeschakeld uit. Met deze vlag wordt bepaald of de clients van een toepassingsgroep toegang hebben tot Event Hubs of niet.

   3. Selecteer voor het contexttype Beveiliging het beleid voor gedeelde toegang voor naamruimte, het beleid voor gedeelde toegang van event hub of de Microsoft Entra-toepassing. Toepassingsgroep ondersteunt de selectie van SAS-sleutel op naamruimte of op entiteitsniveau (Event Hub). Wanneer u de toepassingsgroep maakt, moet u koppelen aan een SAS (Shared Access Signatures) of microsoft Entra-toepassings-id, die wordt gebruikt door clienttoepassingen.

   4. Als u beleid voor gedeelde toegang voor naamruimte hebt geselecteerd:

      1. Selecteer voor de SAS-sleutelnaam het SAS-beleid dat kan worden gebruikt als beveiligingscontext voor deze toepassingsgroep. U kunt SAS-beleid toevoegen selecteren om een nieuw beleid toe te voegen en vervolgens aan de toepassingsgroep te koppelen.

         

   5. Als u Beleid voor gedeelde toegang van Event Hubs hebt geselecteerd:

      1. Kopieer voor de SAS-sleutelnaam de sas-beleidsnaam van de pagina Gedeeld toegangsbeleid van Event Hubs en plak deze in het tekstvak

         

   6. Als u Microsoft Entra-toepassing hebt geselecteerd:

      1. Geef voor de Microsoft Entra-toepassings-id (client) de Microsoft Entra-toepassing of client-id op.

      

Ondersteund type beveiligingscontext

Controleer de automatisch gegenereerde clientgroep-id. Dit is de unieke id die is gekoppeld aan de toepassingsgroep. Het bereik van toepassingsbeheer (naamruimte of entiteitsniveau) is afhankelijk van het toegangsniveau voor de gebruikte Microsoft Entra-toepassings-id. In de volgende tabel ziet u de automatisch gegenereerde clientgroep-id voor een ander type beveiligingscontext:

Type beveiligingscontext	Automatisch gegenereerde clientgroep-id
Gedeelde toegangssleutel voor naamruimte	NamespaceSASKeyName=<NamespaceLevelKeyName>
Microsoft Entra-toepassing	AADAppID=<AppID>
Gedeelde toegangssleutel van Event Hubs	EntitySASKeyName=<EntityLevelKeyName>

Notitie

Alle bestaande toepassingsgroepen die zijn gemaakt met de gedeelde toegangssleutel van de naamruimte, blijven werken met de clientgroep-id vanaf SASKeyName. Alle nieuwe toepassingsgroepen hebben echter de clientgroep-id bijgewerkt, zoals hierboven wordt weergegeven.

1. Voer de volgende stappen uit om een beleid toe te voegen:

   1. Voer een naam in voor het beleid.

   2. Voor Type selecteert u beperkingsbeleid.

   3. Selecteer voor metrische id een van de volgende opties: Binnenkomende berichten, uitgaande berichten, binnenkomende bytes, uitgaande bytes. In het volgende voorbeeld worden binnenkomende berichten geselecteerd.

   4. Voer de drempelwaarde voor frequentielimiet in. In het volgende voorbeeld wordt 10000 opgegeven als drempelwaarde voor het aantal binnenkomende berichten.

      

      Hier volgt een schermopname van de pagina met een ander beleid toegevoegd.

      

2. Selecteer nu op de pagina Toepassingsgroep toevoegen de optie Toevoegen.

3. Controleer of u de toepassingsgroep in de lijst met toepassingsgroepen ziet.

   

   U kunt de toepassingsgroep in de lijst verwijderen door de prullenbakknop ernaast in de lijst te selecteren.

Azure-CLI

Gebruik de CLI-opdracht: az eventhubs namespace application-group create een toepassingsgroep maken op Event Hubs-naamruimte of Event Hub-niveau. U moet --client-app-group-identifier instellen op basis van het type beveiligingscontext dat u kiest. Raadpleeg de bovenstaande tabel om te weten welk type beveiligingscontext wordt ondersteund

In het volgende voorbeeld wordt een toepassingsgroep gemaakt met de naamruimte myAppGroupmynamespace in de Azure-resourcegroep MyResourceGroup. Hierbij worden de volgende configuraties gebruikt.

• Beleid voor gedeelde toegang wordt gebruikt als beveiligingscontext
• De groeps-id van de client-app is ingesteld op NamespaceSASKeyName=<NameOfTheSASkey>.
• Eerste beperkingsbeleid voor de Incoming messages metrische waarde met 10000 als drempelwaarde.
• Second throttling policy for the Incoming bytes metric with 20000 as the threshold.

az eventhubs namespace application-group create --namespace-name mynamespace \
                                                -g MyResourceGroup \
                                                --name myAppGroup \
                                                --client-app-group-identifier NamespaceSASKeyName=keyname \
                                                --throttling-policy-config name=policy1 metric-id=IncomingMessages rate-limit-threshold=10000 \
                                                --throttling-policy-config name=policy2 metric-id=IncomingBytes rate-limit-threshold=20000

Zie az eventhubs namespace application-group createvoor meer informatie over de CLI-opdracht.

Azure PowerShell

Gebruik de PowerShell-opdracht: New-AzEventHubApplicationGroup een toepassingsgroep maken op Event Hubs-naamruimte of Event Hub-niveau. U moet -ClientAppGroupIdentifier instellen op basis van het type beveiligingscontext dat u kiest. Raadpleeg de bovenstaande tabel om te weten welk type beveiligingscontext wordt ondersteund

In het volgende voorbeeld wordt gebruikgemaakt van het New-AzEventHubThrottlingPolicyConfig maken van twee beleidsregels die aan de toepassing worden gekoppeld.

• Eerste beperkingsbeleid voor de Incoming bytes metrische waarde met 12345 als drempelwaarde.
• Second throttling policy for the Incoming messages metric with 23416 as the threshold.

Vervolgens wordt er een toepassingsgroep gemaakt met de naam myappgroup in de naamruimte mynamespace in de Azure-resourcegroep myresourcegroup door het beperkingsbeleid en het gedeelde toegangsbeleid op te geven als beveiligingscontext.

$policy1 = New-AzEventHubThrottlingPolicyConfig -Name policy1 -MetricId IncomingBytes -RateLimitThreshold 12345

$policy2 = New-AzEventHubThrottlingPolicyConfig -Name policy2 -MetricId IncomingMessages -RateLimitThreshold 23416

New-AzEventHubApplicationGroup -ResourceGroupName myresourcegroup -NamespaceName mynamespace -Name myappgroup 
		-ClientAppGroupIdentifier NamespaceSASKeyName=myauthkey -ThrottlingPolicyConfig $policy1, $policy2

Zie New-AzEventHubApplicationGroupvoor meer informatie over de PowerShell-opdracht.

ARM-sjabloon

In het volgende voorbeeld ziet u hoe u een toepassingsgroep maakt met behulp van een ARM-sjabloon. In dit voorbeeld is de toepassingsgroep gekoppeld aan een bestaande SAS-beleidsnaam contososaspolicy door de client AppGroupIdentifier in te stellen op NamespaceSASKeyName=contososaspolicy. Het groepsbeleid voor toepassingen wordt ook gedefinieerd in de ARM-sjabloon. U moet ClientAppGroupIdentifier instellen op basis van het type beveiligingscontext dat u kiest. Raadpleeg de bovenstaande tabel om te weten welk type beveiligingscontext wordt ondersteund

{
	"type": "ApplicationGroups",
	"apiVersion": "2022-01-01-preview",
	"name": "[parameters('applicationGroupName')]",
	"dependsOn": [
		"[resourceId('Microsoft.EventHub/namespaces/', parameters('eventHubNamespaceName'))]",
		"[resourceId('Microsoft.EventHub/namespaces/authorizationRules', parameters('eventHubNamespaceName'),parameters('namespaceAuthorizationRuleName'))]"
	],
	"properties": {
		"ClientAppGroupIdentifier": "NamespaceSASKeyName=contososaspolicy",
		"policies": [{
				"Type": "ThrottlingPolicy",
				"Name": "ThrottlingPolicy1",
				"metricId": "IncomingMessages",
				"rateLimitThreshold": 10
			},
			{
				"Type": "ThrottlingPolicy",
				"Name": "ThrottlingPolicy2",
				"metricId": "IncomingBytes",
				"rateLimitThreshold": 3951729
			}
		],
		"isEnabled": true
	}
}

Een toepassingsgroep in- of uitschakelen

U kunt voorkomen dat clienttoepassingen toegang hebben tot uw Event Hubs-naamruimte door de toepassingsgroep die deze toepassingen bevat uit te schakelen. Wanneer de toepassingsgroep is uitgeschakeld, kunnen clienttoepassingen geen gegevens publiceren of gebruiken. Alle tot stand gebrachte verbindingen van clienttoepassingen van die toepassingsgroep worden ook beëindigd.

In deze sectie wordt beschreven hoe u een toepassingsgroep kunt in- of uitschakelen met behulp van de Azure-portal, PowerShell, CLI en ARM-sjabloon.

Azure-portal

1. Selecteer toepassingsgroepen in het linkermenu op de pagina Event Hubs-naamruimte.

2. Selecteer de toepassingsgroep die u wilt in- of uitschakelen.

   

3. Schakel op de pagina Toepassingsgroep bewerken het selectievakje naast Ingeschakeld uit om een toepassingsgroep uit te schakelen en selecteer vervolgens Bijwerken onder aan de pagina. Schakel op dezelfde manier het selectievakje in om een toepassingsgroep in te schakelen.

   

Azure-CLI

Gebruik de az eventhubs namespace application-group update opdracht met --is-enabled de set om een toepassingsgroep uit te false schakelen. Als u een toepassingsgroep wilt inschakelen, stelt u deze eigenschap true in op de opdracht en voert u deze uit.

Met de volgende voorbeeldopdracht wordt de toepassingsgroep met de naam in myappgroup de Event Hubs-naamruimte mynamespace uitgeschakeld die zich in de resourcegroep myresourcegroupbevindt.

az eventhubs namespace application-group update --namespace-name mynamespace -g myresourcegroup --name myappgroup --is-enabled false

Azure PowerShell

Gebruik de opdracht Set-AzEventHubApplicationGroup met de opdracht Set-AzEventHubApplicationGroup om -IsEnabled een toepassingsgroep uit te false schakelen. Als u een toepassingsgroep wilt inschakelen, stelt u deze eigenschap true in op de opdracht en voert u deze uit.

Met de volgende voorbeeldopdracht wordt de toepassingsgroep met de naam in myappgroup de Event Hubs-naamruimte mynamespace uitgeschakeld die zich in de resourcegroep myresourcegroupbevindt.

Set-AzEventHubApplicationGroup -ResourceGroupName myresourcegroup -NamespaceName mynamespace -Name myappgroup -IsEnabled false

ARM-sjabloon

In de volgende ARM-sjabloon ziet u hoe u een bestaande naamruimte (contosonamespace) bijwerkt om een toepassingsgroep uit te schakelen door de isEnabled eigenschap in te stellen op false. De id voor de app-groep is SASKeyName=RootManageSharedAccessKey.

Notitie

In het volgende voorbeeld worden ook twee beperkingsbeleidsregels toegevoegd

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "namespace_name": {
      "defaultValue": "contosonamespace",
      "type": "String"
    },
    "client-app-group-identifier": {
      "defaultValue": "SASKeyName=RootManageSharedAccessKey",
      "type": "String"
    }
  },
  "resources": [
    {
      "type": "Microsoft.EventHub/namespaces/applicationGroups",
      "apiVersion": "2022-01-01-preview",
      "name": "[concat(parameters('namespace_name'), '/contosoappgroup')]",
      "properties": {
        "clientAppGroupIdentifier": "[parameters('client-app-group-identifier')]",
        "isEnabled": false,
		"policies": [
			{
				"type": "ThrottlingPolicy",
				"name": "incomingmsgspolicy",
				"metricId": "IncomingMessages",
				"rateLimitThreshold": 10000
			},
			{
				"type": "ThrottlingPolicy",
				"name": "incomingbytespolicy",
				"metricId": "IncomingBytes",
				"rateLimitThreshold": 20000
			}
		]
      }
    }
  ]
}

Beperkingsbeleid toepassen

U kunt nul of meer beleidsregels toevoegen wanneer u een toepassingsgroep of een bestaande toepassingsgroep maakt. U kunt bijvoorbeeld beperkingsbeleid met betrekking tot IncomingMessagesof IncomingBytesOutgoingBytes aan de contosoAppGroup. Deze beleidsregels worden toegepast op workloads voor gebeurtenisstreaming van clienttoepassingen die gebruikmaken van het SAS-beleid contososaspolicy.

Zie de sectie Een toepassingsgroep maken voor meer informatie over het toevoegen van beleidsregels tijdens het maken van een toepassingsgroep .

U kunt ook beleidsregels toevoegen nadat een toepassingsgroep is gemaakt.

Azure-portal

1. Selecteer toepassingsgroepen in het linkermenu op de pagina Event Hubs-naamruimte.

2. Selecteer de toepassingsgroep die u wilt toevoegen, bijwerken of verwijderen.

   

3. Op de pagina Toepassingsgroep bewerken kunt u de volgende stappen uitvoeren:

   1. Instellingen bijwerken (inclusief drempelwaarden) voor bestaand beleid
   2. Een nieuw beleid toevoegen

Azure-CLI

Gebruik de az eventhubs namespace application-group policy add opdracht om een beleid toe te voegen aan een bestaande toepassingsgroep.

Voorbeeld:

az eventhubs namespace application-group policy add --namespace-name mynamespace -g MyResourceGroup --name myAppGroup --throttling-policy-config name=policy1 metric-id=OutgoingMessages rate-limit-threshold=10500 --throttling-policy-config name=policy2 metric-id=IncomingBytes rate-limit-threshold=20000

Azure PowerShell

Gebruik de opdracht Set-AzEventHubApplicationGroup met -ThrottingPolicyConfig ingesteld op de juiste waarden.

Voorbeeld:

$policyToBeAppended = New-AzEventHubThrottlingPolicyConfig -Name policy1 -MetricId IncomingBytes -RateLimitThreshold 12345

$appGroup = Get-AzEventHubApplicationGroup -ResourceGroupName myresourcegroup -NamespaceName mynamespace -Name myappgroup

$appGroup.ThrottlingPolicyConfig += $policyToBeAppended

Set-AzEventHubApplicationGroup -ResourceGroupName myresourcegroup -NamespaceName mynamespace -Name myappgroup -ThrottlingPolicyConfig $appGroup.ThrottlingPolicyConfig

ARM-sjabloon

In de volgende ARM-sjabloon ziet u hoe u een bestaande naamruimte (contosonamespace) bijwerkt om beperkingsbeleid toe te voegen. De id voor de app-groep is NamespaceSASKeyName=RootManageSharedAccessKey.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "namespace_name": {
      "defaultValue": "contosonamespace",
      "type": "String"
    },
    "client-app-group-identifier": {
      "defaultValue": "NamespaceSASKeyName=RootManageSharedAccessKey",
      "type": "String"
    }
  },
  "resources": [
    {
      "type": "Microsoft.EventHub/namespaces/applicationGroups",
      "apiVersion": "2022-01-01-preview",
      "name": "[concat(parameters('namespace_name'), '/contosoappgroup')]",
      "properties": {
        "clientAppGroupIdentifier": "[parameters('client-app-group-identifier')]",
        "isEnabled": true,
		"policies": [
			{
				"type": "ThrottlingPolicy",
				"name": "incomingmsgspolicy",
				"metricId": "IncomingMessages",
				"rateLimitThreshold": 10000
			},
			{
				"type": "ThrottlingPolicy",
				"name": "incomingbytespolicy",
				"metricId": "IncomingBytes",
				"rateLimitThreshold": 20000
			}
		]
      }
    }
  ]
}

Drempelwaarde bepalen voor beperkingsbeleid

Azure Event Hubs ondersteunt functionaliteit voor metrische toepassingslogboeken om de gebruikelijke doorvoer binnen uw systeem te observeren en dienovereenkomstig de drempelwaarde voor de toepassingsgroep te bepalen. U kunt deze stappen volgen om een drempelwaarde te bepalen:

1. Schakel diagnostische instellingen in Event Hubs met metrische toepassingslogboeken in als geselecteerde categorie en kies Log Analytics als bestemming.

2. Maak een lege toepassingsgroep zonder beperkingsbeleid.

3. Ga door met het verzenden van berichten/gebeurtenissen naar Event Hub op gebruikelijke doorvoer.

4. Ga naar de Log Analytics-werkruimte en voer een query uit voor de juiste activiteitsnaam (op basis van de tabel resource-governance-overview.md#throttling-policy---threshold-limits)) in de tabel AzureDiagnostics . De volgende voorbeeldquery is ingesteld om de drempelwaarde voor binnenkomende berichten bij te houden:

   AzureDiagnostics 
       | where ActivityName_s =="IncomingMessages" 
       | where Outcome_s =="Success"      
   

5. Selecteer de sectie Grafiek in de Log Analytics-werkruimte en teken een grafiek tussen de tijd die is gegenereerd op de Y-as en het aantal berichten dat op de x-as wordt verzonden.

   

   In dit voorbeeld ziet u dat de gebruikelijke doorvoer nooit meer dan 550 berichten heeft overschreden (verwachte huidige doorvoer). Deze observatie helpt u bij het definiëren van de werkelijke drempelwaarde.

6. Zodra u de drempelwaarde hebt bepaald, voegt u een nieuw beperkingsbeleid toe in de toepassingsgroep.

Gebeurtenissen publiceren of gebruiken

Zodra u beperkingsbeleid hebt toegevoegd aan de toepassingsgroep, kunt u het beperkingsgedrag testen door gebeurtenissen te publiceren of te gebruiken met behulp van clienttoepassingen die deel uitmaken van de contosoAppGroup toepassingsgroep. Als u wilt testen, kunt u een AMQP-client of een Kafka-clienttoepassing en dezelfde SAS-beleidsnaam of microsoft Entra-toepassings-id gebruiken die wordt gebruikt om de toepassingsgroep te maken.

Notitie

Wanneer uw clienttoepassingen worden beperkt, moet u te maken krijgen met traagheid bij het publiceren of gebruiken van gegevens.

Beperking valideren met toepassingsgroepen

Net als bij het bepalen van drempelwaarden voor beperkingsbeleid, kunt u metrische toepassingslogboeken gebruiken om beperking te valideren en meer informatie te vinden.

U kunt de onderstaande voorbeeldquery gebruiken om alle beperkte aanvragen in een bepaalde periode te achterhalen. U moet de ActivityName bijwerken zodat deze overeenkomt met de bewerking die u verwacht te beperken.

  AzureDiagnostics 
  |  where Category =="ApplicationMetricsLogs"
  | where ActivityName_s =="IncomingMessages" 
  | where Outcome_s =="Throttled"  
	

Vanwege beperkingen op protocolniveau worden beperkte aanvraaglogboeken niet gegenereerd voor consumentenbewerkingen binnen Event Hub ( OutgoingMessages of OutgoingBytes). wanneer aanvragen worden beperkt aan de kant van de consument, ziet u trage uitgaande doorvoer.

Volgende stappen

• Zie Resourcebeheer met toepassingsgroepen voor conceptuele informatie over toepassingsgroepen.
• Raadpleeg azure PowerShell-naslaginformatie voor Event Hubs
• Raadpleeg azure CLI-naslaginformatie voor Event Hubs