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

注意

Time Series Insights (TSI) サービスは、2025 年 3 月以降はサポートされなくなります。できるだけ早く既存の TSI 環境を代替ソリューションに移行することを検討してください。サポートの終了と移行の詳細については、こちらのドキュメントを参照してください。

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

注意

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

前提条件

Azure Time Series Insights 環境を作成する。
Microsoft Azure portal を使用して IoT Hub を作成する。
IoT Hub には、アクティブなメッセージイベントが送信される必要があります。
IoT Hub に Azure Time Series Insights 環境で使用する専用コンシューマーグループを作成します。各 Azure Time Series Insights イベントソースには、他のコンシューマーと共有されない専用のコンシューマーグループが設定されている必要があります。複数のリーダーが同じコンシューマーグループのイベントを消費すると、すべてのリーダーにエラーが発生する可能性があります。詳細については、「Azure IoT Hub 開発者ガイド」をご覧ください。

アプリケーションは、コンシューマーグループを使用して、Azure IoT Hub からデータをプルします。 IoT Hub からデータを確実に読み取るには、この Azure Time Series Insights 環境でのみ使用される専用のコンシューマーグループを指定します。

新しいコンシューマーグループを IoT Hub に追加するには:

Azure portal で、ご利用の IoT Hub を探して開きます。
[設定] で [組み込みのエンドポイント] を選択し、 [イベント] エンドポイントを選択します。
[コンシューマーグループ] にコンシューマーグループの一意の名前を入力します。 Azure Time Series Insights 環境で新しいイベントソースを作成する場合に、これと同じ名前を使用します。
[保存] を選択します。

Azure portal にサインインします。
左側のメニューで、 [すべてのリソース] を選びます。 Azure Time Series Insights 環境を選択します。
[設定] で、 [イベントソース] 、 [追加] の順に選択します。
[New event source] (新しいイベントソース) ウィンドウで、 [イベントソース名] にこの Azure Time Series Insights 環境の一意の名前を入力します。たとえば、「イベントストリーム」と入力します。
[ソース] には [IoT Hub] を選択します。

[インポートオプション] の値を選択します。

サブスクリプションのいずれかに IoT Hub が既にある場合は、 [Use IoT Hub from available subscriptions] (使用可能なサブスクリプションの Iot Hub を使用する) を選択します。このオプションが最も簡単な方法となります。

[Use IoT Hub from available subscriptions] (使用可能なサブスクリプションの Iot Hub を使用する) オプションに必要なプロパティについて次の表に説明します。

プロパティ	説明
サブスクリプション	目的の IoT Hub が属しているサブスクリプション。
IoT Hub 名	選択した IoT Hub の名前。
IoT Hub ポリシー名	共有アクセスポリシーを選択します。共有アクセスポリシーは [IoT Hub の設定] タブで見つかります。各共有アクセスポリシーには、名前、設定したアクセス許可、アクセスキーが含まれています。イベントソースの共有アクセスポリシーには、サービス接続アクセス許可が "必要" です。
IoT Hub ポリシーキー	キーが事前設定されています。

IoT Hub がサブスクリプションの外部であるか、または高度なオプションを選択する場合は、 [IoT Hub 設定を手動で行う] を選択します。

次の表に、IoT Hub 設定を手動で行うために必要なプロパティを示します。

プロパティ	説明
サブスクリプション ID	目的の IoT Hub が属しているサブスクリプション。
Resource group	この IoT Hub が作成されたリソースグループ名です。
IoT Hub 名	IoT Hub の名前です。 IoT Hub を作成したときに、IoT Hub の名前を入力しました。
IoT Hub ポリシー名	共有アクセスポリシー。共有アクセスポリシーは [IoT Hub の設定] タブで作成できます。各共有アクセスポリシーには、名前、設定したアクセス許可、アクセスキーが含まれています。イベントソースの共有アクセスポリシーには、サービス接続アクセス許可が "必要" です。
IoT Hub ポリシーキー	Azure Service Bus 名前空間へのアクセスを認証するために使用する共有アクセスキー。ここにプライマリキーまたはセカンダリキーを入力します。

どちらのオプションも以下の構成オプションを共有します。

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