# 建立網路分析器組態並新增資源
在串流傳輸追蹤訊息之前，請先建立網路分析器組態，並將要監控的資源加入這個組態。建立組態時，您可以：
+ 指定組態名稱和選用描述。
+ 自訂組態設定，例如框架資訊和日誌訊息的詳細資訊層級。
+ 加入希望監控的資源。資源可以是無線裝置、無線閘道或兩者皆是。
您指定的組態設定會決定您將針對加入組態中的資源接收到的追蹤訊息資訊。您可能也需要建立多個組態，具體取決於您的監控使用案例。
以下說明如何建立組態並新增資源。
**Topics**
+ [建立網路分析器組態](network-analyzer-create.md)
+ [新增資源並更新網路分析器組態](network-analyzer-resources.md)
# 建立網路分析器組態
您必須先建立網路分析器組態，才能監控無線閘道或無線裝置。建立組態時，您只需要指定組態名稱。您可以自訂您的組態設定，並將您想要監控的資源新增至組態，即使組態已建立之後也是如此。組態設定會決定您將針對這些資源接收到的追蹤訊息資訊。
您可能需要建立多個組態，具體取決於要監控的資源以及您希望接收的資訊層級。例如，您可以建立一個組態，僅顯示 AWS 帳戶 中一組閘道的錯誤資訊。您也可以建立一個組態，顯示要監控之無線裝置的所有資訊。
以下部分介紹各種組態設定以及如何建立組態。
## 組態設定
建立或更新網路分析器組態時，您也可以自訂下列參數，以篩選日誌串流資訊。
+
**框架資訊**
這個設定是要追蹤訊息之無線裝置資源的框架資訊。框架資訊可用來偵錯網路伺服器與終端裝置之間的通訊。依預設會啟用此功能。
+
**日誌層級**
您可以檢視 Info (資訊) 或 Error (錯誤) 日誌，也可以關閉記錄功能。
+
**Info**
日誌層級為 **Info** (資訊) 的日誌更詳細，並且同時包含錯誤日誌串流和資訊日誌串流。資訊日誌可用來檢視裝置或閘道狀態的變更。
**注意**
收集更詳細的日誌串流會產生額外的成本。如需定價的詳細資訊，請參閱 [AWS IoT Core 定價](https://aws.amazon.com/iot-core/pricing/)。
+
**錯誤**
日誌層級為 **Error** (錯誤) 的日誌不夠詳細且只會顯示錯誤資訊。當應用程式發生錯誤 (例如裝置連線錯誤) 時，您就可以使用這些日誌。藉由使用來自日誌串流的資訊，您可以識別並排解機群中資源的錯誤。
## 使用主控台建立組態
您可以建立網路分析器組態，並使用 AWS IoT 主控台或 AWS IoT Wireless API 自訂選用參數。您也可以建立多個組態，之後刪除不再使用的任何組態。
**建立網路分析器組態**
1. 開啟 [AWS IoT 主控台的網路分析器中樞](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer)並選擇 **Create configuration** (建立組態)。
1. 指定組態設定
+
**名稱、描述和標籤**
指定一個唯一的**組態名稱**，只能含有字母、數字、連字號或底線。使用選用的 **Description** (描述) 欄位以提供有關組態的資訊，以及 **Tags** (標籤) 欄位加入有關組態之中繼資料的鍵值對。如需有關命名和描述資源的詳細資訊，請參閱 [描述您的 AWS IoT Wireless 資源](iotwireless-describe-resources.md)。
+
**組態設定**
選擇是否停用框架資訊並使用 **Selelct log levels** (選取日誌層級)，以此選擇要用於追蹤訊息的日誌層級。選擇 **Next** (下一步)。
1. 新增資源到組態。您可以立即加入資源，也可以選擇 **Create** (建立)，然後之後加入您的資源。若要之後加入資源，請選擇 **Create** (建立)。
在 **Network Analyzer hub page** (網路分析器中樞頁面)，您會看到您所建立的組態及其設定。若要檢視新組態的詳細資訊，請選擇組態名稱。
**刪除您的網路分析器組態**
您可以建立多個網路分析器組態，具體取決於要監控的資源，以及您希望接收的追蹤訊息資訊層級。
**從主控台中移除組態**
1. 前往 [AWS IoT 主控台的網路分析器中樞](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer)並選擇您要移除的組態。
1. 選擇**動作**，然後選擇**刪除**。
## 使用 API 建立組態
若要使用 API 建立網路分析器組態，請使用 [CreateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateNetworkAnalyzerConfiguration.html) API 操作或 [create-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-network-analyzer-configuration.html) CLI 命令。
建立組態時，您只需要指定組態名稱。您也可以使用此 API 操作指定組態設定，並在建立組態時加入資源。或者，您可以稍後使用 [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 命令。
+
**建立組態**
建立組態時，您必須指定名稱。例如，下列命令只提供名稱和選用描述來建立組態。預設情況下，組態已啟用框架資訊，並使用 `INFO` 日誌層級。
```
aws iotwireless create-network-analyzer-configuration \
--configuration-name My_Network_Analyzer_Config \
--description "My first network analyzer configuration"
```
執行這個命令會顯示網路分析器組態的 ARN 和 ID。
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
```
+
**使用資源建立組態**
若要自訂組態設定，請使用`trace-content` 參數。若要新增資源，請使用 `WirelessDevices` 和 `WirelessGateways` 參數指定您要新增至組態的閘道、裝置或者兩者。例如，以下命令可自訂組態設定，並將無線資源加入您的組態，這些資源由其 `WirelessGatewayID` 和 `WirelessDeviceID` 指定。
```
aws iotwireless create-network-analyzer-configuration \
--configuration-name My_NetworkAnalyzer_Config \
--trace-content WirelessDeviceFrameInfo=DISABLED,LogLevel="ERROR" \
--wireless-gateways "12345678-a1b2-3c45-67d8-e90fa1b2c34d" "90123456-de1f-2b3b-4c5c-bb1112223cd1"
--wireless-devices "1ffd32c8-8130-4194-96df-622f072a315f"
```
以下範例顯示執行命令的輸出：
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
```
**列出網路分析器組態**
您可以建立多個網路分析器組態，具體取決於要監控的資源，以及您希望接收的追蹤訊息資訊詳細程度。建立這些組態後，您可以使用 [ListNetworkAnalyzerConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListNetworkAnalyzerConfigurations.html) API 操作或 [list-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-network-analyzer-configuration.html) CLI 命令取得這些組態的清單。
```
aws iotwireless list-network-analyzer-configurations
```
執行這個命令會顯示您 AWS 帳戶 中的所有網路分析器組態。您也可以使用 `max-results` 參數指定要顯示多少組態。以下顯示執行這個命令的輸出。
```
{
"NetworkAnalyzerConfigurationList": [
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Name": "My_Network_Analyzer_Config1"
},
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/90123456-a1a2-9a87-65b4-c12bf3c2d09a",
"Name": "My_Network_Analyzer_Config2"
}
]
}
```
**刪除您的網路分析器組態**
您可以用 [DeleteNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteNetworkAnalyzerConfiguration.html) API 操作或 [delete-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-network-analyzer-configuration.html) CLI 命令刪除不再使用的組態。
```
aws iotwireless delete-network-analyzer-configuration \
--configuration-name My_NetworkAnalyzer_Config
```
執行這個命令不會產生任何輸出。若要檢視可用的組態，您可以使用 `ListNetworkAnalyzerConfigurations` API 操作。
## 後續步驟
現在您已建立網路分析器組態，可以在組態加入資源或更新組態設定。如需詳細資訊，請參閱[新增資源並更新網路分析器組態](network-analyzer-resources.md)。
# 新增資源並更新網路分析器組態
必須先將資源新增至組態，才能啟動追蹤訊息。您只能使用一個預設網路分析器組態。AWS IoT Core for LoRaWAN 會將名稱 **NetworkAnalyzerConfig\$1Default** 指派給此組態，且此欄位無法編輯。在從主控台使用網路分析器時，此組態會自動新增至您的 AWS 帳戶。
您可以新增想要監控的資源至此預設組態。資源可以是 LoRaWAN 裝置和 LoRaWAN 閘道。若要將每個資源新增至組態，請使用無線閘道和無線裝置識別碼。
## 組態設定
若要進行設定，請先將資源新增至預設組態，然後啟用追蹤訊息。收到追蹤訊息日誌之後，您也可以自訂下列參數，以更新預設組態並篩選日誌串流。
+
**框架資訊**
此設定是追蹤訊息用無線裝置資源的框架資訊。框架資訊預設為啟用，可用來偵錯網路伺服器與終端裝置之間的通訊。
+
**日誌層級**
您可以檢視 Info (資訊) 或 Error (錯誤) 日誌，也可以關閉記錄功能。
+
**Info**
日誌層級為 **Info** (資訊) 的日誌更詳細，並且包含資訊豐富且提供錯誤的日誌串流。資訊豐富的日誌可用來檢視裝置或閘道狀態的變更。
**注意**
收集更詳細的日誌串流會產生額外的成本。如需定價的詳細資訊，請參閱 [AWS IoT Core 定價](https://aws.amazon.com/iot-core/pricing/)。
+
**錯誤**
日誌層級為 **Error** (錯誤) 的日誌不夠詳細且只會顯示錯誤資訊。當應用程式發生錯誤 (例如裝置連線錯誤) 時，您就可以使用這些日誌。藉由使用來自日誌串流的資訊，您可以識別並排解機群中資源的錯誤。
## 必要條件
在新增資源之前，您必須先將想監控的閘道和裝置加入 AWS IoT Core for LoRaWAN。如需詳細資訊，請參閱[將閘道和裝置連接至 AWS IoT Core for LoRaWAN](lorawan-getting-started.md)。
## 新增資源並使用主控台更新網路分析器組態
您可以新增資源，並使用 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 更新網路分析器組態
您可以使用 [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` 作為輸入。
## 後續步驟
您已新增資源並為組態指定任何選用組態設定，接下來可以使用 WebSocket 通訊協定建立與 AWS IoT Core for LoRaWAN 的連線以使用網路分析器。然後，您可以啟用追蹤訊息並開始接收資源的追蹤訊息。如需詳細資訊，請參閱[串流網路分析器使用 WebSocket 追蹤消息](network-analyzer-api.md)。