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

トレースメッセージングをアクティブ化する前に、設定にリソースを追加する必要があります。使用できるデフォルトのネットワークアナライザ設定は 1 つだけです。AWS IoT Core for LoRaWAN によって、NetworkAnalyzerConfig_Default という名前がこの設定に割り当てられます。このフィールドは編集できません。この設定は、コンソールからネットワークアナライザを使用する場合、自動的に AWS アカウント に追加されます。

このデフォルト設定に、モニタリングするリソースを追加できます。リソースは、LoRaWAN デバイスと LoRaWAN ゲートウェイのいずれかまたは両方にすることができます。設定に個々のリソースを追加するには、ワイヤレスゲートウェイとワイヤレスデバイス ID を使用します。

設定

設定をするには、まずデフォルト設定にリソースを追加し、トレースメッセージングをアクティブにします。トレースメッセージログを受信したら、次のパラメータをカスタマイズしてデフォルト設定を更新し、ログストリームをフィルタリングすることもできます。

• フレーム情報

  この設定は、トレースメッセージのワイヤレスデバイスリソースのフレーム情報です。フレーム情報はデフォルトで有効になっており、ネットワークサーバーとエンドデバイス間の通信のデバッグに使用できます。

• ログレベル

  情報ログまたはエラーログを表示したり、ログ記録をオフにしたりできます。

  • 情報

    ログレベルが Info のログは冗長性が高く、情報を提供しエラーを含むログストリームを含んでいます。情報ログは、デバイスまたはゲートウェイの状態の変更を表示するために使用できます。

    注記

    冗長性が高いログストリームを収集すると、追加コストが発生する可能性があります。料金の詳細については、「AWS IoT Core の料金」を参照してください。

  • エラー

    ログレベルが Error のログは冗長性が低く、エラー情報のみを表示します。これらのログは、アプリケーションにデバイス接続エラーなどのエラーがあるときに使用できます。ログストリームの情報を使用して、フリート内のリソースのエラーを特定し、トラブルシューティングできます。

前提条件

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

コンソールを使用して、リソースを追加し、ネットワークアナライザ設定を更新する

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

設定にリソースを追加するには (コンソール)

1. AWS IoT コンソールの [Network Analyzer] (ネットワークアナライザ) ハブを開き、ネットワークアナライザの設定 NetworkAnalyzerConfig_Default を選択します。

2. [Add resources] (リソースを追加) を選択します。

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

   1. [View gateways] (ゲートウェイを表示) または [View devices] (デバイスを表示) タブを使用して、AWS アカウント に追加したゲートウェイとデバイスのリストを表示します。

   2. モニタリングするデバイスまたはゲートウェイの WirelessDeviceID または WirelessGatewayID をコピーし、対応するリソースの識別子の値を入力します。

   3. リソースの追加を続行するには、[Add gateway] (ゲートウェイを追加) または [Add device] (デバイスを追加) を選択し、ワイヤレスゲートウェイまたはデバイスを追加します。追加していたリソースをモニタリングする必要がなくなった場合は、[Remove resource] (リソースを削除) を選択します。

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

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

ネットワークアナライザの設定を編集するには (コンソール)

ネットワークアナライザの設定を編集して、トレースメッセージログのフレーム情報を無効にするかどうかとそのログレベルを選択することもできます。

1. AWS IoT コンソールの [Network Analyzer] (ネットワークアナライザ) ハブを開き、ネットワークアナライザの設定 NetworkAnalyzerConfig_Default を選択します。

2. [編集] を選択します。

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

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

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

AWS IoT Wireless API オペレーションまたはAWS IoT Wireless CLI コマンドを使用して、リソースを追加し、ネットワークアナライザの設定を更新します。

• リソースを追加し、ネットワークアナライザの設定を更新するには、UpdateNetworkAnalyzerConfiguration API または update-network-analyzer-configuration CLI を使用します。

  • リソースを追加する

    追加するワイヤレスデバイスについては、WirelessDevicesToAdd を使用してデバイスの WirelessDeviceID を文字列の配列として入力します。追加するワイヤレスゲートウェイについては、WirelessGatewaysToAdd を使用してゲートウェイの WirelessGatewayID　を文字列の配列として入力します。

  • 設定を編集する

    ネットワークアナライザの設定を編集するには、TraceContent パラメータを使用して、WirelessDeviceFrameInfo を ENABLED にするか DISABLED にするか、および LogLevel パラメータを INFO、ERROR、DISABLED のいずれにするかを指定します。

  {
     "TraceContent": { 
        "LogLevel": "string",
        "WirelessDeviceFrameInfo": "string"
     },
     "WirelessDevicesToAdd": [ "string" ],
     "WirelessDevicesToRemove": [ "string" ],
     "WirelessGatewaysToAdd": [ "string" ],
     "WirelessGatewaysToRemove": [ "string" ]
  }

• 追加した設定とリソースに関する情報を取得するには、GetNetworkAnalyzerConfiguration API オペレーション、または get-network-analyzer-configuration コマンドを使用します。ネットワークアナライザ設定 NetworkAnalyzerConfig_Default の名前を入力として指定します。

次のステップ

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