ネットワークアナライザのトレースメッセージログをリアルタイムで表示およびモニタリングする

ネットワークアナライザの設定にリソースを追加した場合は、トレースメッセージングをアクティブにして、リソースのトレースメッセージの受信を開始できます。AWS Management Console、AWS IoT Wireless API、AWS CLI のいずれかを使用できます。

前提条件

ネットワークアナライザを使用してトレースメッセージングをアクティブ化する前に、次の準備が必要です。

コンソールを使用してトレースメッセージングをアクティブ化する

トレースメッセージングをアクティブにするには

トレースメッセージの表示とモニタリング

トレースメッセージングをアクティブにすると、WebSocket 接続が確立され、トレースメッセージが最新のものからリアルタイムで表示されます。プリファレンスをカスタマイズして、各ページに表示するトレースメッセージの数を指定し、各メッセージの関連するフィールドのみを表示させることができます。例えば、トレースメッセージログをカスタマイズして、ログレベルが ERROR に設定されているワイヤレスゲートウェイリソースのログのみを表示することができます。そうすると、ゲートウェイでエラーをすばやく特定してデバッグできます。トレースメッセージには、次に示す情報が含まれます。

ネットワークアナライザ JSON ログメッセージ

一度に 1 つのトレースメッセージを選択して、そのメッセージの JSON ペイロードを表示することもできます。トレースメッセージログで選択したメッセージに応じて、2 つの部分 (CustomerLog と LoRaFrame) が含まれていることを示す情報が JSON ペイロードに表示されます。

CustomerLog

JSON の CustomerLog 部分には、メッセージを受信したリソースのタイプと識別子、ログレベル、およびメッセージの内容が表示されます。次の例は、CustomerLog ログメッセージの例を示しています。JSON の message フィールドを使用して、エラーとその解決方法に関する詳細情報を取得できます。

LoRaFrame

JSON の LoRaFrame 部分には、メッセージ ID があり、デバイスの物理ペイロードとワイヤレスメタデータに関する情報が含まれています。

次の例に、トレースメッセージの構造を示します。

export type TraceMessage = {
  ResourceId: string;
  Timestamp: string;
  LoRaFrame: 
  {
    MessageId: string;
    PhysicalPayload: any;
    WirelessMetadata: 
    {
      fPort: number;
      dataRate: number;
      devEui: string;
      frequency: number,
      timestamp: string;
    },
  }
  CustomerLog: 
  {
    resource: string;
    wirelessDeviceId: string;
    wirelessDeviceType: string;
    event: string;
    logLevel: string;
    messageId: string;
    message: string;
  },
};

レビューと以降のステップ

このセクションでは、トレースメッセージを表示し、この情報を使用してエラーをデバッグする方法を学習しました。すべてのメッセージを表示したら、次の操作を実行できます。

設定の編集とリソースの追加によるネットワークアナライザ設定の更新の詳細については、「リソースを追加し、ネットワークアナライザの設定を更新する」を参照してください。