

# 新增資源並更新網路分析器組態
<a name="network-analyzer-resources"></a>

必須先將資源新增至組態，才能啟動追蹤訊息。您只能使用一個預設網路分析器組態。AWS IoT Core for LoRaWAN 會將名稱 **NetworkAnalyzerConfig\$1Default** 指派給此組態，且此欄位無法編輯。在從主控台使用網路分析器時，此組態會自動新增至您的 AWS 帳戶。

您可以新增想要監控的資源至此預設組態。資源可以是 LoRaWAN 裝置和 LoRaWAN 閘道。若要將每個資源新增至組態，請使用無線閘道和無線裝置識別碼。

## 組態設定
<a name="resources-config-settings"></a>

若要進行設定，請先將資源新增至預設組態，然後啟用追蹤訊息。收到追蹤訊息日誌之後，您也可以自訂下列參數，以更新預設組態並篩選日誌串流。
+ 

**框架資訊**  
此設定是追蹤訊息用無線裝置資源的框架資訊。框架資訊預設為啟用，可用來偵錯網路伺服器與終端裝置之間的通訊。
+ 

**日誌層級**  
您可以檢視 Info (資訊) 或 Error (錯誤) 日誌，也可以關閉記錄功能。
  + 

**Info**  
日誌層級為 **Info** (資訊) 的日誌更詳細，並且包含資訊豐富且提供錯誤的日誌串流。資訊豐富的日誌可用來檢視裝置或閘道狀態的變更。
**注意**  
收集更詳細的日誌串流會產生額外的成本。如需定價的詳細資訊，請參閱 [AWS IoT Core 定價](https://aws.amazon.com/iot-core/pricing/)。
  + 

**錯誤**  
日誌層級為 **Error** (錯誤) 的日誌不夠詳細且只會顯示錯誤資訊。當應用程式發生錯誤 (例如裝置連線錯誤) 時，您就可以使用這些日誌。藉由使用來自日誌串流的資訊，您可以識別並排解機群中資源的錯誤。

## 必要條件
<a name="resources-prereq"></a>

在新增資源之前，您必須先將想監控的閘道和裝置加入 AWS IoT Core for LoRaWAN。如需詳細資訊，請參閱[將閘道和裝置連接至 AWS IoT Core for LoRaWAN](lorawan-getting-started.md)。

## 新增資源並使用主控台更新網路分析器組態
<a name="add-resources-console"></a>

您可以新增資源，並使用 AWS IoT 主控台或 AWS IoT Wireless API 自訂選用參數。除了資源之外，您還可以編輯組態設定並儲存更新的組態。

**新增資源到組態 (主控台)**  


1. 開啟 [AWS IoT 主控台的網路分析器中樞](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer)，然後選擇網路分析器組態 **NetworkAnalyzerConfig\$1Default**。

1. 選擇 **Add resource** (新增資源)。

1. 使用無線閘道和無線裝置識別碼新增要監控的資源。您最多可以新增 250 個無線閘道或無線裝置。若要新增資源：

   1. 使用 **View gateways** (檢視閘道) 或 **View device** (檢視裝置) 索引標籤，查看已新增至 AWS 帳戶 的閘道和裝置清單。

   1. 複製想要監控的裝置或閘道的 `WirelessDeviceID` 或 `WirelessGatewayID`，然後輸入對應資源的識別碼值。

   1. 若要繼續新增資源，請選擇 **Add gateway** (新增閘道) 或 **Add device** (新增裝置)，然後新增無線閘道或裝置。如果不再想要監控新增的資源，請選擇 **Remove resource** (移除資源)。

1. 新增所有資源之後，請選擇 **Add** (新增)。

   您會在**網路分析器中樞頁面**中看到新增的閘道和裝置數目。您仍然可以繼續新增閘道和裝置，直到啟用追蹤訊息工作階段為止。啟動工作階段之後，若要新增資源，則必須停用工作階段。

**編輯網路分析器組態 (主控台)**  
您也可以編輯網路分析器組態，並選擇是否要停用追蹤訊息日誌的框架資訊和日誌層級。

1. 開啟 [AWS IoT 主控台的網路分析器中樞](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer)，然後選擇網路分析器組態 **NetworkAnalyzerConfig\$1Default**。

1. 選擇 **Edit** (編輯)。

1. 選擇是否停用框架資訊並使用 **Selelct log levels** (選取日誌層級)，以此選擇要用於追蹤訊息的日誌層級。選擇 **Save** (儲存)。

   您會在網路分析器組態的詳細資訊頁面中看到自己指定的組態設定。

## 新增資源並使用 API 更新網路分析器組態
<a name="network-analyzer-add-resources-api"></a>

您可以使用 [AWS IoT Wireless API 操作](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/)或 [AWS IoT Wireless CLI 命令](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html)來新增資源並更新網路分析器組態的組態設定。
+ 若要新增資源並更新網路分析器組態，請使用 [UpdateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) API 或 [update-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-network-analyzer-configuration.html) 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](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) API 操作或 [get-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-network-analyzer-configuration.html) 命令。提供網路分析器組態的名稱 `NetworkAnalyzerConfig_Default` 作為輸入。

## 後續步驟
<a name="network-analyzer-resources-next"></a>

您已新增資源並為組態指定任何選用組態設定，接下來可以使用 WebSocket 通訊協定建立與 AWS IoT Core for LoRaWAN 的連線以使用網路分析器。然後，您可以啟用追蹤訊息並開始接收資源的追蹤訊息。如需詳細資訊，請參閱[串流網路分析器使用 WebSocket 追蹤消息](network-analyzer-api.md)。