# 创建网络分析器配置
<a name="network-analyzer-create"></a>

必须先创建网络分析器配置，然后才能监控无线网关或无线设备。创建配置时，只需指定配置名称。即使在创建配置之后，您也可以自定义配置设置并将希望监控的资源添加到配置中。配置设置决定了您将针对这些资源收到的跟踪消息收发信息。

根据要监控的资源以及希望为其接收的信息级别，您可能需要创建多个配置。例如，您可以创建一个仅显示您的 AWS 账户中一组网关的错误信息的配置。您还可以创建一个配置，以显示有关要监控的无线设备的所有信息。

以下各节介绍了各种配置设置以及如何创建配置。

## 配置设置
<a name="network-analyzer-config-settings"></a>

在创建或更新网络分析器配置时，还可以自定义以下参数以筛选日志流信息。
+ 

**帧信息**  
此设置是跟踪消息的无线设备资源的帧信息。帧信息可用于调试网络服务器与终端设备之间的通信。该功能默认已启用。
+ 

**日志级别**  
您可以查看信息或错误日志，也可以关闭日志记录。
  + 

**信息**  
日志级别为 **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. 指定配置设置。
   + 

**名称、描述和标签**  
指定一个唯一的 **Configuration name**（配置名称），其中仅包含字母、数字、连字符或下划线。使用可选的 **Description**（说明）字段以提供有关配置的信息，并使用 **Tags**（标签）字段以添加有关配置的元数据的键值对。有关命名和描述资源的更多信息，请参阅 [描述您的 AWS IoT Wireless 资源](iotwireless-describe-resources.md)。
   + 

**配置设置**  
选择是否禁用帧信息，并使用**选择日志级别**来选择希望用来跟踪消息日志的日志级别。选择**下一步**。

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)。