リソースを追加し、ネットワークアナライザの設定を更新する - AWS IoT Core

リソースを追加し、ネットワークアナライザの設定を更新する

トレースメッセージングをアクティブ化する前に、ネットワークアナライザ設定にモニタリングするリソースを追加する必要があります。リソースには、LoRaWAN デバイス、LoRaWAN ゲートウェイ、またはマルチキャストグループがあります。

前提条件

リソースを追加する前に、次の操作を行います。

  1. モニタリングするゲートウェイとデバイスをオンボーディングし、モニタリングするマルチキャストグループを AWS IoT Core for LoRaWAN に追加しておく必要があります。詳細については、「AWS IoT Core for LoRaWAN へのゲートウェイとデバイスの接続」を参照してください。

  2. リソースの追加先となるネットワークアナライザ設定を作成しておく必要があります。詳細については、「ネットワークアナライザの設定を作成する」を参照してください。

コンソールを使用してリソースを追加し、構成設定を更新する

リソースを追加し、オプションパラメータをカスタマイズするには、AWS IoT コンソールまたは AWS IoT Wireless API を使用します。リソースに加えて、設定を編集し、更新された設定を保存することもできます。

設定にリソースを追加する
  1. AWS IoT コンソールのネットワークアナライザハブに移動し、削除する設定を選択します。

  2. [Actions] (アクション) を選択し、[Add resources] (リソースの追加) を選択します。

  3. ワイヤレスゲートウェイとワイヤレスデバイス ID を使用して、モニタリングするリソースを追加します。複数のリソースを選択でき、最大 250 のワイヤレスゲートウェイまたはワイヤレスデバイスを追加できます。

  4. すべてのリソースを追加したら、[Add] (追加) をクリックします。

追加したゲートウェイとデバイスの数が[Network Analyzer] (ネットワークアナライザ) ハブページ に表示されます。トレースメッセージングセッションをアクティブ化するまで、リソースの追加と削除を続けることができます。セッションをアクティブ化した後、リソースを追加するには、セッションを非アクティブ化する必要があります。

構成設定を更新する
  1. AWS IoT コンソールのネットワークアナライザハブを開き、構成を更新する設定を選択します。

  2. [Actions] (アクション) を選択して、[Edit] (編集) を選択します。

  3. フレーム情報を無効にするかどうかを選択し、[Select log levels](ログレベルの選択) を使用して、トレースメッセージログに使用するログレベルを選択します。[Save (保存)] を選択します。

    ネットワークアナライザの設定の詳細ページで指定した設定が表示されます。

API を使用してリソースを追加し、構成設定を更新する

リソースを追加するか、構成設定を更新するには、UpdateNetworkAnalyzerConfiguration API または update-network-analyzer-configuration CLI を使用します。

注記

UpdateNetworkAnalyzerConfiguration API オペレーションを使用してリソースを追加または更新する場合、各 API リクエストに対して指定できるワイヤレスリソースは最大 99 個です。単一のネットワークアナライザー構成では、最大 250 台のワイヤレスデバイスと 250 台のワイヤレスゲートウェイを組み合わせることができます。リソースを追加するには、上記のセクションで説明しているように AWS IoT コンソールを使用します。

  • 構成設定を更新する

    構成設定を更新するには、TraceContent パラメータを使用して、ログレベルとフレーム情報を有効にするかどうかを指定します。例えば、次のコマンドは、フレーム情報を無効にし、ログレベルを ERROR に設定して、構成設定を更新します。

    aws iotwireless update-network-analyzer-configuration \ --configuration-name NetworkAnalyzerConfig_Default \ --trace-content WirelessDeviceFrameInfo=DISABLED,LogLevel="ERROR"
  • リソースを追加する

    リソースを追加するには、WirelessDevicesToAddWirelessGatewaysToAddMulticastGroupsToAdd パラメータを使用して、設定に追加するゲートウェイ、デバイス、マルチキャストグループを指定します。例えば、次のコマンドは、設定を更新し、WirelessGatewayIdWirelessDeviceIdMulticastGroupId で指定されたワイヤレスリソースを設定に追加します。

    aws iotwireless update-network-analyzer-configuration \ --configuration-name NetworkAnalyzerConfig_Default \ --trace-content WirelessDeviceFrameInfo=DISABLED,LogLevel="ERROR" \ --wireless-gateways-to-add "12345678-a1b2-3c45-67d8-e90fa1b2c34d" "90123456-de1f-2b3b-4c5c-bb1112223cd1" --wireless-devices-to-add "1ffd32c8-8130-4194-96df-622f072a315f" \ --multicast-groups-to-add "12abd34e-5f67-89c2-9293-593b1bd862e0"

    デバイスまたはゲートウェイを削除するには、API の WirelessDevicesToRemoveWirelessGatewaysToRemoveMulticastGroupsToRemove パラメータを使用します。

設定に関する情報を取得する

UpdateNetworkAnalyzerConfiguration API を実行しても、出力は生成されません。追加した構成設定とゲートウェイやデバイスに関する表示するには、GetNetworkAnalyzerConfiguration API オペレーション、または get-network-analyzer-configuration コマンドを使用します。ネットワークアナライザ設定の名前を入力として指定します。

aws iotwireless get-network-analyzer-configuration \ --configuration-name NetworkAnalyzerConfig_Default

このコマンドを実行すると、以下の出力が生成されます。

{ "TraceContent": { "WirelessDeviceFrameInfo": "DISABLED", "LogLevel": "ERROR" }, "WirelessDevices": [], "WirelessGateways": [ "a0dd70e5-8f15-41a5-89cf-310284e691a1", "41682155-de4f-4f8f-84bf-bb5557221fc8" ] }

次のステップ

リソースを追加し、オプションの設定を指定したので、WebSocket プロトコルを使用して、AWS IoT Core for LoRaWAN との接続を確立し、ネットワークアナライザを使用できるようになります。その後、トレースメッセージをアクティブにして、リソースのトレースメッセージの受信を開始できます。詳細については、「WebSockets を使用してネットワークアナライザのトレースメッセージをストリーミングする」を参照してください。