# 네트워크 분석기 추적 메시지 로그 실시간 보기 및 모니터링
<a name="network-analyzer-logs"></a>

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

## 필수 조건
<a name="network-analyzer-logs-prereq"></a>

네트워크 분석기를 사용하여 추적 메시징을 활성화하려면 먼저 다음을 수행해야 합니다.
+ 이 기본 네트워크 분석기 구성에 모니터링할 리소스를 추가합니다. 자세한 내용은 [리소스 추가 및 네트워크 분석기 구성 업데이트](network-analyzer-resources.md) 단원을 참조하십시오.
+ `StartNetworkAnalyzerStream` 요청 URL을 사용하여 미리 서명된 요청을 생성합니다. 이 요청을 하는 AWS Identity and Access Management 역할의 자격 증명을 사용하여 요청이 서명됩니다. 자세한 내용은 [미리 서명된 URL 생성](network-analyzer-generate-request.md#network-analyzer-presigned-url) 단원을 참조하십시오.

## 콘솔을 사용하여 추적 메시지 활성화
<a name="network-analyzer-activate-console"></a>

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

1. [AWS IoT 콘솔의 네트워크 분석기 허브](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer)를 열고 네트워크 분석기 구성인 **NetworkAnalyzerConfig\$1Default**를 선택합니다.

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

   최신 추적 메시지가 콘솔에서 가장 먼저 나타나는 추적 메시지 수신을 시작합니다.
**참고**  
메시징 세션이 시작된 후 추적 메시지를 수신하면 세션을 비활성화하거나 추적 세션에서 나갈 때까지 추가 비용이 발생할 수 있습니다. 요금에 대한 자세한 내용은 [AWS IoT Core 요금](https://aws.amazon.com/iot-core/pricing/)을 참조하십시오.

## 추적 메시지 보기 및 모니터링
<a name="network-analyzer-view-trace"></a>

추적 메시징을 활성화하면 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\$1Data**, **Downlink\$1Data** 또는 **등록(Registration)**일 수 있습니다.
+ **로그 수준(Log level)**: 디바이스의 `INFO` 또는 `ERROR` 로그 스트림에 대한 정보입니다.

## 네트워크 분석기 JSON 로그 메시지
<a name="connect-iot-network-analyzer-trace-logs"></a>

한 번에 하나의 추적 메시지를 선택하여 해당 메시지에 대한 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;
  },
};
```

## 검토 및 다음 단계
<a name="network-analyzer-review"></a>

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

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

**구성에 대한 프레임 정보 편집**  
네트워크 분석기 구성을 편집하고 프레임 정보를 비활성화할지 여부를 선택하고 메시지의 로그 수준을 선택할 수 있습니다. 구성을 업데이트하기 전에 추적 메시징 세션을 비활성화하는 것이 좋습니다. 이렇게 편집하려면 [AWS IoT 콘솔의 네트워크 분석기 세부 정보 페이지](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer/details/NetworkAnalyzerConfig_Default)를 열고 **편집(Edit)**을 선택합니다. 그런 다음 새 구성 설정으로 구성을 업데이트하고 추적 메시징을 활성화하여 업데이트된 메시지를 볼 수 있습니다.
+ 

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

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