データフロープロファイルを構成する

2025-06-20

重要

このページには、プレビュー段階にある Kubernetes デプロイマニフェストを使用して Azure IoT Operations コンポーネントを管理する手順が含まれます。この機能はいくつかの制限を設けて提供されており、運用環境のワークロードには使用しないでください。

ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用される法律条項については、「Microsoft Azure プレビューの追加使用条件」を参照してください。

データフロープロファイルを使用すると、データフローをグループ化して、同じ構成を共有できます。複数のデータフロープロファイルを作成して、さまざまなデータフロー構成のセットを管理できます。

最も重要な設定は、インスタンス数です。特定のデータフローの場合、インスタンス数によって、クラスターで実行されるコピーの数が決まります。たとえば、開発とテスト用の 1 つのインスタンスを含むデータフロープロファイルと、運用環境用の複数のインスタンスを持つ別のプロファイルがあるとします。または、低スループットのデータフローにはインスタンス数が少ないデータフロープロファイルを使用し、高スループットのデータフローではインスタンス数が多いプロファイルを使用することもできます。同様に、デバッグ目的で異なる診断設定を使用してデータフロープロファイルを作成できます。

既定のデータフロープロファイル

Azure IoT Operations のデプロイ時に 、default という名前のデータフロープロファイルが作成されます。このデータフロープロファイルを使用して、Azure IoT Operations の使用を開始できます。

既定のデータフロープロファイルを表示するには、Azure portal で IoT Operations インスタンスに移動します。
左側のウィンドウの [ コンポーネント] で、[ データフロープロファイル] を選択します。
既定のデータフロープロファイルを選択します。

az iot operations dataflow profile show コマンドを使用して、既定のデータフロープロファイルを表示します。

az iot operations dataflow profile show --resource-group <ResourceGroupName> --instance <AioInstanceName> --name default

既定のデータフロープロファイルを表示するコマンドの例を次に示します。

az iot operations dataflow profile show --resource-group myResourceGroup --instance myAioInstance --name default

param aioInstanceName string = '<AIO_INSTANCE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'

// Pointer to the Azure IoT Operations instance
resource aioInstance 'Microsoft.IoTOperations/instances@2024-11-01' existing = {
  name: aioInstanceName
}

// Pointer to your custom ___location where AIO is deployed
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
  name: customLocationName
}

// Pointer to the default data flow profile
resource defaultDataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2024-11-01' = {
  parent: aioInstance
  name: 'default'
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    instanceCount: 1
  }
}

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowProfile
metadata:
  name: default
  namespace: azure-iot-operations
spec:
  instanceCount: 1

追加のスループットまたは冗長性が必要な場合を除いて、データフローに既定のデータフロープロファイルを使用できます。インスタンス数またはその他の設定を調整する必要がある場合は、新しいデータフロープロファイルを作成できます。

新しいデータフロープロファイルを作成する

新しいデータフロープロファイルを作成するには、プロファイルの名前とインスタンス数を指定します。

重要

データプロファイル名の長さは 1 ~ 39 文字にする必要があります。

Azure portal で、IoT Operations インスタンスに移動します。
左側のウィンドウの [ コンポーネント] で、[ データフロープロファイル] を選択します。
[+ データフロープロファイル] を選択して、新しいデータフロープロファイルを作成します。
[ データフロープロファイルの作成 ] ウィンドウで、データフロープロファイルの名前を入力し、インスタンス数を設定します。診断設定などの他の設定を設定することもできます。

az iot operations dataflow profile create コマンドを使用して、新しいデータフロープロファイルを作成します。

az iot operations dataflow profile create --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <ProfileName>

myDataFlowProfileという名前の新しいデータフロープロファイルを作成するコマンドの例を次に示します。

az iot operations dataflow profile create --resource-group myResourceGroup --instance myAioInstance --name myDataFlowProfile

resource dataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2024-11-01' = {
  parent: aioInstance
  name: '<NAME>'
  properties: {
    instanceCount: <COUNT>
  }
}

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowProfile
metadata:
  name: '<NAME>'
  namespace: azure-iot-operations
spec:
  instanceCount: <COUNT>

スケーリング

データフロープロファイルをスケーリングして、データフローを実行するインスタンスの数を調整できます。特定のデータフローのインスタンス数は、クラスターで実行されるコピーの数です。インスタンス数を増やすと、データを処理する複数のクライアントを作成して、データフローのスループットを向上させることができます。クライアントあたりのレート制限があるクラウドサービスでデータフローを使用するときは、インスタンス数を増やすと、レート制限内に留めるのに役立ちます。

スケーリングでは、障害が発生した場合の冗長性を提供することで、データフローの回復性を向上させることもできます。

データフロープロファイルを手動でスケーリングする場合には、実行するインスタンスの数を指定します。たとえば、インスタンス数を 3 に設定するには、次のようにします。

Azure portal で、IoT Operations インスタンスに移動します。
左側のウィンドウの [ コンポーネント] で、[ データフロープロファイル] を選択します。
構成するデータフロープロファイルを選択します。
スライダーを使用してインスタンス数を設定します。

az iot operations dataflow profile update コマンドを使用して、データフロープロファイルのインスタンス数を更新します。

az iot operations dataflow profile update --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <ProfileName> --profile-instance <InstanceCount>

データフロープロファイルの myDataFlowProfileのインスタンス数を 3 に設定するコマンドの例を次に示します。

az iot operations dataflow profile update --resource-group myResourceGroup --instance myAioInstance --name myDataFlowProfile --profile-instances 3

properties: {
  instanceCount: 3
}

spec:
  instanceCount: 3

診断設定

ログレベルなど、データフロープロファイルの他の診断設定を構成できます。

ほとんどの場合、既定の設定で十分です。ただし、デバッグのためにログレベルまたはその他の設定をオーバーライドできます。

これらの診断設定を構成する方法については、「ProfileDiagnostics」を参照してください。

Azure portal で、IoT Operations インスタンスに移動します。
[ コンポーネント] で、[ データフロープロファイル] を選択します。
構成するデータフロープロファイルを選択します。

az iot operations dataflow profile update コマンドを使用して、データフロープロファイルの診断設定を更新します。

az iot operations dataflow profile update --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <ProfileName> --log-level <level>

データフロープロファイルのdebugのログレベルをmyDataFlowProfileに設定するコマンドの例を次に示します。

az iot operations dataflow profile update --resource-group myResourceGroup --instance myAioInstance --name myDataFlowProfile --log-level debug

resource dataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2024-11-01' = {
  parent: aioInstance
  name: '<NAME>'
  properties: {
    instanceCount: 1
    diagnostics: {
      {
        logs: {
          level: 'debug'
        }
      }
    }
  }
}

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowProfile
metadata:
  name: '<NAME>'
  namespace: azure-iot-operations
spec:
  instanceCount: 1
  diagnostics:
    logs:
      level: debug

次のステップ

データフローの詳細については、データフローの作成に関するページを参照してください。

次の方法で共有

データ フロー プロファイルを構成する

既定のデータ フロー プロファイル

新しいデータ フロー プロファイルを作成する