Azure Time Series Insights 環境にイベント ハブ イベント ソースを追加する

手記

Time Series Insights サービスは、2024 年 7 月 7 日に廃止されます。 既存の環境をできるだけ早く別のソリューションに移行することを検討してください。 非推奨と移行の詳細については、ドキュメントを参照してください。

この記事では、Azure portal を使用して、Azure Event Hubs からデータを読み取るイベント ソースを Azure Time Series Insights 環境に追加する方法について説明します。

手記

この記事で説明する手順は、Azure Time Series Insights Gen 1 環境と Azure Time Series Insights Gen 2 環境の両方に適用されます。

前提 条件

• Azure Time Series Insights 環境は、Azure Time Series Insights 環境の作成に記載されているように作成してください。
• イベント ハブを作成します。 Azure portalを使用して Event Hubs 名前空間とイベント ハブを作成する方法に関するページを参照してください。
• イベント ハブには、アクティブなメッセージ イベントが送信されている必要があります。 .NET Frameworkを使用して Azure Event Hubs にイベントを送信 方法について説明します。
• Azure Time Series Insights 環境で使用できる専用のコンシューマー グループをイベント ハブに作成します。 各 Azure Time Series Insights イベント ソースには、他のコンシューマーと共有されていない専用のコンシューマー グループが必要です。 複数のリーダーが同じコンシューマー グループのイベントを使用する場合、すべてのリーダーでエラーが発生する可能性があります。 イベント ハブごとに 20 個のコンシューマー グループに制限があります。 詳細については、Event Hubs プログラミング ガイドを参照してください。

コンシューマー グループをイベント ハブに追加する

アプリケーションでは、コンシューマー グループを使用して Azure Event Hubs からデータをプルします。 イベント ハブからデータを確実に読み取るには、この Azure Time Series Insights 環境でのみ使用される専用のコンシューマー グループを提供します。

イベント ハブに新しいコンシューマー グループを追加するには:

1. Azure portalで、イベント ハブ名前空間の [の概要] ウィンドウからイベント ハブ インスタンスを見つけて開きます。 Event Hubs エンティティ 選択するか、名前でインスタンスを見つけます。

   を開く

2. イベント ハブ インスタンスで、エンティティ > コンシューマー グループを選択します。 次に、+ コンシューマー グループ を選択して、新しいコンシューマー グループを追加します。

   を追加する

   それ以外の場合は、既存のコンシューマー グループを選択し、次のセクションに進みます。

3. [コンシューマー グループ] ページで、[名前] に一意の新しい値 を入力します。 Azure Time Series Insights 環境で新しいイベント ソースを作成するときは、この同じ名前を使用します。

4. [作成] を選択します。

新しいイベント ソースを追加する

1. Azure portalにサインインします。

2. 既存の Azure Time Series Insights 環境を見つけます。 左側のメニューで、[すべてのリソース ] を選択し、Azure Time Series Insights 環境を選択します。

3. イベント ソースを選択してから、追加を選択します。

   

4. Contoso-TSI-Gen 1-Event-Hub-ESなど、この Azure Time Series Insights 環境に固有 イベント ソース名 の値を入力します。

5. ソースで、Event Hubを選択します。

6. インポートオプション に適切な値を選択します。

   • いずれかのサブスクリプションに既存のイベント ハブがある場合は、[使用可能なサブスクリプションからイベント ハブを使用 を選択します。 このオプションが最も簡単な方法です。

     

   • 次の表では、使用可能なサブスクリプションから Event Hub を使用する オプションに必要なプロパティについて説明します。

     

     財産	説明
     予約	目的のイベント ハブ インスタンスと名前空間が属するサブスクリプション。
     Event Hub 名前空間	目的のイベント ハブ インスタンスが属しているイベント ハブ名前空間。
     イベント ハブ名	目的のイベント ハブ インスタンスの名前。
     イベント ハブ ポリシーの値	目的の共有アクセス ポリシーを選択します。 [ の構成] タブ イベント ハブで共有アクセス ポリシーを作成できます。各共有アクセス ポリシーには、名前、設定したアクセス許可、およびアクセス キーがあります。 イベント ソース の共有アクセス ポリシーには、読み取り アクセス許可 必要があります。
     Event Hub ポリシー キー	選択したイベント ハブ ポリシー値から事前に設定されます。

   • イベント ハブがサブスクリプションの外部にある場合、または詳細オプションを選択する場合は、[イベント ハブの設定を手動で指定する] を選択します。

     次の表では、[イベント ハブの設定を手動で指定する] オプション 必要なプロパティについて説明します。

     財産	説明
     サブスクリプション ID	目的のイベント ハブ インスタンスと名前空間が属するサブスクリプション。
     リソース グループ	目的のイベント ハブ インスタンスと名前空間が属するリソース グループ。
     Event Hub 名前空間	目的のイベント ハブ インスタンスが属しているイベント ハブ名前空間。
     イベント ハブ名	目的のイベント ハブ インスタンスの名前。
     イベント ハブ ポリシーの値	目的の共有アクセス ポリシーを選択します。 [ の構成] タブ イベント ハブで共有アクセス ポリシーを作成できます。各共有アクセス ポリシーには、名前、設定したアクセス許可、およびアクセス キーがあります。 イベント ソース の共有アクセス ポリシーには、 読み取りアクセス許可 が 必要です。
     Event Hub ポリシー キー	Service Bus 名前空間へのアクセスを認証するために使用される共有アクセス キー。 ここに主キーまたはセカンダリ キーを入力します。

   • どちらのオプションも、次の構成オプションを共有します。

     財産	説明
     Event Hub コンシューマー グループ	イベント ハブからイベントを読み取るコンシューマー グループ。 イベント ソースには専用のコンシューマー グループを使用することを強くお勧めします。
     イベントのシリアル化形式	現時点では、使用可能なシリアル化形式は JSON のみです。 イベント メッセージは、この形式である必要があります。または、データを読み取ることはできません。
     タイムスタンププロパティ名	この値を決定するには、イベント ハブに送信されるメッセージ データのメッセージ形式を理解する必要があります。 この値は、イベント タイムスタンプとして使用するメッセージ データ内の特定のイベント プロパティの 名 です。 値では大文字と小文字が区別されます。 空白のままにすると、イベント ソースの イベント エンキュー時間 がイベント タイムスタンプとして使用されます。

7. イベント ハブに追加した専用の Azure Time Series Insights コンシューマー グループ名を追加します。

8. [作成] を選択します。

   イベント ソースが作成されると、Azure Time Series Insights によって環境へのデータのストリーミングが自動的に開始されます。

次の手順

• データをセキュリティで保護するために データ アクセス ポリシーを定義します。

• イベント をイベント ソースに送信します。