크기 자동 조정 작업을 사용하여 Azure Monitor에서 전자 메일 및 webhook 경고 알림 보내기

아티클
11/01/2024

이 문서에서는 Azure에서 자동 스케일링 작업을 기준으로 특정 웹 URL을 호출하거나 메일을 보낼 수 있도록 알림을 설정하는 방법을 설명합니다.

웹후크

웹후크를 사용하면 특정 이벤트 또는 트리거가 발생할 때 특정 URL 엔드포인트(콜백 URL)에 HTTP 요청을 보낼 수 있습니다. 웹후크를 사용하면 여러 시스템 또는 애플리케이션 간에 정보 자동 교환을 사용하도록 설정하여 프로세스를 자동화하고 간소화할 수 있습니다. 웹후크를 사용하여 자동 스케일링 이벤트가 발생할 때 실행할 사용자 지정 코드, 알림 또는 기타 작업을 트리거합니다.

전자 메일

자동 스케일링 이벤트가 발생할 때 유효한 메일 주소로 메일을 보낼 수 있습니다.

참고 항목

2024년 4월 3일부터 Azure 자동 크기 조정 알림에 대한 새로운 공동 관리자를 추가할 수 없습니다. Azure 클래식 관리자는 2024년 8월 31일에 사용 중지하며, 2024년 8월 31일 이후에는 관리자 및 공동 관리자를 사용하여 Azure 자동 크기 조정 알림을 보낼 수 없습니다. 자세한 내용은 공동 관리자 사용 중지 대비를 참조하세요.

알림 구성

Azure Portal, CLI, PowerShell 또는 Resource Manager 템플릿을 사용하여 알림을 구성합니다.

Azure Portal을 사용하여 알림을 설정합니다.

자동 스케일링 설정 페이지에서 알림 탭을 선택하여 알림을 구성합니다.

알림을 보낼 이메일 주소 목록을 입력합니다.

웹 서비스에 알림을 보낼 웹후크 URI를 입력합니다. 웹후크 요청에 사용자 지정 헤더를 추가할 수도 있습니다. 예를 들어 헤더에 인증 토큰을 추가하거나, 쿼리 매개 변수를 추가하거나, 사용자 지정 헤더를 추가하여 요청의 원본을 식별할 수 있습니다.

CLI를 사용하여 알림을 구성합니다.

Azure CLI에서 az monitor autoscale update 또는 az monitor autoscale create 명령을 사용하여 알림을 구성합니다.

다음 매개 변수는 알림을 구성하는 데 사용됩니다.

--add-action - 자동 스케일링 규칙이 트리거될 때 수행할 작업입니다. 이 값은 email 또는 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을 사용하여 알림을 구성합니다.

다음 예제에서는 웹후크 및 메일 알림을 구성하는 방법을 보여 줍니다.

웹후크 개체를 만듭니다.
알림 개체를 만듭니다.
New-AzAutoscaleSetting 또는 Update-AzAutoscaleSetting cmdlet을 사용하여 자동 스케일링 설정에 알림 개체를 추가합니다.

# 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 API를 사용하는 경우 자동 스케일링 설정에 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`	예	값에 null [] 또는 메일 문자열 배열일 수 있습니다.
`webhooks`	예	값은 null이거나 올바른 URI일 수 있습니다.
`serviceUri`	예	유효한 HTTPS URI입니다.
`properties`	예	값은 비어 있는 {}이거나 키-값 쌍을 포함할 수 있습니다.

Webhook의 인증

webhook는 토큰 ID를 쿼리 매개 변수로 사용해서 webhook URI를 저장하는 토큰 기반 인증을 통해 인증할 수 있습니다. 예: https://mysamplealert/webcallback?tokenid=123-abc456-7890&myparameter2=value123.

크기 자동 조정 알림 Webhook 페이로드 스키마

크기 자동 조정 알림이 생성될 때는 다음 메타데이터가 Webhook 페이로드에 포함됩니다.

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

필드	필수	설명
status	예	자동 스케일링 작업이 생성되었음을 나타내는 상태입니다.
operation	예	인스턴스 증가의 경우 "스케일 아웃"입니다. 인스턴스 감소의 경우 "스케일 인"입니다.
context	예	자동 스케일링 작업 컨텍스트입니다.
timestamp	예	자동 스케일링 작업이 트리거된 타임스탬프입니다.
id	예	자동 스케일링 설정의 Resource Manager ID입니다.
name	예	자동 스케일링 설정의 이름입니다.
details	예	자동 스케일링 서비스가 수행한 작업에 대한 설명과 인스턴스 수의 변경입니다.
subscriptionId	예	스케일링 중인 대상 리소스의 구독 ID입니다.
resourceGroupName	예	스케일링 중인 대상 리소스의 리소스 그룹 이름입니다.
resourceName에 대한 추천 사항을 찾았음	예	스케일링할 대상 리소스의 이름입니다.
resourceType	예	다음의 세 값이 지원됩니다. "microsoft.classiccompute/domainnames/slots/roles" - Azure Cloud Services 역할, "microsoft.compute/virtualmachinescalesets" - Azure Virtual Machine Scale Sets, "Microsoft.Web/serverfarms" - Azure Monitor의 웹앱 기능
resourceId	예	스케일링 중인 대상 리소스의 Resource Manager ID입니다.
portalLink	예	대상 리소스의 요약 페이지에 대한 Azure Portal 링크입니다.
oldCapacity	예	자동 스케일링이 스케일링 작업을 수행한 경우의 현재(이전) 인스턴스 수입니다.
newCapacity	예	자동 스케일링 기능으로 리소스를 스케일링한 새 인스턴스 수입니다.
속성	아니요	선택 사항. <키, 값> 쌍집합(예: Dictionary <문자열, 문자열>). 속성 필드는 선택 사항입니다. 사용자 지정 사용자 인터페이스 또는 논리 앱 기반 워크플로에서는 페이로드를 사용하여 전달할 수 있는 키와 값을 입력할 수 있습니다. Webhook URI 자체를 쿼리 매개 변수로 사용하여 발신 Webhook 호출로 사용자 지정 속성을 다시 전달할 수도 있습니다.

다음을 통해 공유