Azure Event hubs sebagai tujuan handler dalam langganan topik namespace Azure Event Grid

Artikel
05/21/2024

Penanganan aktivitas adalah tempat peristiwa dikirim. Penanganan mengambil tindakan untuk memproses peristiwa. Berikut adalah daftar penanganan aktivitas yang didukung untuk topik namespace layanan:

Gunakan Azure Event Hubs saat solusi Anda mendapatkan peristiwa dari Event Grid lebih cepat daripada yang dapat memproses peristiwa. Setelah kejadian berada di event hub, aplikasi Anda dapat memproses kejadian dari pusat kejadian dengan jadwalnya sendiri. Anda dapat menskalakan pemrosesan peristiwa untuk menangani peristiwa masuk.

Header pesan

Berikut adalah properti yang Anda terima di header peristiwa atau pesan yang dikirim ke Azure Event Hubs:

Nama properti	Deskripsi
`aeg-subscription-name`	Nama langganan kejadian.
`aeg-delivery-count`	Jumlah upaya yang dilakukan untuk kejadian.
`aeg-output-event-id`	ID peristiwa yang dihasilkan sistem.
`aeg-compatibility-mode-enabled`	Properti ini hanya tersedia dan diatur saat mengirimkan melalui namespace Layanan Event Grid. Saat ini satu-satunya nilai yang mungkin adalah false. Ini dimaksudkan untuk membantu penanganan aktivitas membedakan antara peristiwa yang dikirimkan melalui namespace Layanan Event Grid vs topik kustom Event Grid/topik sistem/namespace mitra dll.
`aeg-metadata-version`	Versi metadata kejadian. Mewakili versi spesifikasi untuk skema peristiwa cloud.

Contoh REST

Langganan peristiwa dengan Azure Event Hubs sebagai penanganan aktivitas menggunakan identitas yang ditetapkan sistem

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "SystemAssigned"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        }
      }
    }
  }
}

Langganan peristiwa dengan Azure Event Hubs sebagai penanganan aktivitas menggunakan identitas yang ditetapkan pengguna

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        }
      }
    }
  }
}

Langganan peristiwa dengan tujuan deadletter yang dikonfigurasi pada penanganan aktivitas Azure Event Hubs

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        },
        "deadLetterDestinationWithResourceIdentity": {
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "deadLetterDestination": {
            "endpointType": "StorageBlob",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.Storage/storageAccounts/{storage-account-name}",
              "blobContainerName": "{blob-container-name}"
            }
          }
        }
      }
    }
  }
}

Langganan peristiwa dengan properti pengiriman yang dikonfigurasi pada penanganan aktivitas Azure Event Hubs

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "SystemAssigned"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}",
              "deliveryAttributeMappings": [
                {
                  "name": "somestaticname",
                  "type": "Static",
                  "properties": {
                    "value": "somestaticvalue"
                  }
                },
                {
                  "name": "somedynamicname",
                  "type": "Dynamic",
                  "properties": {
                    "sourceField": "subject"
                  }
                }
              ]
            }
          }
        }
      }
    }
  }
}

Properti pengiriman khusus Azure Event Hubs

Langganan kejadian memungkinkan Anda menyiapkan header HTTP yang disertakan dalam kejadian terkikis. Kemampuan ini memungkinkan Anda mengatur header kustom yang diperlukan tujuan. Anda dapat mengatur header kustom pada peristiwa yang dikirimkan ke Azure Event Hubs.

Jika Anda perlu menerbitkan peristiwa ke partisi tertentu dalam hub peristiwa, atur properti PartitionKey pada langganan peristiwa Anda untuk menentukan kunci partisi yang mengidentifikasi partisi hub peristiwa target.

Nama header	Jenis header
`PartitionKey`	Statis atau dinamis

Untuk informasi selengkapnya, lihat Properti pengiriman kustom pada namespace layanan.

Portal Azure

Saat membuat langganan peristiwa dengan mode pengiriman peristiwa diatur ke Push, Anda dapat memilih Azure Event Hubs sebagai jenis penanganan aktivitas dan mengonfigurasi pusat aktivitas sebagai handler.

Untuk instruksi langkah demi langkah, lihat Menggunakan Azure Event Hubs tujuan untuk topik namespace.

Azure CLI

Untuk instruksi langkah demi langkah, lihat Mengonfigurasi Event Hubs tujuan.

Langkah berikutnya

Pengiriman push namespace Layanan Event Grid.

Bagikan melalui