Configurazione della registrazione per risorse Wireless AWS IoT

Per utilizzare l'interfaccia a riga di comando per configurare la registrazione specifica delle risorse per AWS IoT

1. Per impostazione predefinita, tutte le risorse hanno il livello di log impostato su ERROR. Per impostare i livelli di log predefiniti o i livelli di log in base ai tipi di risorse per tutte le risorse dell'account, utilizza il comando update-log-levels-by-resource-types. L'esempio seguente mostra come puoi creare un file JSON, Input.json, e fornirlo come input per il comando CLI. È possibile utilizzare questo comando per disabilitare selettivamente la registrazione o ignorare il livello di log predefinito per tipi specifici di risorse ed eventi.

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

   dove:

   WirelessDeviceLogOptions

   Elenco delle opzioni di log per un dispositivo wireless. Ogni opzione di log include il tipo di dispositivo wireless (Sidewalk o LoRaWAN) e un elenco di opzioni di log eventi del dispositivo wireless. Ogni opzione di log eventi del dispositivo wireless può includere facoltativamente il tipo di evento e il relativo livello di log.

   WirelessGatewayLogOptions

   Elenco delle opzioni di log per un gateway wireless. Ogni opzione di log include il tipo di gateway wireless (LoRaWAN) e un elenco di opzioni di log eventi del gateway wireless. Ogni opzione di log eventi del gateway wireless può includere facoltativamente il tipo di evento e il relativo livello di log.

   DefaultLogLevel

   Livello di log da utilizzare per tutte le risorse. I valori validi sonoERROR, INFO e DISABLED. Il valore predefinito è INFO.

   LogLevel

   Livello di log che si desidera utilizzare per i singoli tipi di risorse ed eventi. Questi livelli di log sovrascrivono il livello di log predefinito, ad esempio il livello di log INFO per il gateway LoRaWAN e i livelli di log DISABLED e ERROR per i due tipi di evento.

   Nel comando di esempio seguente viene utilizzato un file di input Input.json per fornire il codice della funzione al comando. Il comando non produce output.

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

   Se desideri rimuovere le opzioni di log sia per i dispositivi wireless che per i gateway wireless, esegui il comando seguente.

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

2. Il comando update-log-levels-by-resource-types non restituisce alcun output. Utilizza il comando get-log-levels-by-resource-types per recuperare le informazioni di registrazione specifiche delle risorse. Il comando restituisce il livello di log predefinito e le opzioni di log del dispositivo wireless e del gateway wireless.

   Nota

   Il comando get-log-levels-by-resource-types non è in grado di recuperare direttamente i livelli di log nella console CloudWatch. Puoi utilizzare il comando get-log-levels-by-resource-types per ottenere le informazioni più recenti a livello di log specificate per le risorse utilizzando il comando update-log-levels-by-resource-types.

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

   Quando si esegue il comando seguente, restituisce le informazioni di registrazione più recenti specificate con update-log-levels-by-resource-types. Ad esempio, se rimuovi le opzioni di log dei dispositivi wireless, get-log-levels-by-resource-types restituirà questo valore come null.

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

3. Per controllare i livelli di log per singoli gateway wireless o risorse di dispositivi wireless, utilizza i seguenti comandi CLI:

   • put-resource-log-level

   • get-resource-log-level

   • reset-resource-log-level

   Per un esempio su quando utilizzare questi CLI, supponi di disporre di un numero elevato di dispositivi wireless o gateway che vengono registrati nell’account. Se desideri risolvere gli errori solo per alcuni dispositivi wireless, puoi disabilitare la registrazione per tutti i dispositivi wireless impostando DefaultLogLevel su DISABLED e utilizzando put-resource-log-level per impostare il LogLevel su ERROR, solo per i dispositivi nel tuo account.

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

   In questo esempio, il comando imposta il livello di log su ERROR solo per la risorsa del dispositivo wireless specificata mentre i log per tutte le altre risorse sono disabilitati. Il comando non produce output. Per recuperare queste informazioni e verificare che i livelli di log siano stati impostati, utilizza il comando get-resource-log-level.

4. Nel passaggio precedente, dopo aver eseguito il debug del problema e risolto l'errore, puoi eseguire il comando reset-resource-log-level per reimpostare il livello di log per tale risorsa su null. Se hai usato il comando put-resource-log-level per impostare l'override a livello di log per più dispositivi wireless o risorse gateway, ad esempio per la risoluzione dei problemi relativi a più dispositivi, puoi ripristinare le sostituzioni a livello di log su null per tutte quelle risorse che usano il comando reset-all-resource-log-levels.

   aws iotwireless reset-all-resource-log-levels

   Il comando non produce output. Per recuperare le informazioni di registrazione per le risorse, esegui il comando get-resource-log-level.