创建网络分析器配置 - Amazon IoT Core
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

创建网络分析器配置

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

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

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

配置设置

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

  • 帧信息

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

  • 日志级别

    您可以查看信息或错误日志,也可以关闭日志记录。

    • 信息

      日志级别为 Info(信息)的日志更详细,其中包含错误日志流和信息日志流。信息日志可用于查看设备或网关状态的变化。

      注意

      收集更多详细的日志流可能会产生额外的成本。有关定价的更多信息,请参阅 Amazon IoT Core 定价

    • 错误

      日志级别为 Error 的日志不那么详细,只显示错误信息。当应用程序出错(例如设备连接错误)时,可以使用这些日志。通过使用日志流中的信息,您可以识别机群中资源的错误并对其进行故障排除。

  • 组播帧信息

    如果您有要监控的组播组,则可以使用组播帧信息对尝试加入该组的设备进行故障排除。

使用控制台创建配置

您可以使用 Amazon IoT 控制台或 Amazon IoT Wireless API 创建网络分析器配置并自定义可选参数。还可以创建多个配置,之后删除任何不再使用的配置。

创建网络分析器配置

  1. 打开Amazon IoT 控制台的网络分析器中心,然后选择创建配置

  2. 指定配置设置。

    • 名称、描述和标签

      指定唯一的配置名称、可选的描述标签,以添加有关配置的元数据的键值对。有关命名和描述资源的更多信息,请参阅描述您 Amazon IoT Core 的 LoRa WAN 资源

    • 配置设置

      选择是否禁用帧信息,并使用 Select log levels(选择日志级别)以选择希望用来跟踪消息日志的日志级别。如果您有要监控的组播组,请选择组播数据消息(仅限组播组)。选择下一步

  3. 向配置添加资源。您可以立即添加资源,也可以选择 Create(创建)并在以后添加您的资源。要以后添加资源,请选择 Create(创建)。

    Network Analyzer hub page(网络分析器中心页面)中,您将看到创建的配置及其设置。要查看新配置的详细信息,请选择配置名称。

删除网络分析器配置

您可以创建多个网络分析器配置,具体取决于要监视的资源以及希望针对这些资源接收的跟踪消息收发信息的级别。

从控制台中删除配置
  1. 转到Amazon IoT 控制台的 Network Analyzer 中心,然后选择要删除的配置。

  2. 选择操作,然后选择删除

使用 API 创建控制台

要使用 API 创建网络分析器配置,请使用 CreateNetworkAnalyzerConfigurationAPI 操作或 create-network-analyzer-configurationCLI 命令。

创建配置时,只需指定配置名称。还可以使用此 API 操作在创建配置时指定配置设置和添加资源。

注意

使用 CreateNetworkAnalyzerConfiguration API 操作添加资源时,对于每个 API 请求,您最多只能指定 99 个无线资源。单个网络分析器配置最多可以组合 250 个无线设备和 250 个无线网关。要添加其他资源,请使用 Amazon IoT 控制台,如上一节所述。

  • 创建配置

    创建配置时,必须指定名称。例如,以下命令通过仅提供名称和可选描述来创建配置。默认情况下,配置激活了帧信息,并使用 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 参数。要添加资源,请使用 WirelessDevicesWirelessGatewaysMulticastGroups 参数指定要添加到配置中的网关、设备和组播组。例如,以下命令自定义配置设置并将无线资源添加到配置中。

    aws iotwireless create-network-analyzer-configuration \ --configuration-name My_NetworkAnalyzer_Config \ --trace-content WirelessDeviceFrameInfo=DISABLED,MulticastFrameInfo=ENABLED,LogLevel="ERROR" \ --wireless-gateways "12345678-a1b2-3c45-67d8-e90fa1b2c34d" "90123456-de1f-2b3b-4c5c-bb1112223cd1" --wireless-devices "1ffd32c8-8130-4194-96df-622f072a315f" \ --multicast-groups "12abd34e-5f67-89c2-9293-593b1bd862e0"

    下面的示例显示了运行此命令的输出:

    { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" }
列出网络分析器配置

您可以创建多个网络分析器配置,具体取决于要监视的资源以及要针对这些资源接收的跟踪消息收发信息的详细程度。创建这些配置后,您可以使用 ListNetworkAnalyzerConfigurationsAPI 操作或 list-network-analyzer-configurationCLI 命令来获取这些配置的列表。

aws iotwireless list-network-analyzer-configurations

运行此命令会显示您的 Amazon Web Services 账户 中的所有网络分析器配置。也可以使用 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" } ] }
删除网络分析器配置

您可以删除不再在 DeleteNetworkAnalyzerConfigurationAPI 操作或 delete-network-analyzer-configurationCLI 命令中使用的配置。

aws iotwireless delete-network-analyzer-configuration \ --configuration-name My_NetworkAnalyzer_Config

运行此命令不会生成任何输出。要查看可用配置,可以使用 ListNetworkAnalyzerConfigurations API 操作。

后续步骤

现在您已创建网络分析器配置,可以向配置中添加资源或更新配置设置。有关更多信息,请参阅添加资源并更新网络分析器配置