استخدم إجراءات المقياس التلقائي لإرسال إعلامات تنبيه البريد الإلكتروني وخطاف الويب في Azure Monitor

مقالة
11/01/2024

توضح لك هذه المقالة كيفية إعداد الإعلامات بحيث يمكنك استدعاء عناوين URL ويب معينة أو إرسال رسائل بريد إلكتروني استنادا إلى إجراءات التحجيم التلقائي في Azure.

خطاف الويب

تسمح لك الإخطارات على الويب بإرسال طلبات HTTP إلى نقطة نهاية محددة ل URL (عنوان URL لرد الاتصال) عند حدوث حدث أو مشغل معين. باستخدام خطافات الويب، يمكنك أتمتة العمليات وتبسيطها من خلال تمكين التبادل التلقائي للمعلومات بين الأنظمة أو التطبيقات المختلفة. استخدم خطافات الويب لتشغيل التعليمات البرمجية المخصصة أو الإعلامات أو الإجراءات الأخرى للتشغيل عند حدوث حدث مقياس تلقائي.

البريد الإلكتروني

يمكنك إرسال بريد إلكتروني إلى أي عنوان بريد إلكتروني صالح عند حدوث حدث مقياس تلقائي.

إشعار

بدءا من 3 أبريل 2024، لن تتمكن من إضافة أي مسؤولين مشاركين جدد لإشعارات التحجيم التلقائي في Azure. سيتم إيقاف مسؤولي Azure Classic في 31 أغسطس 2024، ولن تتمكن من إرسال إعلامات التحجيم التلقائي ل Azure باستخدام المسؤولين والمسؤولين المشاركين بعد 31 أغسطس 2024. للحصول على معلومات moe، راجع التحضير لتقاعد المسؤولين المشاركين

تكوين الإعلامات

استخدم قوالب مدخل Microsoft Azure أو CLI أو PowerShell أو Resource Manager لتكوين الإعلامات.

إعداد الإعلامات باستخدام مدخل Microsoft Azure.

حدد علامة التبويب الإعلام في صفحة إعدادات التحجيم التلقائي لتكوين الإعلامات.

أدخل قائمة بعناوين البريد الإلكتروني لإرسال الإعلامات إليها.

أدخل webhook URI لإرسال إشعار إلى خدمة ويب. يمكنك أيضا إضافة عناوين مخصصة إلى طلب إخطار على الويب. على سبيل المثال، يمكنك إضافة رمز مصادقة في العنوان أو معلمات الاستعلام أو إضافة عنوان مخصص لتحديد مصدر الطلب.

استخدم CLI لتكوين الإعلامات.

az monitor autoscale update استخدم الأمر أو az monitor autoscale create لتكوين الإعلامات باستخدام Azure CLI.

يتم استخدام المعلمات التالية لتكوين الإعلامات:

--add-action - الإجراء الذي يجب اتخاذه عند تشغيل قاعدة التحجيم التلقائي. يجب أن تكون email القيمة أو webhook، متبوعة بعنوان البريد الإلكتروني أو webhook URI.
--remove-action - إزالة إجراء تمت إضافته مسبقا بواسطة --add-action. يجب أن تكون email القيمة أو webhook. المعلمة ذات صلة az monitor autoscale update بالأمر فقط.

على سبيل المثال، يضيف الأمر التالي إعلاما بالبريد الإلكتروني وإشعار خطاف الويب وإعداد التحجيم التلقائي الموجود.

 az monitor autoscale update \
--resource-group <resource group name> \
--name <autoscale setting name> \
--add-action email pdavis@contoso.com \
--add-action webhook http://myservice.com/webhook-listerner-123

إشعار

يمكنك إضافة اقتباس من رسالة بريد إلكتروني واحدة أو إخطار على الويب باستخدام المعلمة --add-action عدة مرات. بينما يتم دعم إعلامات خطاف الويب المتعددة ويمكن رؤيتها في JSON، يعرض المدخل خطاف الويب الأول فقط.

لمزيد من المعلومات، راجع az monitor autoscale.

استخدم PowerShell لتكوين الإعلامات.

يوضح المثال التالي كيفية تكوين إخطار على الويب وإشعار البريد الإلكتروني.

إنشاء كائن webhook.
إنشاء كائن الإعلام.
أضف كائن الإعلام إلى إعداد التحجيم التلقائي باستخدام New-AzAutoscaleSetting أو Update-AzAutoscaleSetting cmdlets.

# Assumining you have already created a profile object and have a vmssName, resourceGroup, and subscriptionId

 $webhook=New-AzAutoscaleWebhookNotificationObject  `
-Property @{"method"='GET'; "headers"= '"Authorization", "tokenvalue-12345678abcdef"'} `
-ServiceUri "http://myservice.com/webhook-listerner-123"

$notification=New-AzAutoscaleNotificationObject `
-EmailCustomEmail "pdavis@contoso.com" `
-Webhook $webhook


New-AzAutoscaleSetting -Name autoscalesetting2 `
-ResourceGroupName $resourceGroup `
-Location eastus `
-Profile $profile `
-Enabled -Notification $notification `
-PropertiesName "autoscalesetting" `
-TargetResourceUri "/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/$vmssName"

استخدم قوالب Resource Manager لتكوين الإعلامات.

عند استخدام قوالب Resource Manager أو واجهة برمجة تطبيقات REST، قم بتضمين notifications العنصر في إعدادات التحجيم التلقائي، على سبيل المثال:

"notifications": [
      {
        "operation": "Scale",
        "email": {
          "sendToSubscriptionAdministrator": false,
          "sendToSubscriptionCoAdministrators": false,
          "customEmails": [
              "user1@mycompany.com",
              "user2@mycompany.com"
              ]
        },
        "webhooks": [
          {
            "serviceUri": "https://my.webhook.example.com?token=abcd1234",
            "properties": {
              "optional_key1": "optional_value1",
              "optional_key2": "optional_value2"
            }
          }
        ]
      }
    ]

الحقل	إلزامي	‏‏الوصف
`operation`	‏‏نعم‬	يجب أن تكون القيمة `Scale`.
`sendToSubscriptionAdministrator`	‏‏نعم‬	لم يعد مدعوما. يجب أن تكون القيمة `false`.
`sendToSubscriptionCoAdministrators`	‏‏نعم‬	لم يعد مدعوما. يجب أن تكون القيمة `false`.
`customEmails`	‏‏نعم‬	يمكن أن تكون القيمة خالية [] أو صفيف سلسلة من رسائل البريد الإلكتروني.
`webhooks`	‏‏نعم‬	يمكن أن تكون القيمة خالية أو URI صالحة.
`serviceUri`	‏‏نعم‬	HTTPS URI صالح.
`properties`	‏‏نعم‬	يجب أن تكون القيمة فارغة {} أو يمكن أن تحتوي على أزواج قيم المفاتيح.

المصادقة في webhooks

يمكن مصادقة خطاف الويب باستخدام المصادقة المستندة إلى الرمز المميز، حيث تقوم بحفظ عنوان URI للإخطار على الويب بمعرف رمز مميز كمعلمة استعلام. على سبيل المثال، https://mysamplealert/webcallback?tokenid=123-abc456-7890&myparameter2=value123

مخطط الحمولة النافعة لخطاف الويب لإشعارات مقياس تلقائي

عندما يتم إنشاء إعلام مقياس تلقائي، يتم تضمين بيانات التعريف التالية في حمولة الويب هوك:

{
    "version": "1.0",
    "status": "Activated",
    "operation": "Scale Out",
    "context": {
        "timestamp": "2023-06-22T07:01:47.8926726Z",
        "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/microsoft.insights/autoscalesettings/AutoscaleSettings-002",
        "name": "AutoscaleSettings-002",
        "details": "Autoscale successfully started scale operation for resource 'ScaleableAppServicePlan' from capacity '1' to capacity '2'",
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "resourceGroupName": "rg-001",
        "resourceName": "ScaleableAppServicePlan",
        "resourceType": "microsoft.web/serverfarms",
        "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/Microsoft.Web/serverfarms/ScaleableAppServicePlan",
        "portalLink": "https://portal.azure.com/#resource/subscriptions/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/resourceGroups/rg-001/providers/Microsoft.Web/serverfarms/ScaleableAppServicePlan",
        "resourceRegion": "West Central US",
        "oldCapacity": "1",
        "newCapacity": "2"
    },
    "properties": {
        "key1": "value1",
        "key2": "value2"
    }   
}

الحقل	إلزامي	‏‏الوصف
الحالة	‏‏نعم‬	الحالة التي تشير إلى أنه تم إنشاء إجراء مقياس تلقائي.
‏‏التشغيل	‏‏نعم‬	لزيادة المثيلات، إنها "توسيع النطاق". للحصول على انخفاض في المثيلات، إنه "Scale In".
السياق	‏‏نعم‬	سياق إجراء التحجيم التلقائي.
الطابع الزمني	‏‏نعم‬	الطابع الزمني عند تشغيل إجراء التحجيم التلقائي.
المعرف	‏‏نعم‬	معرف Resource Manager لإعداد التحجيم التلقائي.
الاسم	‏‏نعم‬	اسم إعداد التحجيم التلقائي.
details	‏‏نعم‬	شرح الإجراء الذي اتخذته خدمة التحجيم التلقائي والتغيير في عدد المثيلات.
subscriptionId	‏‏نعم‬	معرف الاشتراك للمورد الهدف الذي يتم تغيير حجمه.
resourceGroupName	‏‏نعم‬	اسم مجموعة الموارد للمورد الهدف الذي يتم تغيير حجمه.
resourceName	‏‏نعم‬	اسم المورد الهدف الذي يتم تغيير حجمه.
resourceType	‏‏نعم‬	ثلاث قيم مدعومة: "microsoft.classiccompute/domainnames/slots/roles" - أدوار Azure Cloud Services، "microsoft.compute/virtualmachinescalesets" - مجموعات مقياس الجهاز الظاهري Azure، و"Microsoft.Web/serverfarms" - ميزة تطبيق الويب في Azure Monitor.
resourceId	‏‏نعم‬	معرف Resource Manager للمورد الهدف الذي يتم تغيير حجمه.
PortalLink	‏‏نعم‬	ارتباط مدخل Azure بصفحة الملخص للمورد الهدف.
القدرة القديمة	‏‏نعم‬	عدد المثيلات الحالية (القديمة) عندما اتخذ التحجيم التلقائي إجراء مقياس.
القدرة الجديدة	‏‏نعم‬	عدد المثيلات الجديدة التي تحجيم تلقائي للمورد.
الخصائص	لا	اختياري. مجموعة من إقران <مفتاح وقيمة> (على سبيل المثال، قاموس <سلسلة، سلسلة>). حقل properties اختياري. في واجهة مستخدم مخصصة أو سير عمل يستند إلى التطبيق المنطقي، يمكنك إدخال المفاتيح والقيم التي يمكن تمريرها باستخدام الحمولة. هناك طريقة بديلة لتمرير الخصائص المخصصة مرة أخرى إلى استدعاء إخطار على الويب الصادر وهي استخدام عنوان URI لخطاف الويب نفسه (كمعلمات استعلام).

مشاركة عبر