Event Grid 이벤트에 대한 이벤트 처리기로서의 함수 사용

아티클
12/19/2024

이벤트 처리기는 이벤트가 전송된 위치입니다. 처리기는 이벤트를 처리하기 위한 작업을 수행합니다. 이벤트를 처리하도록 여러 Azure 서비스가 자동으로 구성되며, Azure Functions가 그 중 하나입니다. 예를 들어 Azure Event Grid는 Azure Functions를 손상 방지 계층으로 활용하여 이벤트를 다운스트림 시스템으로 전달하기 전에 이벤트를 변환하거나 유효성을 검사할 수 있습니다.

Azure에서 함수를 이벤트에 대한 처리기로 사용하려면 다음 방법 중 하나를 수행합니다.

Event Grid 트리거를 사용합니다. Azure Function을 엔드포인트 유형으로 지정합니다. 그런 다음, 함수 앱 및 이벤트를 처리할 함수를 지정합니다.
HTTP 트리거를 사용합니다. 웹후크를 엔드포인트 유형으로 지정합니다. 그런 다음, 이벤트를 처리할 함수에 대한 URL을 지정합니다.

첫 번째 접근 방식(Event Grid 트리거)은 두 번째 접근 방식에 비해 다음과 같은 이점이 있으므로 첫 번째 접근 방식을 사용하는 것이 좋습니다.

Event Grid는 Event Grid 트리거의 유효성을 자동으로 검사합니다. 일반 HTTP 트리거를 사용하면 유효성 검사 응답을 직접 구현해야 합니다.
Event Grid는 함수가 이벤트를 처리할 수 있는 인식률에 따라 Event Grid 이벤트에 의해 트리거되는 함수에 이벤트가 전달되는 속도를 자동으로 조정합니다. 이 속도 일치 기능은 함수의 이벤트 처리 속도가 시간에 따라 달라질 수 있으므로 함수가 이벤트를 처리할 수 없기 때문에 발생하는 전송 오류를 방지합니다. 높은 처리량으로 효율성을 향상시키려면 이벤트 구독에서 일괄 처리를 사용합니다. 자세한 내용은 일괄 처리 사용을 참조하세요.

참고 항목

Event Grid 트리거를 사용하여 Azure 함수를 사용하여 이벤트 구독을 추가하는 경우 Event Grid는 Event Grid 서비스 주체의 자격 증명을 사용하여 대상 함수에 대한 액세스 키를 가져옵니다. Azure 구독에 Event Grid 리소스 공급자를 등록하면 Event Grid에 권한이 부여됩니다.
Microsoft Entra ID 애플리케이션을 사용하여 Azure 함수를 보호하는 경우 HTTP 트리거를 사용하는 일반 웹후크 방식을 활용해야 합니다. 구독을 추가할 때 Azure 함수 엔드포인트를 웹후크 URL로 사용합니다.

자습서

제목	설명
빠른 시작: 함수를 사용하여 이벤트 처리	처리를 위한 함수로 사용자 지정 이벤트를 보냅니다.
자습서: 데이터 웨어하우스로 빅 데이터 스트림	Event Hubs가 캡처 파일을 만들 때 Event Grid는 함수 앱에 이벤트를 보냅니다. 앱은 캡처 파일을 검색하고 데이터를 데이터 웨어하우스에 마이그레이션합니다.
자습서: Azure Service Bus-Azure Event Grid 통합 예제	Event Grid는 Service Bus 토픽의 메시지를 함수 앱과 논리 앱에 전송합니다.

REST 예제(PUT의 경우)

{
	"properties": 
	{
		"destination": 
		{
			"endpointType": "AzureFunction",
			"properties": 
			{
				"resourceId": "/subscriptions/<AZURE SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP NAME>/providers/Microsoft.Web/sites/<FUNCTION APP NAME>/functions/<FUNCTION NAME>",
				"maxEventsPerBatch": 10,
				"preferredBatchSizeInKilobytes": 64
			}
		},
		"eventDeliverySchema": "EventGridSchema"
	}
}

일괄 처리 사용

높은 처리량을 위해 구독에서 일괄 처리를 사용합니다. Azure Portal을 사용하는 경우 구독을 만들 때 또는 만든 후에 일괄 처리별 최대 이벤트 수와 기본 일괄 처리 크기(KB)를 설정할 수 있습니다.

Azure Portal, PowerShell, CLI 또는 Resource Manager 템플릿을 사용하여 일괄 처리 설정을 구성할 수 있습니다.

Azure Portal

UI에 구독을 만들 때 이벤트 구독 만들기 페이지에서 고급 기능 탭으로 전환하고, 일괄 처리당 최대 이벤트 및 기본 설정된 일괄 처리(KB)에 대한 값을 설정합니다.

구독을 만들 때 일괄 처리 사용

Event Grid 토픽 페이지의 기능 탭에서 기존 구독에 대해 이러한 값을 업데이트할 수 있습니다.

만든 후에 일괄 처리 사용

Azure Resource Manager 템플릿

Azure Resource Manager 템플릿에서 maxEventsPerBatch 및 preferredBatchSizeInKilobytes를 설정할 수 있습니다. 자세한 내용은 Microsoft.EventGrid eventSubscriptions 템플릿 참조를 참조하세요.

Azure CLI

az eventgrid event-subscription create 명령을 사용하여 다음 매개 변수로 일괄 처리 관련 설정 구성: --max-events-per-batch 또는 --preferred-batch-size-in-kilobytes

Azure PowerShell

New-AzEventGridSubscription 또는 Update-AzEventGridSubscription cmdlet을 사용하여 -MaxEventsPerBatch 또는 -PreferredBatchSizeInKiloBytes 매개 변수를 사용하는 일괄 처리 관련 설정을 구성할 수 있습니다.

참고 항목

Event Grid 트리거를 사용하는 경우 Event Grid 서비스는 대상 Azure 함수에 대한 클라이언트 암호를 가져오고 이를 사용하여 Azure 함수에 이벤트를 전달합니다. Microsoft Entra 애플리케이션을 사용하여 Azure 함수를 보호하는 경우 일반 웹 후크 접근 방식을 사용하고 HTTP 트리거를 사용해야 합니다.

다음 단계

지원되는 이벤트 처리기 목록은 이벤트 처리기 문서를 참조하세요.

다음을 통해 공유