Oracle Cloud Infrastructureドキュメント

IoTフロー・ランタイムの作成

IoTドメインにIoTフロー・ランタイムを作成します。

管理対象ノード-REDフロー・ランタイムを作成し、オプションでそのスケール、サービス・ログ、ネットワーク構成およびファイル・ストレージ・マウントを定義します。

フロー・ランタイムのロギングはオプションです。ロギングを構成する前に、管理者は該当するフロー・ランタイム・ロギング・ポリシーを作成する必要があります。既存のログには、read log-groupsおよびuse log-contentが必要です。OCI IoTでログを自動的に作成するようにログ・グループのみを指定する場合は、manage log-groupsおよびuse log-contentを付与します。

ファイル・ストレージ・マウントを構成する前に、IoTフロー・ランタイムのファイル・ストレージ・アクセスの構成のエクスポートおよびネットワークの前提条件を完了してください。
重要

ファイル・ストレージ・マウントのフロー・ランタイムがアクティブ化に失敗した場合は、ファイル・ストレージ・マウントのフロー・ランタイムがアクティブ化に失敗することがありますの既知の問題を参照してください。
    1. 「IoTドメイン」リスト・ページで、フロー・ランタイムを作成するドメインを選択し、「フロー・ランタイム」を選択します。IoTドメイン・リスト・ページの検索に関するヘルプが必要な場合は、IoTドメインのリストを参照してください。
    2. 「フロー・ランタイムの作成」を選択します。
    3. 名前を入力し、オプションで説明を入力し、コンパートメントを選択します。機密情報を入力しないでください。
    4. 「スケール」を選択します。後でスケールを変更できます。
    5. オプションで、次のいずれかのオプションを使用して「ロギングの構成」をオンにします。
      • 既存のログの使用: ログ・グループと既存のログを選択または入力します。
      • ログの自動作成: ログ・グループのみを選択または入力します。アクティブな各フロー・ランタイムは、新しいログに書き込みます。
    6. 「ネットワーク・アクセスの構成」をオンにして、サブネットおよび最大5つのネットワーク・セキュリティ・グループを選択します。
    7. オプションで、ファイル・ストレージ・マウントの構成をオンにします。「ファイル・システム・エクスポート・コンパートメント」および「ファイル・システム・エクスポート」を選択します。「マウント・パス」に、先頭または末尾のスラッシュまたはパス・トラバース・セグメントを含まない相対パスを入力します。別のエクスポートを構成するには、「ファイル・ストレージ・マウントの追加」を選択します(最大5つ)。

      コンソールに、/mnt/が固定された編集不可能な接頭辞として表示されます。たとえば、/mnt/my-shareでエクスポートを使用可能にするには、my-shareと入力します。

    8. 「作成」を選択します。

      フロー・ランタイムの作成後、その詳細ページを開き、「モニタリング」タブを選択して次のチャートを表示します:

      • フロー・ランタイムCPU使用率
      • フロー・ランタイム・メモリー使用率
      • フロー・ランタイム・ネットワーク受信バイト数
      • フロー・ランタイム・ネットワーク送信バイト数

      各チャートについて、メトリック・エクスプローラで問合せを表示したり、チャートURLをコピーしたり、MQLをコピーしたり、問合せにアラームを作成したりできます。

      詳細は、IoTフロー・ランタイム・メトリック・チャートおよびIoTフロー・ランタイム・メトリックを参照してください。モニタリング・サービスからメトリックを表示したり、問合せのMQL式の編集を参照することもできます。

  • oci iot flow-runtime createコマンドを使用します。IoTドメインおよびコンパートメントOCIDsが必要です。

    既存のログを使用するには、次の内容をlog-config.jsonとして保存します。

    {
  "logGroupId": "<log-group-OCID>",
  "logId": "<log-OCID>"
}

    ログを自動的に作成するには、logIdを省略します。

    {
  "logGroupId": "<log-group-OCID>"
}

    --log-configを使用する場合、ログ・グループのOCIDは必須で、ログのOCIDはオプションです。

    oci iot flow-runtime create \
  --iot-domain-id <iot-domain-OCID> \
  --compartment-id <compartment-OCID> \
  --display-name <display-name> \
  --scale MEDIUM \
  --log-config file://log-config.json \
  --network-config file://network-config.json

    ロギングを構成しない場合は、--log-configを省略します。ランタイムに顧客のVCNアタッチメントが必要ない場合は、--network-configを省略します。説明、フリーフォーム・タグおよび定義済タグを指定することもできます。ロギングの前提条件および自動ログ作成ポリシーについては、シナリオ: IoTフロー・ランタイムのログの構成を参照してください。

    すべてのオプションについては、CLIコマンド・リファレンスを参照してください。

  • CreateIotFlowRuntime操作を実行して、IoTフロー・ランタイムを作成します。

    IoTフロー・ランタイムOCIDでは、次の形式が使用されます。

    ocid1.iotflowruntime.oc1.<region>.exampleUniqueID
    POST /20250531/iotFlowRuntimes
{
  "compartmentId": "ocid1.compartment.oc1..exampleuniqueID",
  "iotDomainId": "ocid1.iotdomain.oc1..exampleuniqueID",
  "displayName": "Sample Flow Runtime",
  "scale": "MEDIUM",
  "logConfig": {
    "logGroupId": "ocid1.loggroup.oc1..exampleuniqueID",
    "logId": "ocid1.log.oc1..exampleuniqueID"
  },
  "networkConfig": {
    "subnetId": "ocid1.subnet.oc1..exampleuniqueID",
    "networkSecurityGroupIds": ["ocid1.networksecuritygroup.oc1..exampleuniqueID"],
    "fileStorageMounts": [{
      "mountPath": "history",
      "mountTargetId": "ocid1.mounttarget.oc1..exampleuniqueID",
      "exportId": "ocid1.export.oc1..exampleuniqueID"
    }]
  }
}

    リクエストはCreateIotFlowRuntimeDetailsを使用します。iotDomainIdおよびcompartmentIdが必要です。指定した場合、logConfigにはlogGroupIdが必要です。logIdはオプションです。logIdを省略して、ログを自動的に作成します。指定する場合、networkConfigにはsubnetIdが必要です。相対mountPath値historyは、エクスポートを/mnt/historyで使用できるようにします。ロギングの前提条件および自動ログ作成ポリシーについては、シナリオ: IoTフロー・ランタイムのログの構成を参照してください。