# 即時檢視並監控網路分析器追蹤訊息日誌
<a name="network-analyzer-logs"></a>

如果已將資源新增至網路分析器組態，則可以啟動追蹤訊息，開始接收資源的追蹤訊息。您可以使用 AWS 管理主控台、AWS IoT Wireless 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** (訊息編號)：唯一的編號，可顯示最先收到的最新訊息。
+ **Resource ID** (資源 ID)：資源的無線閘道或無線裝置 ID。
+ **Timestamp** (時間戳記)：收到訊息的時間。
+ **訊息 ID**：AWS IoT Core for LoRaWAN 指派給每則收到的訊息的識別符。
+ **FPort**：使用 WebSocket 連線與裝置通訊的頻率連接埠。
+ **DevEui**：無線裝置的延伸唯一識別碼 (EUI)。
+ **Resource** (資源)：不論受監控的資源是無線裝置或無線閘道都一樣。
+ **Event** (事件)：無線裝置日誌訊息的事件，可以是 **Join** (加入)、**Rejoin** (重新加入)、**Uplink\$1Data**、**Downlink\$1Data** 或 **Registration** (註冊)。
+ **Log level** (日誌層級)：裝置 `INFO` 或 `ERROR` 日誌串流的相關資訊。

## 網絡分析器 JSON 日誌訊息
<a name="connect-iot-network-analyzer-trace-logs"></a>

您也可以一次選擇一個追蹤訊息，以檢視該訊息的 JSON 承載。根據您在追蹤訊息日誌中選取的訊息，您會在 JSON 承載中看到表示包含 2 個部分的資訊：**CustomerLog** 和 **LoRaFrame**。

**CustomerLog**  
JSON 的 **CustomerLog** 部分會顯示接收訊息的資源類型和識別碼、日誌層級以及訊息內容。下列範例展示 **CustomerLog** 日誌訊息。您可以使用 JSON 中的 `message` 欄位取得有關錯誤以及如何解決錯誤的詳細資訊。

**LoRaFrame**  
JSON 的 **LoRaFrame** 部分具有 **Message ID** (訊息 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)。