다음을 통해 공유


Azure Event Grid 이벤트에 대한 이벤트 처리기로서의 이벤트 허브

이벤트 처리기는 이벤트가 전송된 위치입니다. 처리기는 이벤트를 처리하기 위한 작업을 수행합니다. 이벤트를 처리하도록 여러 Azure 서비스가 자동으로 구성되며, Azure Event Hubs가 그 중 하나입니다.

솔루션이 이벤트를 처리할 수 있는 속도보다 빠르게 Event Grid에서 이벤트를 가져오는 경우 Event Hubs를 사용하세요. 이벤트가 이벤트 허브에 있으면 애플리케이션은 자체 일정에 따라 이벤트 허브에서 이벤트를 처리할 수 있습니다. 들어오는 이벤트를 처리하도록 이벤트 처리 규모를 확장할 수 있습니다.

자습서

다음 예제를 참조하세요.

제목 설명
빠른 시작: Azure CLI를 사용하여 Azure Event Hubs로 사용자 지정 이벤트 라우팅 애플리케이션에서 처리하도록 사용자 지정 이벤트를 이벤트 허브로 보냅니다.
Resource Manager 템플릿: Event Grid 사용자 지정 항목 만들기 및 이벤트 허브로 이벤트 보내기 사용자 지정 토픽에 대한 구독을 만드는 Resource Manager 템플릿입니다. Azure Event Hubs에 이벤트를 전송합니다.

메시지 헤더

다음은 메시지 헤더에서 수신되는 속성입니다.

Property name 설명
aeg-subscription-name 이벤트 구독의 이름입니다.
aeg-delivery-count 이벤트를 시도한 횟수입니다.
aeg-event-type

이벤트의 유형입니다.

다음 값 중 하나일 수 있습니다.

  • SubscriptionValidation
  • 알림
  • SubscriptionDeletion
aeg-metadata-version

이벤트의 메타데이터 버전입니다.

Event Grid 이벤트 스키마의 경우 이 속성은 메타데이터 버전을 나타내고 클라우드 이벤트 스키마의 경우 사양 버전을 나타냅니다.

aeg-data-version

이벤트의 데이터 버전입니다.

Event Grid 이벤트 스키마의 경우 이 속성은 데이터 버전을 나타내고 클라우드 이벤트 스키마에 대해서는 적용되지 않습니다.

aeg-output-event-id Event Grid 이벤트의 ID입니다.

REST 예제(PUT의 경우)

이벤트 허브

{
  "properties": 
  {
    "destination": 
    {
      "endpointType": "EventHub",
      "properties": 
      {
        "resourceId": "/subscriptions/<AZURE SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP NAME>/providers/Microsoft.EventHub/namespaces/<EVENT HUBS NAMESPACE NAME>/eventhubs/<EVENT HUB NAME>"
      }
    },
    "eventDeliverySchema": "EventGridSchema"
  }
}

이벤트 허브 - 관리 ID로 전달

{
  "properties": {
    "deliveryWithResourceIdentity": 
    {
      "identity": 
      {
        "type": "SystemAssigned"
      },
      "destination": 
      {
        "endpointType": "EventHub",
        "properties": 
        {
          "resourceId": "/subscriptions/<AZURE SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP NAME>/providers/Microsoft.EventHub/namespaces/<EVENT HUBS NAMESPACE NAME>/eventhubs/<EVENT HUB NAME>"
        }
      }
    },
    "eventDeliverySchema": "EventGridSchema"
  }
}

배달 속성

이벤트 구독을 사용하면 배달된 이벤트에 포함 되는 HTTP 헤더를 설정할 수 있습니다. 이 기능을 사용하면 대상에 필요한 사용자 지정 헤더를 설정할 수 있습니다. Azure Event Hubs로 배달되는 이벤트에 사용자 지정 헤더를 설정할 수 있습니다.

이벤트 허브 내 특정 파티션에 이벤트를 게시해야 하는 경우 이벤트 구독에서 PartitionKey 속성을 정의하여 대상 이벤트 허브 파티션을 식별하는 파티션 키를 지정합니다.

헤더 이름 헤더 형식
PartitionKey 정적 또는 동적

자세한 내용은 사용자 지정 배달 속성을 참조하세요.

다음 단계

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