資産の構成をリモートで管理する

操作エクスペリエンスにサインインするには、ブラウザーで操作エクスペリエンスに移動し、Microsoft Entra ID 資格情報を使用してサインインします。

サイトを選択する

サインインすると、Web UI にサイトの一覧が表示されます。 各サイトは、資産を構成および管理できる Azure IoT Operations インスタンスのコレクションです。 サイトは通常、物理的な資産がデプロイされている、物理的な場所を表します。 サイトを使用すると、資産を簡単に見つけて管理できます。 IT 管理者は、インスタンスをサイトにグループ化する役割を担います。 サイトに割り当てられていない Azure IoT Operations インスタンスは、[割り当てされていないインスタンス] ノードに表示されます。 使用するサイトを選択します。

サイトが表示されない場合は、適切な Azure Active Directory テナントにいない可能性があります。 操作エクスペリエンスの右上のメニューからテナントを変更できます。 まだサイトが表示されない場合は、まだ追加されていないことを意味します。 IT 管理者に連絡してアクセス権を要求します。

インスタンスを選択する

サイトを選択すると、サイトの一部である Azure IoT Operations インスタンスの一覧が操作エクスペリエンスに表示されます。 使用するインスタンスを選択します。

インスタンスを選択すると、Operations Experience にそのインスタンスの [概要] ページが表示されます。 [概要] ページには、インスタンスおよびそれに関連付けられた資産などのリソースの状態が表示されます。

az iot ops asset コマンドを使用する前に、Azure IoT Operations のデプロイを含むサブスクリプションにサインインします。

az login

1. [資産エンドポイント] を選択し、続いて [資産エンドポイントの作成] を選択します。

   

   ヒント

   フィルター ボックスを使用して、資産エンドポイントを検索できます。

2. 次のエンドポイント情報を入力します。

   フィールド	値
   名前	opc-ua-connector-0
   OPC UA URL 用コネクタ	opc.tcp://opcplc-000000:50000
   ユーザー認証	Anonymous

3. 定義を保存するには、[作成] を選択します。

次のコマンドを実行します。

az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} 

詳細については、「az iot ops asset endpoint」を参照してください。

1. 「ユーザー名とパスワードを使用して OPC UA ユーザー認証を構成する」の手順に従って、Azure Key Vault にユーザー名とパスワードのシークレットを追加し、Kubernetes クラスターに投影します。
2. 操作エクスペリエンスで、[ユーザー認証] フィールドの [ユーザー名とパスワード] を選択して、これらのシークレットを使用するように資産エンドポイントを構成します。 [ユーザー名参照] と [パスワード参照] のフィールドに次の値を入力します。

1. 「ユーザー名とパスワードを使用して OPC UA ユーザー認証を構成する」の手順に従って、Azure Key Vault にユーザー名とパスワードのシークレットを追加し、Kubernetes クラスターに投影します。

2. 次の例のようなコマンドを使用して、資産エンドポイントを作成します。

   az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} --username-ref "aio-opc-ua-broker-user-authentication/username" --password-ref "aio-opc-ua-broker-user-authentication/password"
   

操作エクスペリエンスに資産を追加するには:

1. [資産] タブを選択します。資産を作成する前に、次の画面が表示されます。

   

   ヒント

   フィルター ボックスを使用して、資産を検索できます。

2. [資産の作成] を選択します。

3. 資産の詳細画面で、次の資産情報を入力します。

   • 資産エンドポイント。 一覧から資産エンドポイントを選択します。
   • 資産名
   • 説明

4. 資産に関連付けるプロパティのセットを構成します。 プロパティの既定の一覧をそのまま使用することも、独自のものを追加することもできます。 既定では、次のプロパティを使用できます。

   • メーカー
   • 製造元 URI
   • モデル
   • 製品コード
   • ハードウェアのバージョン
   • ソフトウェア バージョン
   • シリアル番号
   • ドキュメント URI

   

5. [次へ] を選択して、[タグを追加します] ページに移動します。

資産に個々のタグを追加する

ここで、資産に関連付けるタグを定義できます。 OPC UA タグを追加するには:

1. [タグまたは CSV の追加] > [タグの追加] を選択します。

2. タグの詳細を入力します。

   • ノード ID。 この値は、OPC UA サーバーからのノード ID です。
   • タグ名 (省略可能)。 この値は、タグに使用するフレンドリ名です。 タグ名を指定しない場合は、ノード ID がタグ名として使用されます。
   • 可観測性モード (省略可能) と次の選択肢:
     • なし
     • ゲージ
     • カウンタ
     • ヒストグラム
     • ログ
   • サンプリング間隔 (ミリ秒)。 このタグの既定値をオーバーライドできます。
   • キュー サイズ。 このタグの既定値をオーバーライドできます。

   

   次の表に、組み込みの OPC PLC シミュレーターで使用できるタグ値の例を示します。

   ノード ID	タグ名	可観測性モード
   ns=3;s=FastUInt10	温度	なし
   ns=3;s=FastUInt100	湿度	なし

3. [既定の設定の管理] を選択して、資産の既定のテレメトリ設定を構成します。 これらの設定は、資産に属するすべての OPC UA タグに適用されます。 これらの設定は、追加するタグごとにオーバーライドできます。 既定のテレメトリ設定は次のとおりです。

   • サンプリング間隔 (ミリ秒): サンプリング間隔は、OPC UA サーバーがその基になるソースをサンプリングしてデータの変更を探す、最も速い速度を示します。
   • パブリッシュ間隔 (ミリ秒): OPC UA サーバーがデータを発行する速度。
   • キュー サイズ: サンプリング データを発行前に保持するキューの深さ。

資産にタグを一括で追加する

CSV ファイルから一度に最大 1000 個の OPC UA タグをインポートできます。

1. 次の例のような CSV ファイルを作成します。

   NodeID	TagName	キュー サイズ	可観測性モード	サンプリング間隔 (ミリ秒)
   ns=3;s=FastUInt1000	タグ 1000	5	なし	1000
   ns=3;s=FastUInt1001	タグ 1001	5	なし	1000
   ns=3;s=FastUInt1002	タグ 1002	10	なし	5000

2. [タグまたは CSV の追加] > [CSV (.csv) ファイルのインポート] を選択します。 作成した CSV ファイルを選択し、[開く] を選択します。 CSV ファイルで定義されているタグがインポートされます。

   

   既存のタグと重複するタグが含まれている CSV ファイルをインポートすると、操作エクスペリエンスに次のメッセージが表示されます。

   

   重複するタグを置き換えてインポート ファイルから新しいタグを追加するか、インポートを取り消すことができます。

3. 資産から CSV ファイルにすべてのタグをエクスポートするには、[すべてエクスポート] を選択し、ファイルの場所を選択します。

   

4. [タグ] ページで、[次へ] を選択して [イベントの追加] ページに移動します。

Azure CLI を使用して "サーモスタット" 資産を追加するには、次のコマンドを使用します。 このコマンドでは、--data パラメータを使用して資産に 2 つのタグを追加します。

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --data  data_source='ns=3;s=FastUInt10', name=temperature --data data_source='ns=3;s=FastUInt100', name='Tag 10'

Azure CLI を使用して資産を作成する場合は、次を定義できます。

• --data パラメータを複数回使用した複数のタグ。
• --event パラメータを複数回使用した複数のイベント。
• 次のような資産の省略可能な情報:
  • メーカー
  • 製造元 URI
  • モデル
  • 製品コード
  • ハードウェアのバージョン
  • ソフトウェア バージョン
  • シリアル番号
  • ドキュメント URI
• サンプリング間隔、発行間隔、キュー サイズの既定値。
• サンプリング間隔、発行間隔、キュー サイズのタグ固有の値。
• サンプリング発行間隔とキュー サイズのイベント固有の値。
• 各タグとイベントの監視モード

ここで、資産に関連付けるイベントを定義できます。 OPC UA イベントを追加するには:

1. [イベントまたは CSV の追加] > [イベントの追加] を選択します。

2. イベントの詳細を入力します。

   • イベント通知。 この値は、OPC UA サーバーからのイベント通知です。
   • イベント名 (省略可能)。 この値は、イベントに使用するフレンドリ名です。 イベント名を指定しない場合は、イベント名としてイベント通知が使用されます。
   • 可観測性モード (省略可能) と次の選択肢:
     • なし
     • ログ
   • キュー サイズ。 このタグの既定値をオーバーライドできます。

   

3. [既定の設定の管理] を選択して、資産の既定のイベント設定を構成します。 これらの設定は、資産に属するすべての OPC UA イベントに適用されます。 これらの設定は、追加するイベントごとにオーバーライドできます。 既定のイベント設定は以下のとおりです。

   • パブリッシュ間隔 (ミリ秒): OPC UA サーバーがデータを発行する速度。
   • キュー サイズ: サンプリング データを発行前に保持するキューの深さ。

資産にイベントを一括で追加する

CSV ファイルから一度に最大 1000 個の OPC UA イベントをインポートできます。

資産から CSV ファイルにすべてのイベントをエクスポートするには、[すべてエクスポート] を選択し、ファイルの場所を選択します。

[イベント] ページで、[次へ] を選択して [レビュー] ページに移動します。

変更の確認

資産と OPC UA タグおよびイベントの詳細を確認し、必要な調整を行います。

Azure CLI を使用して資産を作成する場合は、--event パラメータを複数回使用して複数のイベントを定義できます。 --event パラメータの構文は、--data パラメータに似ています。

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --event event_notifier='ns=3;s=FastUInt12', name=warning

定義するイベントごとに、次を指定できます。

• イベント通知。 この値は、OPC UA サーバーからのイベント通知です。
• イベント名。 この値は、イベントに使用するフレンドリ名です。 イベント名を指定しない場合は、イベント名としてイベント通知が使用されます。
• 監視モード。
• キュー サイズ。

前に作成した資産を検索して選択します。 [資産の詳細]、[タグ]、[イベント] の各タブを使用して、変更を加えます。

[タグ] タブでは、タグの追加、既存のタグの更新、タグの削除を行うことができます。

タグを更新するには、既存のタグを選択し、タグ情報を更新します。 次に、[更新] を選択します。

タグを削除するには、1 つ以上のタグを選択し、[タグの削除] を選択します。

イベントとプロパティの追加、更新、削除も同じ方法で行うことができます。

変更が完了したら、[保存] を選択して変更を保存します。

資産の一覧を表示するには、次のコマンドを使用します。

az iot ops asset query -g {your resource group name}

サーモスタット資産の詳細を表示するには、次のコマンドを使用します。

az iot ops asset show --name thermostat -g {your resource group}

資産を更新するには、az iot ops asset update コマンドを使用します。 たとえば、資産の説明を更新するには、次の例のようなコマンドを使用します。

az iot ops asset update --name thermostat --description 'A simulated thermostat asset' -g {your resource group}

サーモスタット資産のタグの一覧を表示するには、次のコマンドを使用します。

az iot ops asset data-point list --asset thermostat -g {your resource group}

サーモスタット資産のイベントの一覧を表示するには、次のコマンドを使用します。

az iot ops asset event list --asset thermostat -g {your resource group}

サーモスタット資産に新しいタグを追加するには、次の例のようなコマンドを使用します。

az iot ops asset data-point add --asset thermostat -g {your resource group} --data-source 'ns=3;s=FastUInt1002' --name 'humidity'

タグを削除するには、az iot ops asset data-point remove コマンドを使用します。

az iot ops asset event コマンドを使用して、資産のイベントを管理できます。

資産を削除するには、削除する資産を選択します。 [資産の詳細] ページで、[削除] を選択します。 変更を確認して資産を削除します。

資産を削除するには、次の例のようなコマンドを使用します。

az iot ops asset delete --name thermostat -g {your resource group name}