Konfigurieren Sie die Protokollierung für AWS IoT Wireless-Ressourcen

So konfigurieren Sie die ressourcenspezifische Protokollierung für AWS IoT mit der CLI

1. Standardmäßig ist für alle Ressourcen die Protokollebene auf ERROR festgelegt. Verwenden Sie den update-log-levels-by-resource-types-Befehl, um die Standard-Protokollebenen oder die Protokollebenen nach Ressourcentypen für alle Ressourcen in Ihrem Konto festzulegen. Das folgende Beispiel zeigt, wie Sie eine JSON-Datei Input.json erstellen und als Eingabe für den CLI-Befehl bereitstellen können. Sie können diesen Befehl verwenden, um die Protokollierung selektiv zu deaktivieren oder die Standardprotokollebene für bestimmte Arten von Ressourcen und Ereignissen zu überschreiben.

   {
       "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"
               }
             ]
           }
         ]
   }

   Wobei:

   WirelessDeviceLogOptions

   Die Liste der Protokolloptionen für ein drahtloses Gerät. Jede Protokolloption umfasst den Typ des drahtlosen Geräts (Sidewalk oder LoRaWAN) und eine Liste von Ereignisprotokolloptionen für drahtlose Geräte. Jede Ereignisprotokolloption für drahtlose Geräte kann optional den Ereignistyp und dessen Protokollebene enthalten.

   WirelessGatewayLogOptions

   Die Liste der Protokolloptionen für ein drahtloses Gateway. Jede Protokolloption umfasst den Typ des drahtlosen Gateways (LoRaWAN) und eine Liste von Ereignisprotokolloptionen für drahtlose Gateways. Jede Ereignisprotokolloption für drahtlose Gateways kann optional den Ereignistyp und dessen Protokollebene enthalten.

   DefaultLogLevel

   Die Protokollstufe, die für all Ihre Ressourcen verwendet werden soll. Gültige Werte sind: ERROR, INFO und DISABLED. Der Standardwert ist INFO.

   LogLevel

   Die Protokollebene, die Sie für einzelne Ressourcentypen und Ereignisse verwenden möchten. Diese Protokollebenen überschreiben die Standardprotokollebene, z. B. die Protokollebene INFO für das LoRaWAN-Gateway und die Protokollebenen DISABLED und ERROR für die beiden Ereignistypen.

   Führen Sie den folgenden Befehl aus, um die Input.json-Datei als Eingabe für den Befehl bereitzustellen. Dieser Befehl liefert keine Ausgabe.

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

   Wenn Sie die Protokolloptionen sowohl für WLAN-Geräte als auch für WLAN-Gateways entfernen möchten, führen Sie den folgenden Befehl aus.

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

2. Der update-log-levels-by-resource-types-Befehl gibt keine Ausgabe zurück. Verwenden Sie den get-log-levels-by-resource-types-Befehl, um ressourcenspezifische Protokollierungsinformationen abzurufen. Der Befehl gibt die Standardprotokollebene sowie die Protokolloptionen für das WLAN-Gerät und das WLAN-Gateway zurück.

   Anmerkung

   Der get-log-levels-by-resource-types-Befehl kann die Protokollebenen in der CloudWatch-Konsole nicht direkt abrufen. Sie können den get-log-levels-by-resource-types-Befehl verwenden, um die neuesten Informationen auf Protokollebene abzurufen, die Sie mit dem update-log-levels-by-resource-types-Befehl für Ihre Ressourcen angegeben haben.

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

   Wenn Sie den folgenden Befehl ausführen, werden die neuesten Protokollinformationen zurückgegeben, die Sie mit update-log-levels-by-resource-types angegeben haben. Wenn Sie beispielsweise die Protokolloptionen für WLAN-Geräte entfernen, gibt get-log-levels-by-resource-types die Ausführung von diesen Wert als null zurück.

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

3. Verwenden Sie die folgenden CLI-Befehle, um die Protokollebenen für einzelne WLAN-Gateways oder WLAN-Geräteressourcen zu steuern:

   • put-resource-log-level

   • get-resource-log-level

   • reset-resource-log-level

   Nehmen wir als Beispiel für die Verwendung dieser CLIs an, dass Sie in Ihrem Konto eine große Anzahl von WLAN-Geräten oder -Gateways haben, die protokolliert werden. Wenn Sie Fehler nur für einige Ihrer WLAN-Geräte beheben möchten, können Sie die Protokollierung für alle WLAN-Geräte deaktivieren, indem Sie den Wert DefaultLogLevel auf DISABLED setzen, und put-resource-log-levelverwenden, um LogLevel auf ERROR festzulegen, für die Geräte in Ihrem Konto.

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

   In diesem Beispiel legt der Befehl die Protokollebene auf ERROR nur für die angegebene WLAN-Geräteressource fest und die Protokolle für alle anderen Ressourcen sind deaktiviert. Dieser Befehl liefert keine Ausgabe. Verwenden Sie den get-resource-log-level-Befehl, um diese Informationen abzurufen und zu überprüfen, ob die Protokollebenen festgelegt wurden.

4. Im vorherigen Schritt können Sie, nachdem Sie das Problem debuggt und den Fehler behoben haben, den reset-resource-log-level-Befehl ausführen, um die Protokollebene für diese Ressource auf null zurückzusetzen. Wenn Sie den put-resource-log-level-Befehl verwendet haben, um die Überschreibung der Protokollebene für mehr als ein WLAN-Gerät oder eine Gateway-Ressource festzulegen, z. B. zur Behebung von Fehlern für mehrere Geräte, können Sie mit dem reset-all-resource-log-levels-Befehl die Überschreibungen auf Protokollebene für all diese Ressourcen wieder auf null zurücksetzen.

   aws iotwireless reset-all-resource-log-levels

   Dieser Befehl liefert keine Ausgabe. Führen Sie den get-resource-log-level-Befehl aus, um die Protokollierungsinformationen für die Ressourcen abzurufen.