# 建立網路分析器組態
<a name="network-analyzer-create"></a>

您必須先建立網路分析器組態，才能監控無線閘道或無線裝置。建立組態時，您只需要指定組態名稱。您可以自訂您的組態設定，並將您想要監控的資源新增至組態，即使組態已建立之後也是如此。組態設定會決定您將針對這些資源接收到的追蹤訊息資訊。

您可能需要建立多個組態，具體取決於要監控的資源以及您希望接收的資訊層級。例如，您可以建立一個組態，僅顯示 AWS 帳戶 中一組閘道的錯誤資訊。您也可以建立一個組態，顯示要監控之無線裝置的所有資訊。

以下部分介紹各種組態設定以及如何建立組態。

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

建立或更新網路分析器組態時，您也可以自訂下列參數，以篩選日誌串流資訊。
+ 

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

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

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

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

## 使用主控台建立組態
<a name="network-analyzer-create-configuration-console"></a>

您可以建立網路分析器組態，並使用 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 建立組態
<a name="network-analyzer-create-configuration-api"></a>

若要使用 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 操作。

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

現在您已建立網路分析器組態，可以在組態加入資源或更新組態設定。如需詳細資訊，請參閱[新增資源並更新網路分析器組態](network-analyzer-resources.md)。