Azure Event Grid イベントに対するイベントハンドラーとしてのイベントハブ

[アーティクル]
09/19/2023

イベントハンドラーは、イベントの送信先となる場所です。ハンドラーでは、イベントを処理するアクションが実行されます。一部の Azure サービスは、イベントを処理するように自動的に構成されます。Azure Event Hubs はその 1 つです。

Event Grid からのイベントが速すぎて、ソリューションで処理しきれない場合は、Event Hubs を使用します。イベントがイベントハブに格納されたら、アプリケーションでは独自のスケジュールでイベントハブからイベントを取得して処理できます。イベント処理をスケーリングして、受信イベントを処理することができます。

チュートリアル

次の例を参照してください。

タイトル	説明
クイックスタート: Azure CLI を使用してカスタムイベントを Azure Event Hubs にルーティングする	アプリケーションで処理するためにカスタムイベントをイベントハブに送信します。
Resource Manager テンプレート:Event Grid カスタムトピックを作成し、イベントハブにイベントを送信する	カスタムトピックのサブスクリプションを作成する Resource Manager テンプレート。 Azure Event Hubs にイベントを送信します。

メッセージヘッダー

これらは、メッセージヘッダーで受け取るプロパティです。

プロパティ名	説明
aeg-subscription-name	イベントサブスクリプションの名前。
aeg-delivery-count	イベントに対して行われた試行の回数。
aeg-event-type	イベントの種類。次のいずれかの値を指定できます。 SubscriptionValidation Notification 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`	静的または動的

詳細については、「カスタム配信のプロパティ」を参照してください。

次のステップ

サポートされているイベントハンドラーの一覧については、「イベントハンドラー」を参照してください。

Azure Event Grid イベントに対するイベント ハンドラーとしてのイベント ハブ

チュートリアル

メッセージ ヘッダー