Azure İzleyici'de e-posta ve web kancası uyarı bildirimleri göndermek için otomatik ölçeklendirme eylemlerini kullanma

Bu makalede, Azure'daki otomatik ölçeklendirme eylemlerine göre belirli web URL'lerini çağırabilmeniz veya e-posta gönderebilmeniz için bildirimlerin nasıl ayarlanacağı gösterilmektedir.

Web Kancaları

Web kancaları, belirli bir olay veya tetikleyici gerçekleştiğinde belirli bir URL uç noktasına (geri çağırma URL'si) HTTP istekleri göndermenizi sağlar. Web kancalarını kullanarak, farklı sistemler veya uygulamalar arasında otomatik bilgi alışverişini etkinleştirerek işlemleri otomatikleştirebilir ve kolaylaştırabilirsiniz. Otomatik ölçeklendirme olayı gerçekleştiğinde çalıştırılacak özel kodu, bildirimleri veya diğer eylemleri tetikleme amacıyla web kancalarını kullanın.

E-posta

Otomatik ölçeklendirme olayı gerçekleştiğinde geçerli herhangi bir e-posta adresine e-posta gönderebilirsiniz. Kuralın çalıştırıldığı aboneliğin yöneticilerine ve ortak yöneticilerine de bildirim gönderilir.

Bildirimleri Yapılandırma

Bildirimleri yapılandırmak için Azure portal, CLI, PowerShell veya Resource Manager şablonlarını kullanın.

Portal

Azure portal kullanarak bildirimleri ayarlayın.

Bildirimleri yapılandırmak için otomatik ölçeklendirme ayarları sayfasında Bildirim sekmesini seçin.

Abonelik yöneticisine veya ortak yöneticilere e-posta göndermek için onay kutularını seçin. Bildirim göndermek için e-posta adreslerinin listesini de girebilirsiniz.

Web hizmetine bildirim göndermek için bir web kancası URI'sini girin. Web kancası isteğine özel üst bilgiler de ekleyebilirsiniz. Örneğin, üst bilgi, sorgu parametrelerine kimlik doğrulama belirteci ekleyebilir veya isteğin kaynağını tanımlamak için özel bir üst bilgi ekleyebilirsiniz.

CLI

Bildirimleri yapılandırmak için CLI kullanın.

az monitor autoscale update Azure CLI kullanarak bildirimleri yapılandırmak için veya az monitor autoscale create komutunu kullanın.

Bildirimleri yapılandırmak için aşağıdaki parametreler kullanılır:

• --add-action - Otomatik ölçeklendirme kuralı tetiklendiğinde gerçekleştirilen eylem. Değer veya webhookolmalıdıremail.
• --email-administrator {false, true} - Abonelik yöneticisine e-posta gönderin.
• --email-coadministrators {false, true} - Abonelik ortak yöneticilerine e-posta gönderin.
• --remove-action - Daha önce tarafından --add-actioneklenen bir eylemi kaldırın. Değer veya webhookolmalıdıremail. parametresi yalnızca komutuyla az monitor autoscale update ilgilidir.

Örneğin, aşağıdaki komut ve mevcut otomatik ölçeklendirme ayarına bir e-posta bildirimi ve bir web kancası bildirimi ekler. Komut ayrıca abonelik yöneticisine e-posta gönderir.

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

Not

parametresini birden çok kez kullanarak birden çok e-posta veya web kancası --add-action bildirimi ekleyebilirsiniz. Birden çok web kancası bildirimi desteklenir ve JSON'da görülebilir, ancak portal yalnızca ilk web kancasını gösterir.

Daha fazla bilgi için bkz. az monitor autoscale.

PowerShell

Bildirimleri yapılandırmak için PowerShell'i kullanın.

Aşağıdaki örnekte web kancası ve e-posta bildiriminin nasıl yapılandırılacağını gösterilmektedir.

1. Web kancası nesnesini oluşturun.

2. Bildirim nesnesini oluşturun.

3. veya Update-AzAutoscaleSetting cmdlet'lerini kullanarak New-AzAutoscaleSetting bildirim nesnesini otomatik ölçeklendirme ayarına ekleyin.

# 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" `
-EmailSendToSubscriptionAdministrator $true ` -EmailSendToSubscriptionCoAdministrator $true `
-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

Bildirimleri yapılandırmak için Resource Manager şablonları kullanın.

Resource Manager şablonlarını veya REST API'sini notifications kullandığınızda, öğesini otomatik ölçeklendirme ayarlarınıza ekleyin, örneğin:

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

Alan	Zorunlu	Description
operation	Yes	Değer "Ölçek" olmalıdır.
sendToSubscriptionAdministrator	Yes	Değer "true" veya "false" olmalıdır.
sendToSubscriptionCoAdministrators	Yes	Değer "true" veya "false" olmalıdır.
customEmails	Yes	Değer null [] veya e-posta dize dizisi olabilir.
web kancaları	Yes	Değer null veya geçerli URI olabilir.
serviceUri	Yes	Geçerli HTTPS URI'si.
properties	Yes	Değer boş {} olmalıdır veya anahtar-değer çiftleri içerebilir.

Web kancalarında kimlik doğrulaması

Web kancası, web kancası URI'sini bir belirteç kimliğiyle sorgu parametresi olarak kaydettiğiniz belirteç tabanlı kimlik doğrulamasını kullanarak kimlik doğrulaması yapabilir. Örneğin, https://mysamplealert/webcallback?tokenid=123-abc456-7890&myparameter2=value123.

Otomatik ölçeklendirme bildirimi web kancası yük şeması

Otomatik ölçeklendirme bildirimi oluşturulduğunda, web kancası yüküne aşağıdaki meta veriler eklenir:

{
    "version": "1.0",
    "status": "Activated",
    "operation": "Scale Out",
    "context": {
        "timestamp": "2023-06-22T07:01:47.8926726Z",
        "id": "/subscriptions/123456ab-9876-a1b2-a2b1-123a567b9f8767/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": "123456ab-9876-a1b2-a2b1-123a567b9f8767",
        "resourceGroupName": "rg-001",
        "resourceName": "ScaleableAppServicePlan",
        "resourceType": "microsoft.web/serverfarms",
        "resourceId": "/subscriptions/123456ab-9876-a1b2-a2b1-123a567b9f8767/resourceGroups/rg-001/providers/Microsoft.Web/serverfarms/ScaleableAppServicePlan",
        "portalLink": "https://portal.azure.com/#resource/subscriptions/123456ab-9876-a1b2-a2b1-123a567b9f8767/resourceGroups/rg-001/providers/Microsoft.Web/serverfarms/ScaleableAppServicePlan",
        "resourceRegion": "West Central US",
        "oldCapacity": "1",
        "newCapacity": "2"
    },
    "properties": {
        "key1": "value1",
        "key2": "value2"
    }   
}

Alan	Zorunlu	Description
durum	Yes	Otomatik ölçeklendirme eyleminin oluşturulduğunu gösteren durum.
operation	Yes	Örneklerin artması için "Ölçeği Genişlet" şeklindedir. Örneklerde düşüş olması için "Ölçeği Daralt" şeklindedir.
bağlam	Yes	Otomatik ölçeklendirme eylemi bağlamı.
timestamp	Yes	Otomatik ölçeklendirme eyleminin tetiklendiğinde zaman damgası.
kimlik	Yes	Otomatik ölçeklendirme ayarının kimliğini Resource Manager.
name	Yes	Otomatik ölçeklendirme ayarının adı.
ayrıntılar	Yes	Otomatik ölçeklendirme hizmetinin gerçekleştirilen eylemin ve örnek sayısındaki değişikliğin açıklaması.
subscriptionId	Yes	Ölçeklendirilmekte olan hedef kaynağın abonelik kimliği.
resourceGroupName	Yes	Ölçeklendirilmekte olan hedef kaynağın kaynak grubu adı.
resourceName	Yes	Ölçeklendirilen hedef kaynağın adı.
resourceType	Yes	Desteklenen üç değer: "microsoft.classiccompute/domainnames/slots/roles" - Azure Cloud Services rolleri, "microsoft.compute/virtualmachinescalesets" - Azure Sanal Makine Ölçek Kümeleri ve "Microsoft.Web/serverfarms" - Azure İzleyici'nin Web Uygulaması özelliği.
resourceId	Yes	Ölçeklendirilmekte olan hedef kaynağın kimliğini Resource Manager.
portalLink	Yes	hedef kaynağın özet sayfasına bağlantı Azure portal.
oldCapacity	Yes	Otomatik ölçeklendirme işlemi yapıldığında geçerli (eski) örnek sayısı.
newCapacity	Yes	Otomatik ölçeklendirmenin kaynağı ölçeklendirdiği yeni örnek sayısı.
properties	No	İsteğe bağlı. Anahtar, Değer çiftleri <kümesi (örneğin, Sözlük <Dizesi, Dize>).> Özellikler alanı isteğe bağlıdır. Özel kullanıcı arabiriminde veya mantıksal uygulama tabanlı iş akışında, yükü kullanarak geçirilebilen anahtarları ve değerleri girebilirsiniz. Özel özellikleri giden web kancası çağrısına geri geçirmenin alternatif bir yolu, web kancası URI'sinin kendisini kullanmaktır (sorgu parametreleri olarak).