Microsoft Azure 拡張機能の概要

ま Microsoft Azure、Event Hubs は、接続されたデバイスやアプリケーションによって生成された膨大な量のデータを処理および分析できる、拡張性の高いリアルタイムデータ入力サービスです。 データがイベントハブに収集されると、任意のリアルタイム分析プロバイダーまたはバッチ/ストレージアダプターを使用して変換および保存できます。

Microsoft Azure ​ イベント転送 ​ 拡張機能は、Event Hubs を活用して、イベントをAdobe Experience Platform Edge Networkから Azure に送信して、さらに処理できるようにします。 このガイドでは、拡張機能をインストールし、イベント転送ルールでその機能を使用する方法について説明します。

前提条件

この拡張機能を使用するには、Azure へのアクセス権を持つ有効な Event Hubs アカウントが必要です。 また、次の手順に従う前に ​ ポータルを使用してイベントハブを作成する Azure 必要があり ​ す。

拡張機能のインストール

Microsoft Azure 拡張機能をインストールするには、データ収集 UI またはExperience Platform UI に移動し、左側のナビゲーションから「Event Forwarding」を選択します。 ここから、拡張機能を追加するプロパティを選択するか、代わりに新しいプロパティを作成します。

目的のプロパティを選択または作成したら、左側のナビゲーションで「Extensions」を選択し、「Catalog」タブを選択します。 Microsoft Azure カードを検索し、「Install」を選択します。

データ収集 UI の Install 拡張機能に対して選択されている「Microsoft Azure」ボタン

拡張機能には設定プロパティがないので、インストールされた拡張機能のリストにすぐに追加されます。 イベント転送ルールを設定する際に、Event Hub アクションタイプの使用を開始できるようになりました。

イベント転送ルールの設定 rule

新しいイベント転送ルールの作成を開始し、必要に応じてその条件を設定します。 ルールのアクションを選択する場合は、拡張機能で「Microsoft Azure」を選択してから、「アクションタイプ」で「Send Data to Event Hubs」を選択します。

データ収集 UI でルールに対して選択されている Send Data to Event Hubs アクションタイプ

右側のパネルが更新され、データの送信方法に関する設定オプションが表示されます。 特に、​ 設定を表す様々なプロパティに ​ データ要素 Event Hub を割り当てる必要があります。

UI に表示される Send Data to Event Hubs アクションタイプの設定オプション

Event Hub Details

入力
説明
Namespace
Event Hubs イベントハブの設定 ​ 時に作成した ​ 名前空間の名前。
Name
イベントハブの名前。
SAS Authorization Rule Name
Event Hubs 名前空間全体、またはデータの送信先の特定のイベントハブインスタンスの共有アクセス認証ルールの名前。 詳しくは、「SAS 認証値の取得 ​」に関する付録の節を参照してください。
SAS Access Key
Event Hubs 名前空間全体、またはデータの送信先の特定のイベントハブインスタンスの共有アクセス許可ルールのプライマリキー。 詳しくは、「SAS 認証値の取得 ​」に関する付録の節を参照してください。
Partition ID
Event Hubs を使用すると、​ イベントを特定のパーティションに直接送信 ​ できます。 この機能を利用するには、イベントを受け取るパーティションの ID を指定します。

データ

入力
説明
Payload
このフィールドには、Event Hubs に転送されるデータが含まれています。 データは、JSON オブジェクト、文字列、またはデータ要素です。

終了したら、「Keep Changes」を選択して、アクションをルール設定に追加します。 ルールの設定が完了したら、「Save to Library」を選択します。

最後に、新しいイベント転送 ​ ビルド ​ を公開して、ライブラリに対する変更を有効にします。

次の手順

このガイドでは、Event Hubs イベント転送拡張機能を使用して Microsoft Azure にデータを送信する方法について説明しました。 Experience Platformのイベント転送機能について詳しくは、​ イベント転送の概要 ​ を参照してください。

付録:SAS 認証値の取得 sas

外部アプリケーションには、Event Hubs 共有アクセス署名(SAS) ​ を通じて ​ へのアクセスが許可されます。 各 Event Hubs 名前空間およびイベントハブインスタンスには、作成時に自動的に割り当てられるデフォルトの SAS 承認規則がありますが、必要に応じて、各リソースに追加のポリシーを作成することもできます。

​ 拡張機能を使用して ​ イベント転送ルールの設定 Azure を行う場合、データの送信先の名前空間または特定のイベントハブを管理する認証ルールの名前とプライマリキーを指定する必要があります。 これらの値を Azure portal から取得する方法について詳しくは、Azure ドキュメントの次の節を参照してください。

必要な値が揃ったら、承認規則名を設定入力の文字列として直接指定するか、代わりに文字列型のデータ要素を作成して、それを参照できます。 ただし、プライマリキーは、データのセキュリティを保護するために、ルール設定で指定する前に、まずイベント転送の秘密鍵の内部に含める必要があります。

イベント転送 UI 内で ​ 新しいシークレットを作成 ​、シークレットタイプとして Token を選択します。 トークン値自体には、以前にコピーしたプライマリキーを指定します。 秘密鍵を作成したら、Secret タイプのデータ要素を作成し、リストから Event Hubs 秘密鍵を選択します。 秘密鍵データ要素を設定したら、「SAS Access Key」フィールドでそのデータ要素を参照できます。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743