네트워크 분석기 추적 메시지 로그 실시간 보기 및 모니터링 - AWS IoT Wireless
필수 조건콘솔을 사용하여 추적 메시지 활성화추적 메시지 보기 및 모니터링네트워크 분석기 JSON 로그 메시지검토 및 다음 단계

네트워크 분석기 추적 메시지 로그 실시간 보기 및 모니터링

네트워크 분석기 구성에 리소스를 추가한 경우 추적 메시징을 활성화하여 리소스에 대한 추적 메시지 수신을 시작할 수 있습니다. AWS Management Console, AWS IoT 무선 API 또는 AWS CLI를 사용할 수 있습니다.

필수 조건

네트워크 분석기를 사용하여 추적 메시징을 활성화하려면 먼저 다음을 수행해야 합니다.

  • 이 기본 네트워크 분석기 구성에 모니터링할 리소스를 추가합니다. 자세한 내용은 리소스 추가 및 네트워크 분석기 구성 업데이트 단원을 참조하십시오.

  • StartNetworkAnalyzerStream 요청 URL을 사용하여 미리 서명된 요청을 생성합니다. 이 요청을 하는 AWS Identity and Access Management 역할의 자격 증명을 사용하여 요청이 서명됩니다. 자세한 내용은 미리 서명된 URL 생성 단원을 참조하십시오.

콘솔을 사용하여 추적 메시지 활성화

추적 메시징을 활성화하려면

  1. AWS IoT 콘솔의 네트워크 분석기 허브를 열고 네트워크 분석기 구성인 NetworkAnalyzerConfig_Default를 선택합니다.

  2. 네트워크 분석기 구성의 세부 정보 페이지에서 추적 메시징 활성화(Activate trace messaging)를 선택한 다음 활성화(Activate)를 선택합니다.

    최신 추적 메시지가 콘솔에서 가장 먼저 나타나는 추적 메시지 수신을 시작합니다.

    참고

    메시징 세션이 시작된 후 추적 메시지를 수신하면 세션을 비활성화하거나 추적 세션에서 나갈 때까지 추가 비용이 발생할 수 있습니다. 요금에 대한 자세한 내용은 AWS IoT Core 요금을 참조하십시오.

추적 메시지 보기 및 모니터링

추적 메시징을 활성화하면 WebSocket 연결이 설정되고 추적 메시지가 실시간으로 최신 항목부터 나타나기 시작합니다. 각 페이지에 표시할 추적 메시지 수를 지정하고 각 메시지에 대한 관련 필드만 표시하도록 기본 설정을 사용자 지정할 수 있습니다. 예를 들어, 로그 수준(Log level)이 ERROR로 설정된 무선 게이트웨이 리소스에 대한 로그만 표시하도록 추적 메시지 로그를 사용자 지정할 수 있으므로 게이트웨이의 오류를 빠르게 식별하고 디버그할 수 있습니다. 추적 정보 메시지에는 다음 정보가 포함됩니다.

  • 메시지 번호(Message Number): 가장 먼저 수신된 마지막 메시지를 표시하는 고유 번호입니다.

  • 리소스 ID(Resource ID): 리소스의 무선 게이트웨이 또는 무선 디바이스 ID입니다.

  • 타임스탬프(Timestamp): 메시지가 수신된 시간입니다.

  • 메시지 ID: AWS IoT Core for LoRaWAN이 수신된 각 메시지에 할당하는 식별자입니다.

  • FPort: WebSocket 연결을 사용하여 디바이스와 통신하기 위한 주파수 포트입니다.

  • DevEui: 무선 디바이스의 확장 고유 식별자(EUI)입니다.

  • 리소스(Resource): 모니터링되는 리소스가 무선 디바이스인지 또는 무선 게이트웨이인지 여부입니다.

  • 이벤트: 무선 디바이스에 대한 로그 메시지의 이벤트로 조인(Join), 리조인(Rejoin), Uplink_Data, Downlink_Data 또는 등록(Registration)일 수 있습니다.

  • 로그 수준(Log level): 디바이스의 INFO 또는 ERROR 로그 스트림에 대한 정보입니다.

네트워크 분석기 JSON 로그 메시지

한 번에 하나의 추적 메시지를 선택하여 해당 메시지에 대한 JSON 페이로드를 볼 수도 있습니다. 추적 메시지 로그에서 선택한 메시지에 따라 CustomerLog 및 LoRaFrame의 두 부분이 포함되어 있음을 나타내는 정보가 JSON 페이로드에 표시됩니다.

CustomerLog

JSON의 CustomerLog 부분은 메시지를 수신한 리소스의 유형 및 식별자, 로그 수준 및 메시지 내용을 표시합니다. 다음 예제에서는 CustomerLog 로그 메시지를 보여줍니다. JSON의 message 필드를 사용하여 오류 및 해결 방법에 대한 자세한 정보를 얻을 수 있습니다.

LoRaFrame

JSON의 LoRaFrame 부분에는 메시지 ID(Message 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;
  },
};

검토 및 다음 단계

이 섹션에서는 추적 메시지를 보고 정보를 사용하여 오류를 디버깅하는 방법을 배웠습니다. 모든 메시지를 본 후 다음 작업을 수행할 수 있습니다.

  • 추적 메시징 비활성화

    추가 비용이 발생하지 않도록 네트워크 분석기 추적 메시징 세션을 비활성화할 수 있습니다. 세션을 비활성화하면 WebSocket 연결이 끊어지므로 추가 추적 메시지가 수신되지 않습니다. 콘솔에서 기존 메시지를 계속 볼 수 있습니다.

  • 구성에 대한 프레임 정보 편집

    네트워크 분석기 구성을 편집하고 프레임 정보를 비활성화할지 여부를 선택하고 메시지의 로그 수준을 선택할 수 있습니다. 구성을 업데이트하기 전에 추적 메시징 세션을 비활성화하는 것이 좋습니다. 이렇게 편집하려면 AWS IoT 콘솔의 네트워크 분석기 세부 정보 페이지를 열고 편집(Edit)을 선택합니다. 그런 다음 새 구성 설정으로 구성을 업데이트하고 추적 메시징을 활성화하여 업데이트된 메시지를 볼 수 있습니다.

  • 구성에 리소스 추가

    또한 더 많은 리소스를 추가하고 네트워크 분석기 구성에 실시간으로 모니터링할 수 있습니다. 총 250개의 무선 게이트웨이 및 무선 디바이스 리소스를 결합하여 추가할 수 있습니다. 리소스를 추가하려면 AWS IoT 콘솔의 네트워크 분석기 세부 정보 페이지에서 리소스(Resources) 탭을 선택하고 리소스 추가(Add resources)를 선택합니다. 그런 다음 새 리소스로 구성을 업데이트하고 추적 메시징을 활성화하여 추가 리소스에 대한 업데이트된 메시지를 볼 수 있습니다.

구성 설정을 편집하고 리소스를 추가하여 네트워크 분석기 구성을 업데이트하는 방법에 대한 자세한 내용은 리소스 추가 및 네트워크 분석기 구성 업데이트 섹션을 참조하세요.