# 创建网络分析器配置并添加资源 在流式传输跟踪消息之前，请创建网络分析器配置并将要监控的资源添加到此配置中。创建配置时，您可以： + 指定配置名称和可选说明。 + 自定义配置设置，例如帧信息和日志消息的详细级别。 + 确定您要监控的资源。资源可以是无线网关和/或无线设备。 您指定的配置设置将决定您将针对添加到配置的资源收到的跟踪消息收发信息。您可能还需要根据监控用例创建多个配置。 下面的内容说明了如何创建配置和添加资源。 **Topics** + [创建网络分析器配置](network-analyzer-create.md) + [添加资源并更新网络分析器配置](network-analyzer-resources.md) # 创建网络分析器配置 必须先创建网络分析器配置，然后才能监控无线网关或无线设备。创建配置时，只需指定配置名称。即使在创建配置之后，您也可以自定义配置设置并将希望监控的资源添加到配置中。配置设置决定了您将针对这些资源收到的跟踪消息收发信息。 根据要监控的资源以及希望为其接收的信息级别，您可能需要创建多个配置。例如，您可以创建一个仅显示您的 AWS 账户中一组网关的错误信息的配置。您还可以创建一个配置，以显示有关要监控的无线设备的所有信息。 以下各节介绍了各种配置设置以及如何创建配置。 ## 配置设置 在创建或更新网络分析器配置时，还可以自定义以下参数以筛选日志流信息。 + **帧信息** 此设置是跟踪消息的无线设备资源的帧信息。帧信息可用于调试网络服务器与终端设备之间的通信。该功能默认已启用。 + **日志级别** 您可以查看信息或错误日志，也可以关闭日志记录。 + **信息** 日志级别为 **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. 指定配置设置。 + **名称、描述和标签** 指定一个唯一的 **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 创建控制台 要使用 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)。 # 添加资源并更新网络分析器配置 在激活跟踪消息传递之前，您必须向配置中添加资源。您只能使用单个默认的网络分析器配置。适用于 LoRaWAN 的 AWS IoT Core 将名称 **NetworkAnalyzerConfig\$1Default** 分配给此配置，因此该字段无法编辑。当您在控制台使用网络分析器时，此配置会自动添加到您的 AWS 账户 中。 您可以将想要监控的资源添加到此原定设置配置中。资源可以是 LoRaWAN 设备和 LoRaWAN 网关之一，也可以是两者。要将每个单独的资源添加到配置中，请使用无线网关和无线设备标识符。 ## 配置设置 要配置设置，首先将资源添加到原定设置配置中，然后激活跟踪消息。收到跟踪消息日志后，您还可以自定义以下参数更新原定设置配置并筛选日志流。 + **帧信息** 此设置是跟踪消息的无线设备资源的帧信息。预设情况下，帧信息处于启用状态，可用于调试网络服务器与终端设备之间的通信。 + **日志级别** 您可以查看信息或错误日志，也可以关闭日志记录。 + **信息** 日志级别为 **Info** 的日志更详细，包含信息丰富和错误的日志流。信息日志可用于查看设备或网关状态的更改。 **注意** 收集更多详细的日志流可能会产生额外的成本。有关定价的更多信息，请参阅 [AWS IoT Core 定价](https://aws.amazon.com/iot-core/pricing/)。 + **错误** 日志级别为 **Error** 的日志不那么详细，只显示错误信息。当应用程序出错（例如设备连接错误）时，可以使用这些日志。通过使用日志流中的信息，您可以识别机群中资源的错误并对其进行故障排除。 ## 先决条件 在添加资源之前，必须将您要监控的网关和设备登记到 适用于 LoRaWAN 的 AWS IoT Core。有关更多信息，请参阅[将网关和设备连接到 适用于 LoRaWAN 的 AWS IoT Core](lorawan-getting-started.md)。 ## 使用控制台添加资源并更新网络分析器配置 通过使用 AWS IoT 控制台或 AWS IoT Wireless API，您可以添加资源和自定义可选参数。除了资源之外，您还可以编辑配置设置并保存更新的配置。 **向配置添加资源（控制台）** 1. 打开 AWS IoT控制台[的网络分析器中心](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer)然后选择网络分析器配置，**Network Analyszerconfig\$1DEFAULT**。 1. 选择 **Add resource** (添加资源)。 1. 使用无线网关和无线设备标识符添加要监控的资源。您可以添加最多 250 个无线网关或无线设备。添加资源： 1. 使用**查看网关**或**查看设备**选项卡查看已添加到 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)然后选择网络分析器配置，**Network Analyszerconfig\$1DEFAULT**。 1. 选择**编辑**。 1. 选择是否禁用帧信息并使用**选择日志级别**来选择希望用来跟踪消息日志的日志级别。选择**保存**。 您将看到在网络分析器配置的详细信息页面中指定的配置设置。 ## 使用 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 协议通过与 适用于 LoRaWAN 的 AWS IoT Core 建立连接来使用网络分析器。然后，您可以激活跟踪消息并开始接收资源的跟踪消息。有关更多信息，请参阅[使用 WebSockets 串流网络分析器跟踪消息](network-analyzer-api.md)。