为 AWS IoT Wireless 资源配置日志记录

使用 CLI 为 AWS IoT 配置资源特定的日志记录

1. 预设情况下，所有资源的日志级别都设置为 ERROR。要为账户中的所有资源设置默认日志级别或按资源类型设置日志级别，请使用 update-log-levels-by-resource-types 命令。以下示例显示如何创建 JSON 文件 Input.json，并将其作为 CLI 命令的输入提供。您可以使用此命令有选择地禁用特定类型的资源和时间的日志记录或覆盖默认日志级别。

   {
       "DefaultLogLevel": "INFO",
       "WirelessDeviceLogOptions": 
        [
           {
            "Type": "Sidewalk",
            "LogLevel": "INFO",
            "Events": 
             [
               {
                 "Event": "Registration",
                 "LogLevel": "DISABLED"
               }
             ]
           }, 
           {
            "Type": "LoRaWAN",
            "LogLevel": "INFO",
            "Events": 
             [
               {
                "Event": "Join",
                "LogLevel": "DISABLED"
               }, 
               {
                "Event": "Rejoin",
                "LogLevel": "ERROR"
               }
             ]
           }
         ]
        "WirelessGatewayLogOptions": 
         [
           {
            "Type": "LoRaWAN",
            "LogLevel": "INFO",
            "Events": 
             [
               {
                "Event": "CUPS_Request",
                "LogLevel": "DISABLED"
               }, 
               {
                 "Event": "Certificate",
                 "LogLevel": "ERROR"
               }
             ]
           }
         ]
   }

   其中：

   WirelessDeviceLogOptions

   无线设备的日志选项列表。每个日志选项都包括无线设备类型（Sidewalk 或 LoRaWAN），以及无线设备事件日志选项列表。每个无线设备事件日志选项都可以选择是否包括事件类型及其日志级别。

   WirelessGatewayLogOptions

   无线网关的日志选项列表。每个日志选项都包括无线网关类型 (LoRaWAN) 和无线网关事件日志选项列表。每个无线网关事件日志选项都可以选择是否包括事件类型及其日志级别。

   DefaultLogLevel

   用于所有资源的日志级别。有效值包括 ERROR、INFO 和 DISABLED。默认值为 INFO。

   LogLevel

   要用于单个资源类型和事件的日志级别。这些日志级别会覆盖默认日志级别，例如适用于 LoRaWAN 的 INFO 网关日志级别，以及适用于两种事件类型的日志级别 DISABLED 和 ERROR。

   运行以下命令以向命令提供 Input.json 文件作为输入。此命令不会生成任何输出。

   aws iotwireless update-log-levels-by-resource-types \ 
       --cli-input-json Input.json

   如果要删除无线设备和无线网关的日志选项，请运行以下命令。

   {
       "DefaultLogLevel":"DISABLED",
       "WirelessDeviceLogOptions": [],
       "WireslessGatewayLogOptions":[]
   }

2. update-log-levels-by-resource-types 命令不返回任何输出。使用 get-log-levels-by-resource-types 命令检索资源特定的日志记录信息。该命令返回默认日志级别以及无线设备和无线网关日志选项。

   注意

   get-log-levels-by-resource-types 命令无法在 CloudWatch 控制台中直接检索日志级别。您可以使用 get-log-levels-by-resource-types 命令获取您使用 update-log-levels-by-resource-types 命令为资源指定的最新日志级别信息。

   aws iotwireless get-log-levels-by-resource-types 

   当您运行以下命令时，它会返回您使用 update-log-levels-by-resource-types 指定的最新日志记录信息。例如，如果删除无线设备日志选项，则运行 get-log-levels-by-resource-types 将返回此值，为 null。

   {
       "DefaultLogLevel": "INFO",
       "WirelessDeviceLogOptions": null,
        "WirelessGatewayLogOptions": 
         [
           {
            "Type": "LoRaWAN",
            "LogLevel": "INFO",
            "Events": 
             [
               {
                "Event": "CUPS_Request",
                "LogLevel": "DISABLED"
               }, 
               {
                 "Event": "Certificate",
                 "LogLevel": "ERROR"
               }
             ]
           }
         ]
   }

3. 要控制单个无线网关或无线设备资源的日志级别，请使用以下 CLI 命令：

   • put-resource-log-level

   • get-resource-log-level

   • reset-resource-log-level

   有关何时使用这些 CLI 的示例，假设您的账户中有大量正在记录的无线设备或网关。如果您只想排除某些无线设备的故障，可以通过将 DefaultLogLevel 设置为 DISABLED 禁用所有无线设备的日志记录，然后针对您账户中的设备，使用 put-resource-log-level 将 LogLevel 设置为 ERROR。

   aws iotwireless put-resource-log-level \ 
       --resource-identifier 
       --resource-type WirelessDevice
       --log-level ERROR

   在本例中，命令仅将特定无线设备资源的日志级别设置为 ERROR，而所有其他资源的日志均已禁用。此命令不会生成任何输出。要检索此信息并验证是否已设置日志级别，请使用 get-resource-log-level 命令。

4. 在上一步中，调试问题并解决错误后，您可以运行 reset-resource-log-level 命令将该资源的日志级别重置为 null。如果您使用 put-resource-log-level 命令为多个无线设备或网关资源设置日志级别覆盖（例如，为多个设备排除故障），您可以使用 reset-all-resource-log-levels 命令为所有这些资源将日志级别覆盖重置为 null。

   aws iotwireless reset-all-resource-log-levels

   此命令不会生成任何输出。要检索资源的日志记录信息，请运行 get-resource-log-level 命令。