Microsoft Azure 拡張機能の概要

NOTE
Adobe Experience Platform Launch は、Adobe Experience Platform のデータ収集テクノロジースイートとしてリブランドされています。 その結果、製品ドキュメント全体でいくつかの用語が変更されました。用語の変更点の一覧については、次のドキュメントを参照してください。

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

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

前提条件

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

拡張機能のインストール

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

目的のプロパティを選択または作成したら、左側のナビゲーションで 拡張機能 を選択し、「カタログ」タブを選択します。 Microsoft Azure カードを検索し、「インストール」を選択します。

データ収集 UI で Microsoft Azure 拡張機能に対して選択されている「 インストール 」ボタン。

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

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

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

データ収集 UI のルールに対して選択されている Event Hubs にデータを送信 アクションタイプ

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

UI に表示される Event Hubs にデータを送信 アクションタイプの設定オプション

イベントハブの詳細

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

データ

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

完了したら、「変更を保持」を選択して、アクションをルール設定に追加します。 ルールの設定が完了したら、「ライブラリに保存」を選択します。

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

次の手順

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

付録:SAS 認証値の取得 sas

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

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

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

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

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