IoT Central の外部でデータを変換する

[アーティクル]
11/27/2023

IoT デバイスから送信されるデータにはさまざまな形式があります。デバイスデータをご自分の IoT Central アプリケーションで使用するには、以下を行うために変換が必要になる場合があります。

IoT Central アプリケーションと互換性があるデータ形式にする。
単位を変換する。
新しいメトリックを計算する。
他のソースのデータをエンリッチする。

この記事では、イングレスまたはエグレス時のいずれかで、IoT Central の外部でデバイスデータを変換する方法について説明します。

Note

IoT Central は、データを内部的に変換することもできます。詳細については、「IoT Central での受信時にテレメトリをマップする」および「IoT Central アプリケーション内のデータをエクスポート用に変換する」を参照してください。

次の図は、変換が含まれるデータの 3 つのルートを示しています。

イングレスとエグレスの両方のデータ変換ルートの概要

次の表は、3 つの変換の種類の例を示しています。

変換	説明	例	メモ
メッセージの形式	JSON メッセージに変換または操作します。	CSV から JSON	イングレス時。 IoT Central で行われるのは、値の JSON メッセージの受け入れのみです。詳細については、「テレメトリ、プロパティ、およびコマンドのペイロード」を参照してください。
計算を	Azure Functions で実行できる数学関数。	華氏から摂氏への単位変換。	IoT Central への直接接続を介して、デバイスのスケーラブルなイングレスを活用するために、エグレスパターンを使用して変換します。データを変換すると、視覚化やジョブなどの IoT Central 機能を使用できるようになります。
メッセージの強化	デバイスのプロパティやテレメトリにはない外部データソースからのエンリッチメント。内部エンリッチメントの詳細については、Azure Blob Storage を使用してクラウドに IoT データをエクスポートするを参照してください。	デバイスの場所データを使用して気象情報をメッセージに追加する。	IoT Central への直接接続を介して、デバイスのスケーラブルなイングレスを活用するために、エグレスパターンを使用して変換します。

前提条件

この攻略ガイドの手順を完了するには、次が必要です。

有効な Azure サブスクリプション Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
カスタムアプリケーションテンプレートから作成された IoT Central アプリケーション。詳細については、「IoT Central アプリケーションを作成する」と「アプリケーションに関する情報」をご覧ください。

イングレス時のデータ変換

デバイスデータをイングレス時に変換するには、次の 2 つのオプションがあります。

IoT Edge: IoT Central アプリケーションにデータを送信する前に、IoT Edge モジュールを使用してダウンストリームデバイスのデータを変換します。
IoT Central デバイスブリッジ: IoT Central デバイスブリッジを使って、Sigfox、Particle、The Things Network などの他の IoT デバイスクラウドを IoT Central に接続します。デバイスブリッジによって、データの転送に Azure 関数が使用されます。この関数をカスタマイズして、デバイスデータを変換することができます。

IoT Edge を使用してデバイスデータを変換する

イングレス時に IoT Edge を使用するデータ変換

このシナリオでは、ダウンストリームデバイスのデータを IoT Central アプリケーションに転送する前に IoT Edge モジュールを使用して変換します。このシナリオを構成する手順の概要は次のとおりです。

IoT Edge デバイスを設定する: IoT Edge デバイスをインストールしてゲートウェイとしてプロビジョニングし、このゲートウェイを IoT Central アプリケーションに接続します。
ダウンストリームデバイスを IoT Edge デバイスに接続する: ダウンストリームデバイスを IoT Edge デバイスに接続し、IoT Central アプリケーションにプロビジョニングします。
IoT Edge 内でデバイスデータを変換する: データを変換する IoT Edge モジュールを作成します。このモジュールを IoT Edge ゲートウェイデバイスに配置し、ここから、変換されたデバイスデータが IoT Central アプリケーションに転送されます。
検証: ダウンストリームデバイスからゲートウェイにデータを送信し、変換されたデバイスデータが IoT Central アプリケーションに到達することを確認します。

以降のセクションで説明する例では、ダウンストリームデバイスから、次の形式の JSON データを IoT Edge ゲートウェイデバイスに送信します。

{
  "device": {
      "deviceId": "<downstream-deviceid>"
  },
  "measurements": {
    "temp": <temperature>,
    "pressure": <pressure>,
    "humidity": <humidity>,
    "scale": "celsius",
  }
}

IoT Edge モジュールを使用してデータを変換し、温度値を Celsius から Fahrenheit に変換してから、IoT Central に送信します。

{
  "device": {
      "deviceId": "<downstream-deviceid>"
  },
  "measurements": {
    "temp": <temperature>,
    "pressure": <pressure>,
    "humidity": <humidity>,
    "scale": "fahrenheit"
  }
}

次の手順は、このシナリオを設定して構成する方法を示しています。

カスタムモジュールをビルドする

このシナリオでは、IoT Edge デバイスで、ダウンストリームデバイスのデータを変換するカスタムモジュールを実行します。 IoT Edge デバイスを配置して構成する前に、次のことを行う必要があります。

カスタムモジュールをビルドします。
カスタムモジュールをコンテナーレジストリに追加します。

IoT Edge ランタイムを使って、Azure コンテナーレジストリや Docker Hub などのコンテナーレジストリからカスタムモジュールをダウンロードします。 Azure Cloud Shell には、コンテナーレジストリの作成、モジュールのビルド、モジュールのレジストリへのアップロードに必要なすべてのツールが用意されています。

コンテナーレジストリを作成するには、次のようにします。

Azure Cloud Shell を開き、Azure サブスクリプションにサインインします。
Bash シェルを選択します。
次のコマンドを実行して、Azure コンテナーレジストリを作成します。
```
REGISTRY_NAME="{your unique container registry name}"
az group create --name ingress-scenario --location eastus
az acr create -n $REGISTRY_NAME -g ingress-scenario --sku Standard --admin-enabled true
az acr credential show -n $REGISTRY_NAME
```
username と password の値を書き留めておきます。これらは後で使用します。コマンドの出力に表示されるパスワードの 1 つだけが必要です。

Azure Cloud Shell でカスタムモジュールをビルドするには、次のようにします。

Azure Cloud Shell で、モジュールのソースコードが含まれている GitHub リポジトリをクローンします。
```
git clone https://github.com/iot-for-all/iot-central-transform-with-iot-edge
```
カスタムモジュールをビルドするため、Azure Cloud Shell で次のコマンドを実行します。
```
cd iot-central-transform-with-iot-edge/custommodule/transformmodule
az acr build --registry $REGISTRY_NAME --image transformmodule:0.0.1-amd64 -f Dockerfile.amd64 .
```
これらのコマンドの実行には数分かかる場合があります。

IoT Edge デバイスを設定する

このシナリオでは、IoT Edge ゲートウェイデバイスを使用して、ダウンストリームデバイスのデータを変換します。このセクションでは、IoT Central アプリケーション内でゲートウェイデバイス用の IoT Central デバイステンプレートを作成する方法について説明します。 IoT Edge デバイスにより、配置マニフェストが使用され、そのモジュールが構成されます。

この例では、ダウンストリームデバイスにデバイステンプレートは不要です。ダウンストリームデバイスは IoT Central に登録されるため、IoT Edge デバイスに接続するために必要な資格情報を生成できます。 IoT Edge モジュールでデータが変換されるため、すべてのダウンストリームデバイステレメトリは、IoT Edge デバイスによって送信されたかのように IoT Central で受信されます。

IoT Edge ゲートウェイデバイス用のデバイステンプレートを作成するには、次のようにします。

配置マニフェスト moduledeployment.json のコピーをローカルの開発用コンピューターに保存します。
moduledeployment.json マニフェストファイルのローカルコピーをテキストエディターで開きます。
registryCredentials セクションを見つけて、プレースホルダーを Azure コンテナーレジストリの作成時に書き留めた値に置き換えます。 address 値は {your username}.azurecr.io のようになります。
transformmodule の settings セクションを見つけます。 {your username} を前の手順で使ったのと同じ値に置き換えます。変更を保存します。
IoT Central アプリケーションで、[エッジマニフェスト] ページに移動します。
[+新規] を選択します。配置マニフェストの名前 (Transformer など) を入力し、前にダウンロードした moduledeployment.json ファイルをアップロードします。配置マニフェストには、transformmodule というカスタムモジュールが含まれています。
[次へ]、[作成] の順に選択します。
IoT Central アプリケーションで、[デバイステンプレート] ページに移動します。
[+ 新規作成] を選択し、[Azure IoT Edge] を選択して、[次へ: カスタマイズ] を選択します。
デバイステンプレート名として「IoT Edge gateway device」と入力します。 [This is a gateway device]$これはゲートウェイデバイスです$ を選択します。
[次へ: 確認] を選択して、[作成] を選択します。
[モデルの作成] ページで、[カスタムモデル] を選びます。
モデルで、[モジュール]、[マニフェストからモジュールをインポート] の順に選択します。 [Transformer] 配置マニフェストを選択して、[インポート] を選択します。

デプロイマニフェストからは、モジュールから送信されるテレメトリは指定されません。デバイステンプレートにテレメトリの定義を追加するには:

IoT Edge ゲートウェイデバイス テンプレートの [モジュール] セクションで [Module transformmodule] を選択します。
[機能の追加] を選択し、次のテーブルに含まれる情報を利用して新しいテレメトリの種類を追加します。

設定値

表示名デバイス

名前 device

機能の種類テレメトリ

セマンティックの種類なし

[スキーマ] Object

オブジェクト定義:

[表示名] 名前 [スキーマ]

Device ID deviceId String

変更を保存。

設定	値
表示名	デバイス
名前	device
機能の種類	テレメトリ
セマンティックの種類	なし
[スキーマ]	Object

[表示名]	名前	[スキーマ]
Device ID	deviceId	String

[機能の追加] を選択し、次のテーブルに含まれる情報を利用して新しいテレメトリの種類を追加します。

設定	値
表示名	測定
名前	測定
機能の種類	テレメトリ
セマンティックの種類	なし
[スキーマ]	Object

オブジェクト定義:

[表示名]	名前	[スキーマ]
温度	温度	倍精度浮動小数点型
"圧力"	気圧	倍精度浮動小数点型
湿度	湿度	倍精度浮動小数点型
拡大縮小	scale	String

変更を保存。

モデルで、[リレーションシップ] を選びます。 transformmodule モジュールでは [リレーションシップ] を選ばないでください。
[リレーションシップの追加] を選びます。
表示名として「Downstream Sensor」、名前として「sensor」と入力し、ターゲットとして [任意] を選びます。 [保存] を選択します。
[発行] を選択して、デバイステンプレートを発行します。

IoT Central にゲートウェイデバイスを登録するには、次のようにします。

IoT Central アプリケーションで、 [デバイス] ページに移動します。
[IoT Edge ゲートウェイデバイス] を選び、[+ 新規作成] を選びます。デバイス名として「IoT Edge gateway device」と入力し、デバイス ID として「gateway-01」と入力し、デバイステンプレートとして IoT Edge gateway device が選択され、[このデバイスをシミュレートする] が [いいえ] になっていることを確認します。エッジマニフェストとして [Transformer] を選択します。 ［作成］ を選択します
デバイスの一覧で、IoT Edge gateway device をクリックし、[接続] を選択します。
IoT Edge gateway device の ID スコープ、デバイス ID、主キーの値を書き留めておきます。これらは後で使用します。

IoT Central にダウンストリームデバイスを登録するには、次のようにします。

IoT Central アプリケーションで、 [デバイス] ページに移動します。
デバイステンプレートを選択しないでください。 [+新規] を選択します。デバイス名として「Downstream 01」と入力し、デバイス ID として「downstream-01」と入力し、デバイステンプレートが未割り当て、および [このデバイスをシミュレートする] が [いいえ] になっていることを確認します。 ［作成］ を選択します
デバイス一覧の [Downstream 01] デバイスをクリックし、[マネージドデバイス] > [Attach to gateway] (ゲートウェイにアタッチ) を選びます。
[Attach to a gateway] (ゲートウェイにアタッチ) ダイアログで [IoT Edge ゲートウェイデバイス] デバイステンプレートと [IoT Edge ゲートウェイデバイス] デバイスインスタンスを選びます。 [接続] を選択します。
[Downstream 01] デバイスで [接続] を選びます。
Downstream 01 デバイスの ID スコープ、デバイス ID、主キーの値を書き留めておきます。これらは後で使用します。

ゲートウェイとダウンストリームデバイスを配置する

便宜上、この記事では、Azure 仮想マシンを使用してゲートウェイとダウンストリームデバイスを実行します。 2 つの Azure 仮想マシンを作成するには、次の表の後に表示される [Azure に配置する] ボタンを選びます。表の情報を使って [カスタムデプロイ] フォームに入力します。

フィールド	値
リソースグループ	`ingress-scenario`
[DNS Label Prefix Gateway]$DNS ラベルプレフィックスゲートウェイ$	このマシンの一意の DNS 名 (例: `<your name>edgegateway`)
[DNS Label Prefix Downstream]$DNS ラベルプレフィックスダウンストリーム$	このマシンの一意の DNS 名 (例: `<your name>downstream`)
スコープ ID	前に書き留めておいた ID スコープ
[Device ID IoT Edge Gateway]$デバイス ID IoT Edge ゲートウェイ$	`gateway-01`
[Device Key IoT Edge Gateway]$デバイスキー IoT Edge ゲートウェイ$	前に書き留めておいた主キーの値
認証の種類	Password
管理者パスワードまたはキー	両方の仮想マシンの AzureUser アカウントのパスワードを選択します。

[確認および作成]、[作成] の順に選択します。 ingress-scenario リソースグループに仮想マシンを作成するには数分かかります。

IoT Edge ゲートウェイデバイスが正常に動作していることを確認するには、次の手順を実行します。

IoT Central アプリケーションを開きます。次に、[デバイス] ページのデバイスの一覧で、IoT Edge Gateway device に移動します。
[モジュール] タブを選択し、3 つのモジュールの状態を確認します。仮想マシンで IoT Edge ランタイムが起動するまでに数分かかります。仮想マシンが実行されている場合、3 つのモジュールの状態は [実行中] です。 IoT Edge ランタイムが起動しない場合は、「IoT Edge デバイスのトラブルシューティング」を参照してください。

IoT Edge デバイスがゲートウェイとして機能するためには、あらゆるダウンストリームデバイスに対してその ID を証明するための証明書がいくつか必要です。この記事ではデモ証明書を使用します。運用環境では、利用している証明機関からの証明書を使用してください。

デモ証明書を生成してゲートウェイデバイスにインストールするには、次のようにします。

SSH を使用して、ゲートウェイデバイスの仮想マシンに接続してサインインします。この仮想マシンの DNS 名は Azure portal で確認できます。 ingress-scenario リソースグループ内の edgegateway 仮想マシンに移動します。

ヒント

SSH を使用してローカルコンピューターまたは Azure Cloud Shell から接続する前に、場合により、両方の仮想マシンで SSH アクセス用にポート 22 を開く必要があります。
次のコマンドを実行して、IoT Edge リポジトリをクローンし、デモ証明書を生成します。
```
# Clone the repo
cd ~
git clone https://github.com/Azure/iotedge.git

# Generate the demo certificates
mkdir certs
cd certs
cp ~/iotedge/tools/CACertificates/*.cnf .
cp ~/iotedge/tools/CACertificates/certGen.sh .
./certGen.sh create_root_and_intermediate
./certGen.sh create_edge_device_ca_certificate "mycacert"
```
上記のコマンドを実行すると、後続の手順で下記のファイルを使用する準備が整います。
- ~/certs/certs/azure-iot-test-only.root.ca.cert.pem - IoT Edge シナリオをテストするための、その他すべてのデモ用証明書を作成するために使用されるルート CA 証明書。
- ~/certs/certs/iot-edge-device-mycacert-full-chain.cert.pem - config.yaml ファイルから参照されるデバイス CA 証明書。ゲートウェイのシナリオでは、IoT Edge デバイスはこの CA 証明書によって、ダウンストリームデバイスに対して自らの ID を検証します。
- ~/certs/private/iot-edge-device-mycacert.key.pem - デバイス CA 証明書に関連付けられた秘密キー。
これらのデモ証明書の詳細については、「IoT Edge デバイスの機能をテストするためのデモ用の証明書を作成する」を参照してください。
config.toml ファイルをテキストエディターで開きます。次に例を示します。
```
sudo nano /etc/aziot/config.toml
```

次のように、証明書の設定をコメント解除して変更します。

trust_bundle_cert = "file:///home/AzureUser/certs/certs/azure-iot-test-only.root.ca.cert.pem"

...

[edge_ca]
cert = "file:///home/AzureUser/certs/certs/iot-edge-device-ca-mycacert-full-chain.cert.pem"
pk = "file:///home/AzureUser/certs/private/iot-edge-device-ca-mycacert.key.pem"

前の例では、AzureUser としてサインイン済みであり、"mycacert" という名前のデバイス CA 証明書が作成済みであると想定しています。

変更を保存し、次のコマンドを実行して、config.toml ファイルが正しいことを確認します。
```
sudo iotedge check
```
IoT Edge ランタイムを再起動する:
```
sudo iotedge config apply
```

変更後に IoT Edge ランタイムが正常に起動すると、$edgeAgent および $edgeHub モジュールの状態が [実行中] に変わります。これらの状態値は、IoT Central で、ゲートウェイデバイスの [モジュール] ページで確認できます。

ランタイムが起動しない場合は、config.toml で行った変更を確認し、「IoT Edge デバイスのトラブルシューティング」を参照してください。

ダウンストリームデバイスを IoT Edge デバイスに接続する

ダウンストリームデバイスを IoT Edge ゲートウェイデバイスに接続するには、次のようにします。

SSH を使用して、ダウンストリームデバイスの仮想マシンに接続してサインインします。この仮想マシンの DNS 名は Azure portal で確認できます。 ingress-scenario リソースグループ内の leafdevice 仮想マシンに移動します。

ヒント

SSH を使用してローカルコンピューターまたは Azure Cloud Shell から接続する前に、場合により、両方の仮想マシンで SSH アクセス用にポート 22 を開く必要があります。
サンプルダウンストリームデバイスのソースコードを使用して GitHub リポジトリをクローンするため、次のコマンドを実行します。
```
cd ~
git clone https://github.com/iot-for-all/iot-central-transform-with-iot-edge
```
ゲートウェイデバイスから必要な証明書をコピーするため、次のscp コマンドを実行します。この scp コマンドにより、ホスト名 edgegateway を使用してゲートウェイ仮想マシンが識別されます。パスワードの入力を求められます。
```
cd ~/iot-central-transform-with-iot-edge
scp AzureUser@edgegateway:/home/AzureUser/certs/certs/azure-iot-test-only.root.ca.cert.pem leafdevice/certs
```
leafdevice フォルダーに移動し、必要なパッケージをインストールします。次に、build および start スクリプトを実行して、デバイスをプロビジョニングしてゲートウェイに接続します。
```
cd ~/iot-central-transform-with-iot-edge/leafdevice
sudo apt update
curl -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash -
sudo apt-get install nodejs
npm install
npm run-script build
npm run-script start
```
sudo apt-get install nodejs コマンドの実行中にインストールを許可するように求められる場合があります。ダイアログが表示されたら Y を押します。

先ほど作成したダウンストリームデバイスのデバイス ID、スコープ ID、および SAS キーを入力します。ホスト名に「edgegateway」と入力します。コマンドの出力は次のようになります。

Registering device downstream-01 with scope 0ne00284FD9
Registered device downstream-01.
Connecting device downstream-01
Connected device downstream-01
Sent telemetry for device downstream-01
Sent telemetry for device downstream-01
Sent telemetry for device downstream-01
Sent telemetry for device downstream-01
Sent telemetry for device downstream-01
Sent telemetry for device downstream-01

わかりやすくするために、ダウンストリームデバイスのコードによって IoT Central にデバイスがプロビジョニングされます。通常、ダウンストリームデバイスはインターネットに接続できず、Device Provisioning Service エンドポイントに接続できないため、ゲートウェイを介して接続します。詳細については、IoT Edge の透過的なゲートウェイを使用してデバイスを接続する方法に関するページを参照してください。

確認

シナリオが実行されていることを確認するには、IoT Central で IoT Edge gateway device に移動します。

[モジュール] を選択します。 3 つの IoT Edge モジュール $edgeAgent、$edgeHub、および transformmodule が実行されていることを確認します。
[生データ] を選択します。 [デバイス] 列のテレメトリデータは次のようになります。
```
{"deviceId":"downstream-01"}
```
[測定] 列のテレメトリデータは次のようになります。
```
{"temperature":85.21208,"pressure":59.97321,"humidity":77.718124,"scale":"farenheit"}
```

気温は華氏で送信されます。 IoT Edge デバイスによって、ダウンストリームデバイスのデータが変換されるため、テレメトリは、IoT Central 内で、ゲートウェイデバイスに関連付けられています。変換されたテレメトリを視覚化するには、IoT Edge ゲートウェイデバイス テンプレートでビューを作成し、それを再発行します。

エグレス時のデータ変換

デバイスを IoT Central に接続し、デバイスデータをコンピューティングエンジンにエクスポートして変換した後、デバイスの管理と分析を行えるように、変換されたデータを IoT Central に戻すことができます。次に例を示します。

位置情報データが、デバイスから IoT Central に送信されます。
データは IoT Central からコンピューティングエンジンにエクスポートされ、そこで、気象情報を使って位置情報データが拡張されます。
拡張されたデータは、コンピューティングエンジンによって IoT Central に戻されます。

コンピューティングエンジンとして IoT Central デバイスブリッジを使用して、IoT Central からエクスポートされたデータを変換できます。

エグレス時にデータを変換する利点は、デバイスが IoT Central に直接接続されることです。これにより、デバイスにコマンドを送信したり、デバイスのプロパティを更新したりすることが簡単になります。ただし、この方法では、使用するメッセージが毎月の割り当てよりも多くなり、Azure IoT Central の使用コストが増加する可能性があります。

IoT Central デバイスブリッジを使用してデバイスデータを変換する

エグレス時に IoT Edge を使用するデータ変換

このシナリオでは、IoT Central からエクスポートされたデバイスデータが、コンピューティングエンジンによって変換された後、IoT Central アプリケーションに戻されます。このシナリオを構成する手順の概要は次のとおりです。

コンピューティングエンジンを設定する: データ変換のためのコンピューティングエンジンとして機能する IoT Central デバイスブリッジを作成します。
デバイスブリッジのデバイスデータを変換する: データ変換のユースケースに合わせてデバイスブリッジ関数コードを変更して、デバイスブリッジのデータを変換します。
IoT Central からデバイスブリッジへのデータフローを有効にする: 変換のために IoT Central からデバイスブリッジにデータをエクスポートします。次に、変換されたデータを IoT Central に戻します。データのエクスポートを作成するとき、メッセージプロパティフィルターを使用して、変換されていないデータのみをエクスポートします。
確認: デバイスを IoT Central アプリに接続し、IoT Central で、生のデバイスデータと変換されたデータの両方を確認します。

以降のセクションで説明する例では、デバイスから、次の形式の CSV データを IoT Edge ゲートウェイデバイスに送信します。

"<temperature in degrees C>, <humidity>, <latitude>, <longitude>"

デバイスブリッジを使用して、以下を行ってデバイスデータを変換します。

気温の単位を摂氏から華氏に変更する。
Open Weather サービスから、緯度と経度の値に対して取得した気象データを使用して、デバイスデータをエンリッチする。

変換されたデータは、デバイスブリッジによって、次の形式で IoT Central に送信されます。

{
  "temp": <temperature in degrees F>,
  "humidity": <humidity>,
  "lat": <latitude>,
  "lon": <logitude>,
  "weather": {
    "weather_temp": <temperature at lat/lon>,
    "weather_humidity": <humidity at lat/lon>,
    "weather_pressure": <pressure at lat/lon>,
    "weather_windspeed": <wind speed at lat/lon>,
    "weather_clouds": <cloud cover at lat/lon>,
    "weather_uvi": <UVI at lat/lon>
  }
}

次の手順は、このシナリオを設定して構成する方法を示しています。

IoT Central 接続設定を取得する

このシナリオを設定する前に、IoT Central アプリケーションからいくつかの接続設定を取得する必要があります。

ご使用の IoT Central アプリケーションにサインインします。
[アクセス許可] > [デバイス接続グループ] に移動します。
ID スコープ を書き留めておきます。この値は後で使用します。
SaS-IoT-Devices 登録グループを選択します。 Shared Access Signature の主キーを書き留めておきます。この値は後で使用します。

コンピューティングエンジンを設定する

このシナリオでは、IoT Central デバイスブリッジと同じ Azure Functions 配置を使用します。デバイスブリッジをデプロイするには、次の表の後に表示される [Azure に配置する] ボタンを選びます。表の情報を使って [カスタムデプロイ] フォームに入力します。

フィールド	値
リソースグループ	`egress-scenario` という名前で新しいリソースグループを作成します
リージョン	最も近いリージョンを選択します。
スコープ ID	前に書き留めておいた ID スコープを使用します。
[IoT Central SAS Key]$IoT Central SAS キー$	SaS-IoT-Devices 登録グループの Shared Access Signature の主キーを使用します。この値は、前に書き留めてあります。

。

[確認および作成]、[作成] の順に選択します。 egress-scenario リソースグループに Azure 関数と関連リソースを作成するには数分かかります。

デバイスブリッジでデバイスデータを変換する

エクスポートされたデバイスデータを変換するようにデバイスブリッジを構成するには、次のようにします。

Open Weather サービスからアプリケーション API キーを取得します。アカウントは無料で、サービスの利用に制限があります。アプリケーション API キーを作成するには、Open Weather サービスポータルでアカウントを作成し、指示に従います。 Open Weather API キーは後で使用します。
Azure portal で、egress-scenario リソースグループの関数アプリに移動します。
左側のナビゲーションの [開発ツール] で、[App Service Editor (プレビュー)] を選択します。
[移動 →] を選択して [App Service Editor] ページを開きます。次の変更を行います。
1. wwwroot/IoTCIntegration/index.js ファイルを開きます。このファイル内のすべてのコードを index.js のコードに置き換えます。
2. 新しい index.js で、先ほど取得した Open Weather API キーを使用して openWeatherAppId 変数ファイルを更新します。
```
const openWeatherAppId = '<Your Open Weather API Key>'
```
3. 関数から IoT Central に送信されるデータにメッセージプロパティを追加します。このプロパティは、変換されたデータをエクスポートしないように IoT Central によって使用されます。この変更を行うには、wwwroot/IoTCIntegration/lib/engine.js ファイルを開きます。次のコードを見つけます。
```
if (timestamp) {
  message.properties.add('iothub-creation-time-utc', timestamp);
}
```
  次のコードを前のスニペットのコードのすぐ下に追加します。
```
// add a message property that we can look for in data export to not re-compute computed telemetry
message.properties.add('computed', true);
```
  参考のため、engine.js ファイルの完全な例を確認できます。
App Service Editor の左側のナビゲーションで、[コンソール] を選択します。次のコマンドを実行して、必要なパッケージをインストールします。
```
cd IoTCIntegration
npm install
```
このコマンドの実行には、数分かかる場合があります。
[Azure Function Overview]$Azure 関数の概要$ ページに戻り、関数を再起動します。
左側のナビゲーションで、[関数] を選択します。次に、IoTCIntegration を選択します。 [Code + Test](コード + テスト) を選択します。
関数の URL をメモしておきます。この値は後で必要になります。

IoT Central からデバイスブリッジへのデータフローを有効にする

このセクションでは、Azure IoT Central アプリケーションを設定する方法について説明します。

まず、デバイスモデルファイルをローカルコンピューターに保存します。

IoT Central アプリケーションにデバイステンプレートを追加するには、IoT Central アプリケーションに移動してから、次のようにします。

IoT Central アプリケーションにサインインし、[デバイステンプレート] ページに移動します。
[+ 新規作成] を選択し、[IoT デバイス] を選択して、[次へ: カスタマイズ] を選択し、テンプレート名として「Compute model」と入力します。 確認\) をクリックします。 [作成] を選択します。
[モデルのインポート] を選択し、先にダウンロードした model.json ファイルを参照します。
モデルをインポートした後、[発行] を選択して Compute model デバイステンプレートを発行します。

データのエクスポートを設定して、デバイスブリッジにデータを送信します。

IoT Central アプリケーションで、[データのエクスポート] を選択します。
[+ New destination]$+ 新しい変換先$ を選択して、デバイスブリッジで使用する変換先を作成します。変換先に「Compute function」という名前を指定し、[ターゲットの種類] に [Webhook] を選択します。 [コールバック URL] には、前に書き留めておいた関数の URL の貼り付けを選択します。 [認証] を [No Auth]$認証なし$ のままにします。
変更を保存します。
[+ 新しいエクスポート] を選択し、「Compute export」というデータエクスポートを作成します。
使用しているデバイステンプレートのデバイスデータのみをエクスポートするフィルターを追加します。 [+ フィルター] を選択し、項目 [デバイステンプレート] を選択します。等号演算子を選択し、作成した Compute model デバイステンプレートを選択します。
変換されたデータと変換されていないデータを区別するメッセージフィルターを追加します。このフィルターを使って、変換された値がデバイスブリッジに戻らないようにします。 [+ Message property filter]$+ メッセージプロパティフィルター$ を選択し、名前値「computed」を入力して、演算子 [存在しません] を選択します。文字列 computed は、デバイスブリッジのサンプルコードでキーワードとして使用されます。
変換先として、先ほど作成した Compute function 変換先を選択します。
変更を保存します。 1 分ほど経過すると、[エクスポートの状態] に [正常] が表示されます。

確認

シナリオのテストに使用するサンプルデバイスは Node.js で記述されています。ローカルコンピューターに Node.js と npm がインストールされていることを確認します。これらの前提条件をインストールしない場合は、それらがプレインストールされている Azure Cloud Shell を使用します。

シナリオをテストするサンプルデバイスを実行するには、次のようにします。

サンプルコードが含まれている GitHub リポジトリをクローンし、次のコマンドを実行します。
```
git clone https://github.com/Azure/iot-central-compute
```
サンプルデバイスを IoT Central アプリケーションに接続するため、iot-central-compute/device/device.js ファイルの接続設定を編集します。スコープ ID とグループ SAS キーを、前に書き留めておいた値に置き換えます。
```
// These values need to be filled in from your Azure IoT Central application
//
const scopeId = "<IoT Central Scope Id value>";
const groupSasKey = "<IoT Central Group SAS key>";
//
```
変更を保存します。
次のコマンドを使用して、必要なパッケージをインストールし、デバイスを実行します。
```
cd ~/iot-central-compute/device
npm install
node device.js
```

このコマンドの結果は、次の出力のようになります。

registration succeeded
assigned hub=iotc-2bd611b0....azure-devices.net
deviceId=computeDevice
Client connected
send status: MessageEnqueued [{"data":"33.23, 69.09, 30.7213, -61.1192"}]
send status: MessageEnqueued [{"data":"2.43, 75.86, -2.6358, 162.935"}]
send status: MessageEnqueued [{"data":"6.19, 76.55, -14.3538, -82.314"}]
send status: MessageEnqueued [{"data":"33.26, 48.01, 71.9172, 48.6606"}]
send status: MessageEnqueued [{"data":"40.5, 36.41, 14.6043, 14.079"}]

IoT Central アプリケーションで、computeDevice というデバイスに移動します。 [生データ] ビューに、2 つの異なるテレメトリストリームが約 5 秒ごとに表示されます。モデル化されていないデータを含むストリームが元のテレメトリで、モデル化されたデータを含むストリームが関数によって変換されたデータです。

リソースをクリーンアップする

このガイドの手順に従って作成した Azure リソースが不要になった場合は、Azure portal でリソースグループを削除します。

このガイドで使用した 2 つのリソースグループは、ingress-scenario と egress-scenario です。

次のステップ

この記事では、IoT Central に対して、イングレスとエグレスの両方で、デバイスデータを変換するためのさまざまなオプションについて説明しました。次の 2 つの個別のシナリオについてのチュートリアルを記事で紹介しました。

IoT Central アプリケーションにデータを送信する前に、IoT Edge モジュールを使用してダウンストリームデバイスのデータを変換します。
Azure Functions を使用して、IoT Central の外部でデータを変換します。このシナリオでは、IoT Central で、データのエクスポートを使用して、変換される Azure 関数に受信データを送信します。変換されたデータは、関数によって、IoT Central アプリケーションに戻されます。

Azure IoT Central アプリケーションの外部でデバイスデータを変換する方法を説明したので、次は、IoT Central でデータエクスプローラーを使用してデバイスデータを分析する方法について説明します。

次の方法で共有

IoT Central の外部でデータを変換する

前提条件

イングレス時のデータ変換

IoT Edge を使用してデバイスデータを変換する

カスタムモジュールをビルドする

IoT Edge デバイスを設定する

ゲートウェイとダウンストリームデバイスを配置する

ダウンストリームデバイスを IoT Edge デバイスに接続する

確認

エグレス時のデータ変換

IoT Central デバイスブリッジを使用してデバイスデータを変換する

IoT Central 接続設定を取得する

コンピューティングエンジンを設定する

デバイスブリッジでデバイスデータを変換する

IoT Central からデバイスブリッジへのデータフローを有効にする

確認

リソースをクリーンアップする

次のステップ

フィードバック

その他のリソース

フィールド	値
リソースグループ	`ingress-scenario`
[DNS Label Prefix Gateway]\(DNS ラベルプレフィックスゲートウェイ\)	このマシンの一意の DNS 名 (例: `<your name>edgegateway`)
[DNS Label Prefix Downstream]\(DNS ラベルプレフィックスダウンストリーム\)	このマシンの一意の DNS 名 (例: `<your name>downstream`)
スコープ ID	前に書き留めておいた ID スコープ
[Device ID IoT Edge Gateway]\(デバイス ID IoT Edge ゲートウェイ\)	`gateway-01`
[Device Key IoT Edge Gateway]\(デバイスキー IoT Edge ゲートウェイ\)	前に書き留めておいた主キーの値
認証の種類	Password
管理者パスワードまたはキー	両方の仮想マシンの AzureUser アカウントのパスワードを選択します。

次の方法で共有

IoT Central の外部でデータを変換する

前提条件

イングレス時のデータ変換

IoT Edge を使用してデバイス データを変換する

カスタム モジュールをビルドする

IoT Edge デバイスを設定する

ゲートウェイとダウンストリーム デバイスを配置する

ダウンストリーム デバイスを IoT Edge デバイスに接続する

確認

エグレス時のデータ変換

IoT Central デバイス ブリッジを使用してデバイス データを変換する

IoT Central 接続設定を取得する

コンピューティング エンジンを設定する

デバイス ブリッジでデバイス データを変換する

IoT Central からデバイス ブリッジへのデータ フローを有効にする

確認

リソースをクリーンアップする

次のステップ

フィードバック

その他のリソース

IoT Edge を使用してデバイスデータを変換する

カスタムモジュールをビルドする

ゲートウェイとダウンストリームデバイスを配置する

ダウンストリームデバイスを IoT Edge デバイスに接続する

IoT Central デバイスブリッジを使用してデバイスデータを変換する

コンピューティングエンジンを設定する

デバイスブリッジでデバイスデータを変換する

IoT Central からデバイスブリッジへのデータフローを有効にする