التحكم في الموارد لتطبيقات العميل مع مجموعات التطبيقات

مقالة
03/09/2023

تمكنك Azure Event Hubs من التحكم في أحمال عمل تدفق الأحداث لتطبيقات العميل التي تتصل بمراكز الأحداث باستخدام مجموعات التطبيقات. لمزيد من المعلومات، راجع إدارة الموارد مع مجموعات التطبيقات.

توضح لك هذه المقالة كيفية إجراء المهام التالية:

إنشاء مجموعة تطبيقات.
تمكين مجموعة تطبيقات أو تعطيلها
تحديد حدود الحد وتطبيق نهج التقييد على مجموعة تطبيقات
التحقق من التقييد باستخدام سجلات التشخيص

إشعار

تتوفر مجموعات التطبيقات فقط في المستويات المميزة والمخصصة.

إنشاء مجموعة تطبيقات

يوضح لك هذا القسم كيفية إنشاء مجموعة تطبيقات باستخدام مدخل Azure وCLI وPowerShell وقالب Azure Resource Manager (ARM).

يمكنك إنشاء مجموعة تطبيقات باستخدام مدخل Azure باستخدام الخطوات التالية هذه.

انتقل إلى مساحة اسم مراكز الأحداث.
في القائمة اليسرى، حدد مجموعات التطبيقات ضمن الإعدادات.
في صفحة مجموعات التطبيقات، حدد + مجموعة التطبيقات على شريط الأوامر.
في صفحة إضافة مجموعة تطبيقات، اتبع هذه الخطوات:
1. حدد الاسم لمجموعة التطبيقات.
2. تأكد من تحديد ممكن. للحصول على مجموعة التطبيقات في حالة التعطيل أولاً، قم بإلغاء تحديد الخيار ممكن. تحدد هذه الإشارة ما إذا كان عملاء مجموعة التطبيقات يمكنهم الوصول إلى مراكز الأحداث أم لا.
3. بالنسبة لنوع سياق الأمان، حدد نهج الوصول المشترك لمساحة الاسم أو نهج الوصول المشترك لمركز الأحداث أو تطبيق Microsoft Entra. تدعم مجموعة التطبيقات تحديد مفتاح SAS إما على مستوى مساحة الاسم أو على مستوى الكيان (مركز الحدث). عند إنشاء مجموعة التطبيقات، يجب عليك إقران إما بتوقيعات وصول مشتركة (SAS) أو معرف تطبيق Microsoft Entra، والذي تستخدمه تطبيقات العميل.
4. إذا حددت نهج الوصول المشترك لمساحة الاسم:
  1. بالنسبة إلى اسم مفتاح SAS، حدد نهج SAS الذي يمكن استخدامه كسياق أمان لمجموعة التطبيقات هذه. يمكنك تحديد إضافة نهج SAS لإضافة نهج جديد ثم إقرانه بمجموعة التطبيقات.
5. إذا حددت نهج الوصول المشترك لمراكز الأحداث:
  1. بالنسبة إلى اسم مفتاح SAS، انسخ اسم نهج SAS من صفحة "نهج الوصول المشترك" لمراكز الأحداث والصقها في مربع النص
6. إذا حددت تطبيق Microsoft Entra:
  1. بالنسبة إلى معرف تطبيق Microsoft Entra (العميل)، حدد تطبيق Microsoft Entra أو معرف العميل.

نوع سياق الأمان المدعوم

راجع معرف مجموعة العميل الذي تم إنشاؤه تلقائياً، وهو المعرف الفريد المقترن بمجموعة التطبيقات. يعتمد نطاق إدارة التطبيق (مساحة الاسم أو مستوى الكيان) على مستوى الوصول لمعرف تطبيق Microsoft Entra المستخدم. يعرض الجدول التالي معرف مجموعة العملاء الذي تم إنشاؤه تلقائيا لنوع سياق أمان مختلف:

نوع سياق الأمان	معرف مجموعة العملاء التي تم إنشاؤها تلقائيا
مفتاح الوصول المشترك لمساحة الاسم	`NamespaceSASKeyName=<NamespaceLevelKeyName>`
تطبيق Microsoft Entra	`AADAppID=<AppID>`
مفتاح الوصول المشترك لمراكز الأحداث	`EntitySASKeyName=<EntityLevelKeyName>`

إشعار

ستستمر جميع مجموعات التطبيقات الموجودة التي تم إنشاؤها باستخدام مفتاح الوصول المشترك لمساحة الاسم في العمل مع معرف مجموعة العميل بدءا من SASKeyName. ومع ذلك، فإن جميع مجموعات التطبيقات الجديدة كانت ستحدث معرف مجموعة العملاء كما هو موضح أعلاه.

لإضافة نهج، اتبع الخطوات التالية:
1. أدخل اسماً للنهج.
2. بالنسبة إلى النوع، حدد نهج التقييد.
3. بالنسبة إلى معرف القياس، حدد أحد الخيارات التالية: الرسائل الواردة والرسائل الصادرة ووحدات البايت الواردة ووحدات البايت الصادرة. في المثال التالي، يتم تحديد الرسائل الواردة.
4. بالنسبة إلى حد المعدل، أدخل قيمة الحد. في المثال التالي، يتم تحديد 10000 كحدود لعدد الرسائل الواردة.
  
  فيما يلي لقطة شاشة للصفحة مع إضافة نهج آخر.
الآن، في صفحة إضافة مجموعة تطبيقات، حدد إضافة.
تأكد من رؤية مجموعة التطبيقات في قائمة مجموعات التطبيقات.

يمكنك حذف مجموعة التطبيقات في القائمة عن طريق تحديد زر أيقونة سلة المهملات بجوارها في القائمة.

استخدم الأمر CLI: az eventhubs namespace application-group create لإنشاء مجموعة تطبيقات على مساحة اسم مراكز الأحداث أو مستوى مركز الأحداث. يجب تعيين --client-app-group-identifier استنادا إلى نوع سياق الأمان الذي تختاره. يرجى مراجعة الجدول أعلاه لمعرفة نوع سياق الأمان المدعوم

ينشئ المثال التالي مجموعة تطبيقات باسم myAppGroup في مساحة الاسم mynamespace في مجموعة موارد AzureMyResourceGroup. يستخدم التكوينات التالية.

يتم استخدام نهج الوصول المشترك كسياق أمان
تم تعيين معرف مجموعة تطبيقات العميل إلى NamespaceSASKeyName=<NameOfTheSASkey>.
نهج التقييد الأول للمقياس Incoming messages مع 10000 كحد.
نهج التقييد الثاني للمقياس Incoming bytes مع 20000 كحد.

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

لمعرفة المزيد حول أمر CLI، راجع az eventhubs namespace application-group create.

استخدم أمر PowerShell: New-AzEventHubApplicationGroup لإنشاء مجموعة تطبيقات على مساحة اسم مراكز الأحداث أو مستوى مركز الأحداث. يجب تعيين -ClientAppGroupIdentifier استنادا إلى نوع سياق الأمان الذي تختاره. يرجى مراجعة الجدول أعلاه لمعرفة نوع سياق الأمان المدعوم

يستخدم المثال التالي New-AzEventHubThrottlingPolicyConfig لإنشاء نهجين سيتم إقرانهما بالتطبيق.

نهج التقييد الأول للمقياس Incoming bytes مع 12345 كحد.
نهج التقييد الثاني للمقياس Incoming messages مع 23416 كحد.

ثم يقوم بإنشاء مجموعة تطبيقات باسم myappgroup في مساحة الاسم mynamespace في مجموعة موارد Azure myresourcegroup عن طريق تحديد نهج التقييد ونهج الوصول المشترك كسياق أمان.

$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

لمعرفة المزيد حول أمر PowerShell، راجع New-AzEventHubApplicationGroup.

يوضح المثال التالي كيفية إنشاء مجموعة تطبيقات باستخدام قالب ARM. في هذا المثال، ترتبط مجموعة التطبيقات باسم نهج SAS موجود contososaspolicy عن طريق تعيين العميل AppGroupIdentifier على أنه NamespaceSASKeyName=contososaspolicy. يتم تعريف نهج مجموعة التطبيقات أيضا في قالب ARM. يجب تعيين ClientAppGroupIdentifier استنادا إلى نوع سياق الأمان الذي تختاره. يرجى مراجعة الجدول أعلاه لمعرفة نوع سياق الأمان المدعوم

{
	"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
	}
}

تمكين مجموعة تطبيقات أو تعطيلها

يمكنك منع تطبيقات العميل من الوصول إلى مساحة اسم Event Hubs عن طريق تعطيل مجموعة التطبيقات التي تحتوي على هذه التطبيقات. عند تعطيل مجموعة التطبيقات، لن تتمكن تطبيقات العميل من نشر البيانات أو استهلاكها. سيتم أيضا إنهاء أي اتصالات أنشئت من تطبيقات العميل لمجموعة التطبيقات هذه.

يوضح لك هذا القسم كيفية تمكين مجموعة تطبيقات أو تعطيلها باستخدام مدخل Azure وPowerShell وCLI وقالب ARM.

في صفحة مساحة اسم مراكز الأحداث، حدد مجموعات التطبيقات في القائمة اليسري.
حدد مجموعة التطبيقات التي تريد تمكينها أو تعطيلها.
في صفحة تحرير مجموعة التطبيقات، قم بإلغاء تحديد خانة الاختيار بجوار ممكن لتعطيل مجموعة تطبيقات، ثم حدد تحديث في أسفل الصفحة. وبالمثل، حدد خانة الاختيار لتمكين مجموعة تطبيقات.

استخدم الأمر az eventhubs namespace application-group update مع --is-enabled الذي تم تعيينه إلى falseلتعطيل مجموعة تطبيقات. وبالمثل، لتمكين مجموعة تطبيقات، قم بتعيين هذه الخاصية إلى true وتشغيل الأمر.

يعطل الأمر النموذجي التالي مجموعة التطبيقات المسماة myappgroup في مساحة اسم مراكز الأحداث mynamespace الموجودة في مجموعة الموارد myresourcegroup.

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

استخدم الأمر Set-AzEventHubApplicationGroup باستخدام -IsEnabled الذي تم تعيينه إلى false لتعطيل مجموعة تطبيقات. وبالمثل، لتمكين مجموعة تطبيقات، قم بتعيين هذه الخاصية إلى true وتشغيل الأمر.

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

يوضح قالب ARM التالي كيفية تحديث مساحة اسم موجودة (contosonamespace) لتعطيل مجموعة تطبيقات عن طريق تعيين الخاصية isEnabled إلى false. معرف مجموعة التطبيقات هو SASKeyName=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": "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
			}
		]
      }
    }
  ]
}

تطبيق نهج التقييد

يمكنك إضافة صفر أو أكثر من النهج عند إنشاء مجموعة تطبيقات أو إلى مجموعة تطبيقات موجودة. على سبيل المثال، يمكنك إضافة نهج التقييد المتعلقة ب IncomingMessagesأو IncomingBytesOutgoingBytes إلى contosoAppGroup. سيتم تطبيق هذه النهج على أحمال عمل تدفق الأحداث لتطبيقات العميل التي تستخدم نهج contososaspolicySAS .

لمعرفة كيفية إضافة نُهج أثناء إنشاء مجموعة تطبيقات، راجع قسم إنشاء مجموعة تطبيقات.

يمكنك أيضاً إضافة نًهج بعد إنشاء مجموعة تطبيقات.

في صفحة مساحة اسم مراكز الأحداث، حدد مجموعات التطبيقات في القائمة اليسري.
حدد مجموعة التطبيقات التي تريد إضافتها أو تحديثها أو حذفها.
في صفحة تحرير مجموعة التطبيقات، يمكنك القيام بالخطوات التالية:
1. تحديث الإعدادات (بما في ذلك قيم الحد) للنهج الموجودة
2. إضافة نهج جديد

استخدم az eventhubs namespace application-group policy add لإضافة نهج إلى مجموعة تطبيقات موجودة.

مثال:

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

استخدم الأمر Set-AzEventHubApplicationGroup مع تعيين -ThrottlingPolicyConfig إلى القيم المناسبة.

مثال:

$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 التالي كيفية تحديث مساحة اسم موجودة (contosonamespace) لإضافة نهج التقييد. معرف مجموعة التطبيقات هو 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
			}
		]
      }
    }
  ]
}

تحديد قيمة الحد لنهج التقييد

تدعم Azure Event Hubs وظيفة Application Metric Logs لمراقبة معدل النقل المعتاد داخل النظام الخاص بك، وبالتالي تحديد قيمة الحد لمجموعة التطبيقات. يمكنك اتباع هذه الخطوات لاتخاذ قرار بشأن قيمة الحد:

قم بتشغيل إعدادات التشخيص في مراكز الأحداث باستخدام سجلات Application Metric كفئة محددة واختر Log Analytics كوجهة.
إنشاء مجموعة تطبيقات فارغة دون أي نهج تقييد.
استمر في إرسال الرسائل/الأحداث إلى مركز الأحداث بمعدل النقل المعتاد.
انتقل إلى مساحة عمل Log Analytics والاستعلام عن اسم النشاط الصحيح (استنادا إلى (resource-governance-overview.md#throttling-policy---threshold-limits)) في جدول AzureDiagnostics . تم تعيين نموذج الاستعلام التالي لتعقب قيمة الحد للرسائل الواردة:
```
AzureDiagnostics 
    | where ActivityName_s =="IncomingMessages" 
    | where Outcome_s =="Success"      
```
حدد قسم المخطط في مساحة عمل Log Analytics وارسم مخططا بين الوقت الذي تم إنشاؤه على المحور ص وعدد الرسائل المرسلة على المحور س.

في هذا المثال، يمكنك أن ترى أن معدل النقل المعتاد لم يتجاوز أبدا أكثر من 550 رسالة (معدل النقل الحالي المتوقع). تساعدك هذه الملاحظة على تحديد قيمة الحد الفعلي.
بمجرد تحديد قيمة الحد، أضف نهج تقييد جديد داخل مجموعة التطبيقات.

نشر الأحداث أو استهلاكها

بمجرد إضافة نهج التقييد بنجاح إلى مجموعة التطبيقات، يمكنك اختبار سلوك التقييد عن طريق نشر الأحداث أو استهلاكها باستخدام تطبيقات العميل التي تعد جزءا من contosoAppGroup مجموعة التطبيقات. للاختبار، يمكنك استخدام إما عميل AMQP أو تطبيق عميل Kafka واسم نهج SAS نفسه أو معرف تطبيق Microsoft Entra المستخدم لإنشاء مجموعة التطبيقات.

إشعار

عند تقييد تطبيقات العميل، يجب أن تواجه بطءا في نشر البيانات أو استهلاكها.

التحقق من التقييد باستخدام مجموعات التطبيقات

على غرار حدود تحديد الحد لنهج التقييد، يمكنك استخدام سجلات Application Metric للتحقق من التقييد والعثور على مزيد من التفاصيل.

يمكنك استخدام استعلام المثال أدناه لمعرفة جميع الطلبات المقيدة في إطار زمني معين. يجب تحديث ActivityName لمطابقة العملية التي تتوقع تقييدها.


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

نظرا للقيود على مستوى البروتوكول، لا يتم إنشاء سجلات الطلبات المقيدة لعمليات المستهلك داخل مركز الحدث ( OutgoingMessages أو OutgoingBytes). عندما يتم تقييد الطلبات من جانب المستهلك، ستلاحظ معدل نقل خروج عابث.

الخطوات التالية

للحصول على معلومات مفاهيمية حول مجموعات التطبيقات، راجع إدارة الموارد مع مجموعات التطبيقات.
راجع مرجع Azure PowerShell لمراكز الأحداث
راجع مرجع Azure CLI لمراكز الأحداث

مشاركة عبر

التحكم في الموارد لتطبيقات العميل مع مجموعات التطبيقات

إنشاء مجموعة تطبيقات

نوع سياق الأمان المدعوم

تمكين مجموعة تطبيقات أو تعطيلها

تطبيق نهج التقييد

تحديد قيمة الحد لنهج التقييد

نشر الأحداث أو استهلاكها

التحقق من التقييد باستخدام مجموعات التطبيقات

الخطوات التالية

الملاحظات

الموارد الإضافية