チュートリアル:Time Series Insights を使用して Azure Digital Twins 空間からのイベントを視覚化および分析するTutorial: Visualize and analyze events from your Azure Digital Twins spaces by using Time Series Insights

Azure Digital Twins インスタンスをデプロイし、空間をプロビジョニングして、特定の条件を監視するカスタム関数を実装した後は、傾向や異常を見つけるために空間から受け取ったイベントやデータを視覚化することができます。After you deploy your Azure Digital Twins instance, provision your spaces, and implement a custom function to monitor specific conditions, you can visualize the events and data coming from your spaces to look for trends and anomalies.

最初のチュートリアルでは、モーション、二酸化炭素、温度のセンサーを備えた部屋がある架空の建物の空間グラフを構成しました。In the first tutorial, you configured the spatial graph of an imaginary building, with a room that contains sensors for motion, carbon dioxide, and temperature. 2 番目のチュートリアルでは、グラフとユーザー定義関数をプロビジョニングしました。In the second tutorial, you provisioned your graph and a user-defined function. 関数によってこれらのセンサーの値が監視され、適切な条件になると通知がトリガーされます。The function monitors these sensor values and triggers notifications for the right conditions. その条件とは、部屋が空室で、温度と二酸化炭素のレベルが正常であるという条件です。That is, the room is empty, and the temperature and carbon dioxide levels are normal.

このチュートリアルでは、Azure Digital Twins 設定からの通知とデータを Azure Time Series Insights と統合する方法について説明します。This tutorial shows you how you can integrate the notifications and data coming from your Azure Digital Twins setup with Azure Time Series Insights. その後、時間の経過に伴うセンサーの値を視覚化することができます。You can then visualize your sensor values over time. 最も利用されている部屋や 1 日のうちで最も忙しい時間帯などの傾向を調べることができます。You can look for trends such as which room is getting the most use and which are the busiest times of the day. さらに、どの部屋で風通しの悪さや暑さをより強く感じるかや、建物内のあるエリアが、空調設備の異常を示す高い温度値を常に送信しているかどうか、などの異常を検出することもできます。You can also detect anomalies such as which rooms feel stuffier and hotter, or whether an area in your building is sending consistently high temperature values, indicating faulty air conditioning.

このチュートリアルでは、以下の内容を学習します。In this tutorial, you learn how to:

  • Azure Event Hubs を使用したデータのストリーム配信Stream data by using Azure Event Hubs.
  • Time Series Insights を使用した分析Analyze with Time Series Insights.

前提条件Prerequisites

このチュートリアルでは、お客様が Azure Digital Twins の設定の構成プロビジョニングを完了していることを前提としています。This tutorial assumes that you have configured and provisioned your Azure Digital Twins setup. 次に進む前に、以下が準備されていることを確認します。Before proceeding, make sure that you have:

Event Hubs を使用したデータのストリーム配信Stream data by using Event Hubs

Event Hubs サービスを使用すると、データをストリーム配信するパイプラインを作成できます。You can use the Event Hubs service to create a pipeline to stream your data. このセクションでは、Azure Digital Twins インスタンスと Time Series Insights インスタンスの間のコネクタとしてイベント ハブを作成する方法について説明します。This section shows you how to create your event hub as the connector between your Azure Digital Twins and Time Series Insights instances.

イベント ハブの作成Create an event hub

  1. Azure Portal にサインインします。Sign in to the Azure portal.

  2. 左側のウィンドウで、 [リソースの作成] を選びます。In the left pane, select Create a resource.

  3. [Event Hubs] を見つけて選択します。Search for and select Event Hubs. 作成 を選択します。Select Create.

  4. Event Hubs 名前空間の名前を入力します。Enter a Name for your Event Hubs namespace. Standard 価格レベルサブスクリプション、Digital Twins インスタンスに使用したリソース グループ場所を選択します。Choose Standard for Pricing tier, your Subscription, the Resource group that you used for your Digital Twins instance, and the Location. 作成 を選択します。Select Create.

  5. Event Hubs 名前空間のデプロイで、 [概要] ウィンドウを選択し、 [リソースに移動] を選択します。In the Event Hubs namespace deployment, select the Overview pane, then select Go to resource.

    デプロイ後の Event Hubs 名前空間

  6. Event Hubs 名前空間の [概要] ウィンドウで、最上部にある [イベント ハブ] を選択します。In the Event Hubs namespace Overview pane, select the Event Hub button at the top. [イベント ハブ] ボタンEvent Hub button

  7. イベント ハブの名前を入力し、 [作成] を選択します。Enter a Name for your event hub, and select Create.

    イベント ハブは、デプロイ後、Event Hubs 名前空間の [Event Hubs] ウィンドウに [アクティブ] 状態として表示されます。After the event hub is deployed, it appears in the Event Hubs pane of the Event Hubs namespace with an Active status. このイベント ハブを選択して、 [概要] ウィンドウを開きます。Select this event hub to open its Overview pane.

  8. 最上部にある [コンシューマー グループ] をクリックし、コンシューマー グループの名前 (たとえば、tsievents) を選択します。Select the Consumer group button at the top, and enter a name such as tsievents for the consumer group. 作成 を選択します。Select Create.

    イベント ハブ コンシューマー グループ

    作成されたコンシューマー グループが、イベント ハブの [概要] ウィンドウの下部にある一覧に表示されます。After the consumer group is created, it appears in the list at the bottom of the event hub's Overview pane.

  9. イベント ハブの [共有アクセス ポリシー] ウィンドウを開き、 [追加] ボタンを選択します。Open the Shared access policies pane for your event hub, and select the Add button. ポリシーの名前として「ManageSend」を入力し、すべてのチェック ボックスがオンになっていることを確認して、 [作成] を選択します。Enter ManageSend as the policy name, make sure all the check boxes are selected, and select Create.

    イベント ハブの接続文字列

  10. 作成した ManageSend ポリシーを開き、 [接続文字列 - 主キー][接続文字列 - セカンダリ キー] の値を一時ファイルにコピーします。Open the ManageSend policy that you created, and copy the values for Connection string--primary key and Connection string--secondary key to a temporary file. これらの値は、次のセクションでイベント ハブのエンドポイントを作成するために必要です。You'll need these values to create an endpoint for the event hub in the next section.

イベント ハブのエンドポイントの作成Create an endpoint for the event hub

  1. コマンド ウィンドウで、Azure Digital Twins サンプルの occupancy-quickstart\src フォルダーに移動していることを確認します。In the command window, make sure you're in the occupancy-quickstart\src folder of the Azure Digital Twins sample.

  2. エディターで actions\createEndpoints.yaml ファイルを開きます。Open the file actions\createEndpoints.yaml in your editor. 内容を次のものに置き換えます。Replace the contents with the following:

    - type: EventHub
      eventTypes:
      - SensorChange
      - SpaceChange
      - TopologyOperation
      - UdfCustom
      connectionString: Primary_connection_string_for_your_event_hub
      secondaryConnectionString: Secondary_connection_string_for_your_event_hub
      path: Name_of_your_Event_Hub
    - type: EventHub
      eventTypes:
      - DeviceMessage
      connectionString: Primary_connection_string_for_your_event_hub
      secondaryConnectionString: Secondary_connection_string_for_your_event_hub
      path: Name_of_your_Event_Hub
    
  3. プレースホルダー Primary_connection_string_for_your_event_hub を、イベント ハブの [接続文字列 - 主キー] の値に置き換えます。Replace the placeholders Primary_connection_string_for_your_event_hub with the value of Connection string--primary key for the event hub. この接続文字列が次の形式になっていることを確認します。Make sure the format of this connection string is as follows:

    Endpoint=sb://nameOfYourEventHubNamespace.servicebus.windows.net/;SharedAccessKeyName=ManageSend;SharedAccessKey=yourShareAccessKey1GUID;EntityPath=nameOfYourEventHub
    
  4. プレースホルダー Secondary_connection_string_for_your_event_hub を、イベント ハブの [接続文字列 - セカンダリ キー] の値に置き換えます。Replace the placeholders Secondary_connection_string_for_your_event_hub with the value of Connection string--secondary key for the event hub. この接続文字列が次の形式になっていることを確認します。Make sure the format of this connection string is as follows:

    Endpoint=sb://nameOfYourEventHubNamespace.servicebus.windows.net/;SharedAccessKeyName=ManageSend;SharedAccessKey=yourShareAccessKey2GUID;EntityPath=nameOfYourEventHub
    
  5. プレースホルダー Name_of_your_Event_Hub をイベント ハブの名前に置き換えます。Replace the placeholders Name_of_your_Event_Hub with the name of your Event Hub.

    重要

    引用符なしですべての値を入力します。Enter all values without any quotes. YAML ファイル内のコロンの後に少なくとも 1 つの空白文字があることを確認してください。Make sure there's at least one space character after the colons in the YAML file. YAML ファイルの内容は、このツールのようなオンライン YAML 検証ツールを使用して検証することもできます。You can also validate your YAML file contents by using any online YAML validator, such as this tool.

  6. ファイルを保存して閉じます。Save and close the file. コマンド ウィンドウで次のコマンドを実行し、メッセージが表示されたら Azure アカウントを使用してサインインします。Run the following command in the command window, and sign in with your Azure account when prompted.

    dotnet run CreateEndpoints
    

    イベント ハブに対して 2 つのエンドポイントが作成されます。It creates two endpoints for your event hub.

    Event Hubs のエンドポイント

Time Series Insights を使用した分析Analyze with Time Series Insights

  1. Azure portal の左側のウィンドウで、 [リソースの作成] を選択します。In the left pane of the Azure portal, select Create a resource.

  2. 新しい Time Series Insights リソースを見つけて選択します。Search for and select a new Time Series Insights resource. 作成 を選択します。Select Create.

  3. Time Series Insights インスタンスの名前を入力し、サブスクリプションを選択します。Enter a Name for your Time Series Insights instance, and then select your Subscription. Digital Twins インスタンスに対して使用したリソース グループ場所を選択します。Select the Resource group that you used for your Digital Twins instance, and your Location. [次へ:イベント ソース] ボタンまたは [イベント ソース] タブを選択します。Select Next: Event Source button or the Event Source tab.

    Time Series Insights インスタンスを作成するための選択内容

  4. [イベント ソース] タブで、 [名前] を入力し、 [ソースの種類] として [イベントハブ] を選択し、他の値が適切に選択されていることを確認します。In the Event Source tab, enter a Name, select Event Hub as the Source type, and make sure the other values are selected correctly. [イベント ハブ アクセス ポリシー名] には、ManageSend を選択します。さらに、 [イベント ハブ コンシューマー グループ] には、前のセクションで作成したコンシューマー グループを選択します。Select ManageSend for Event Hub access policy name, and then select the consumer group that you created in the previous section for Event Hub consumer group. [Review + create](レビュー + 作成) を選択します。Select Review + create.

    イベント ソースを作成するための選択内容

  5. [確認と作成] ウィンドウで、入力した情報を確認し、 [作成] を選択します。In the Review + Create pane, review the information you entered, and select Create.

  6. デプロイ ウィンドウで、先ほど作成した Time Series Insights リソースを選択します。In the deployment pane, select the Time Series Insights resource you just created. Time Series Insights 環境の [概要] ウィンドウが開きます。It opens the Overview pane for your Time Series Insights environment.

  7. 上部にある [環境を開く] ボタンを選択します。Select the Go to Environment button at the top. "データ アクセスの警告" が表示された場合は、Time Series Insights インスタンスの [データ アクセス ポリシー] ウィンドウを開きます。 [追加] を選択し、ロールとして [共同作成者] を選択して、適切なユーザーを選択します。If you get a data access warning, open the Data Access Policies pane for your Time Series Insights instance, select Add, select Contributor as the role, and select the appropriate user.

  8. [環境を開く] をクリックすると、Time Series Insights エクスプローラーが開きます。The Go to Environment button opens the Time Series Insights explorer. イベントが表示されない場合は、Digital Twins サンプルの device-connectivity プロジェクトに移動し、dotnet run を実行して、デバイス イベントをシミュレートします。If it doesn't show any events, simulate device events by browsing to the device-connectivity project of your Digital Twins sample, and running dotnet run.

  9. いくつかのシミュレートされたイベントが生成されたら、Time Series Insights エクスプローラーに戻り、最上部にある更新ボタンを選択します。After a few simulated events are generated, go back to the Time Series Insights explorer, and select the refresh button at the top. シミュレートされたセンサー データの分析グラフが作成されるのがわかります。You should see analytical charts being created for your simulated sensor data.

    Time Series Insights エクスプローラーのグラフ

  10. 次に、Time Series Insights エクスプローラーを使用して、部屋、センサー、その他のリソースからのさまざまなイベントやデータについてグラフやヒートマップを生成できます。In the Time Series Insights explorer, you can then generate charts and heatmaps for different events and data from your rooms, sensors, and other resources. 独自の視覚化を作成するには、左側の [メジャー][SPLIT BY](分割基準) ドロップダウン ボックスを使用します。On the left side, use the MEASURE and SPLIT BY drop-down boxes to create your own visualizations.

    たとえば、 [メジャー][イベント] を選択し、 [SPLIT BY](分割基準)[DigitalTwins-SensorHardwareId] を選択して、各センサーのヒートマップを生成します。For example, select Events for MEASURE and DigitalTwins-SensorHardwareId for SPLIT BY, to generate a heatmap for each of your sensors. 次の画像のようなヒートマップが得られます。The heatmap will be similar to the following image:

    Time Series Insights エクスプローラーのヒートマップ

リソースのクリーンアップClean up resources

これ以降 Azure Digital Twins の探索を中止する場合は、このチュートリアルで作成されたリソースを削除してかまいません。If you want to stop exploring Azure Digital Twins beyond this point, feel free to delete resources created in this tutorial:

  1. Azure portal の左側のメニューの [すべてのリソース] をクリックし、目的の Digital Twins リソース グループを選択して [削除] を選択します。From the left menu in the Azure portal, select All resources, select your Digital Twins resource group, and then select Delete.

    ヒント

    ご自分の Digital Twins インスタンスの削除で問題が発生していた場合は、サービス更新が修正と共にロールアウトされています。If you experienced trouble deleting your Digital Twins instance, a service update has been rolled out with the fix. ご自分のインスタンスの削除を再試行してください。Please retry deleting your instance.

  2. 必要に応じて、作業マシン上のサンプル アプリケーションを削除します。If necessary, delete the sample applications on your work machine.

次の手順Next steps

Azure Digital Twins の空間インテリジェンス グラフとオブジェクト モデルについて学習するには、次の記事に進んでください。Go to the next article to learn more about spatial intelligence graphs and object models in Azure Digital Twins.