Voci di registro per gateway wireless e risorse di dispositivi wireless - Wireless AWS IoT
Voci di registro del gateway wirelessVoci di registro dei dispositivi wireless

Voci di registro per gateway wireless e risorse di dispositivi wireless

Dopo aver abilitato la registrazione, è possibile visualizzare le voci di log per i gateway wireless e i dispositivi wireless. Nella sezione seguente vengono descritti i vari tipi di voci di log in base ai tipi di risorsa e di evento.

Voci di registro del gateway wireless

In questa sezione vengono illustrate alcune voci di log di esempio per le risorse del gateway wireless visualizzate nella sezione CloudWatch console (Console CloudWatch). Questi messaggi di registro possono avere tipo di evento come CUPS_Request o Certificate che può essere configurato per visualizzare un livello di log di INFO, ERROR, oppure DISABLED a livello di risorsa o a livello di evento. Se desideri visualizzare solo le informazioni di errore, imposta il livello di log su ERROR. Il messaggio ERROR nella voce di log conterrà informazioni sul motivo per cui non è riuscito.

Le voci di log per la risorsa del gateway wireless possono essere classificate in base ai seguenti tipi di evento:

  • CUPS_request

    LoRa Basics Station in esecuzione sul gateway invia periodicamente una richiesta al server di configurazione e aggiornamento (CUPS) per gli aggiornamenti. Per questo tipo di evento, se imposti il livello di log su INFO durante la configurazione dell'interfaccia della riga di comando per la risorsa del gateway wireless, quindi nei log:

    • Se l'evento viene completato correttamente, vengono visualizzati i messaggi di log con un logLevel di INFO. I messaggi includeranno dettagli sulla risposta CUPS inviata al gateway e i dettagli del gateway. Nell'esempio seguente viene mostrata una voce di log. Per ulteriori informazioni su logLevel e altri campi nella voce di log, consulta Risorse AWS IoT Wireless e livelli di registro.

      {
    "timestamp": "2021-05-13T16:56:08.853Z",
    "resource": "WirelessGateway",
    "wirelessGatewayId": "5da85cc8-3361-4c79-8be3-3360fb87abda",
    "wirelessGatewayType": "LoRaWAN",
    "gatewayEui": "feffff00000000e2",
    "event": "CUPS_Request",
    "logLevel": "INFO",
    "message": "Sending CUPS response of total length 3213 to GatewayEui: feffff00000000e2 with  TC Credentials,"
}

    • Se si verifica un errore, verranno visualizzate le voci di log con un logLevel di ERROR e i messaggi includeranno dettagli sull'errore. Gli esempi di quando si può verificare un errore per l’evento CUPS_Request includono: CUPS CRC mancante, mancata corrispondenza nel TC Uri del gateway con AWS IoT Core per LoRaWAN, IoTWirelessGatewayCertManagerRole mancante o non in grado di ottenere il registro del gateway wireless. Nell'esempio seguente viene mostrata una voce di log CRC mancante. Per risolvere l'errore, controlla la configurazione del gateway per verificare di aver inserito il CRC CUPS corretto.

      {
    "timestamp": "2021-05-13T16:56:08.853Z",
    "resource": "WirelessGateway",
    "wirelessGatewayId": "5da85cc8-3361-4c79-8be3-3360fb87abda",
    "wirelessGatewayType": "LoRaWAN",
    "gatewayEui": "feffff00000000e2",
    "event": "CUPS_Request",
    "logLevel": "ERROR",
    "message": "The CUPS CRC is missing from the request. Check your gateway setup and enter the CUPS CRC,"
}

  • Certificato

    Queste voci di log consentono di verificare se il gateway wireless ha presentato il certificato corretto per l'autenticazione della connessione a AWS IoT. Per questo tipo di evento, se imposti il livello di log su INFO durante la configurazione dell'interfaccia della riga di comando per la risorsa del gateway wireless, nei log:

    • Se l'evento viene completato correttamente, vengono visualizzati i messaggi di log con un logLevel di INFO. I messaggi includeranno dettagli sull'ID certificato e sull'identificatore del gateway wireless. Nell'esempio seguente viene mostrata una voce di log. Per ulteriori informazioni su logLevel e altri campi nella voce di log, consulta Risorse AWS IoT Wireless e livelli di registro.

      {
    "resource": "WirelessGateway",
    "wirelessGatewayId": "5da85cc8-3361-4c79-8be3-3360fb87abda",
    "wirelessGatewayType": "LoRaWAN",
    "event": "Certificate",
    "logLevel": "INFO",
    "message": "Gateway connection authenticated. 
    (CertificateId: b5942a7aee973eda24314e416889227a5e0aa5ed87e6eb89239a83f515dea17c, WirelessGatewayId: 5da85cc8-3361-4c79-8be3-3360fb87abda)"
}

    • Se si verifica un errore, verranno visualizzate le voci di log con un logLevel di ERROR e i messaggi includeranno dettagli sull'errore. Esempi di quando si può imbattere in un errore Certificate per l’evento includono un ID certificato non valido, un identificatore del gateway wireless o una mancata corrispondenza tra l'identificatore del gateway wireless e l'ID del certificato. L’esempio a seguire mostra un ERROR dovuto a un identificatore di gateway wireless non valido. Per risolvere il problema, controlla gli identificatori del gateway.

      {
    "resource": "WirelessGateway",
    "wirelessGatewayId": "5da85cc8-3361-4c79-8be3-3360fb87abda",
    "wirelessGatewayType": "LoRaWAN",
    "event": "Certificate",
    "logLevel": "INFO",
    "message": "The gateway connection couldn't be authenticated because a provisioned gateway associated with the certificate couldn't be found. 
    (CertificateId: 729828e264810f6fc7134daf68056e8fd848afc32bfe8082beeb44116d709d9e)"
}

Voci di registro dei dispositivi wireless

Questa sezione mostra alcune delle voci di log di esempio per le risorse del dispositivo wireless che vedrai nella sezione CloudWatch console (Console CloudWatch). Il tipo di evento per questi messaggi di registro dipende dal fatto che si stia utilizzando un dispositivo LoRaWAN o un dispositivo Sidewalk. Ogni risorsa o tipo di evento del dispositivo wireless può essere configurato per visualizzare un livello di log di INFO, ERROR oppure DISABLED.

Nota

La tua richiesta non deve contenere contemporaneamente metadati wireless LoRaWAN e Sidewalk. Per evitare una voce di log ERROR per questo scenario, specifica i dati wireless LoRaWAN o Sidewalk.

Voci di registro del dispositivo LoRaWAN

Le voci di log per il dispositivo wireless LoRaWAN possono essere classificate in base ai seguenti tipi di eventi:

  • Join e Rejoin

    Quando aggiungi un dispositivo LoRaWAN e lo connetti ad AWS IoT Core per LoRaWAN, prima che il dispositivo possa inviare dati uplink, è necessario completare un processo chiamato activation o join procedure. Per ulteriori informazioni, consultare Aggiungi il dispositivo wireless ad AWS IoT Core per LoRaWAN.

    Per questo tipo di evento, se imposti il livello di log su INFO durante la configurazione dell'interfaccia della riga di comando per la risorsa del gateway wireless, nei log:

    • Se l'evento viene completato correttamente, vengono visualizzati i messaggi di log con un logLevel di INFO. I messaggi includeranno dettagli sullo stato della tua richiesta di join o rejoin. Di seguito viene mostrata una voce di log. Per ulteriori informazioni su logLevel e altri campi nella voce di log, consulta Risorse AWS IoT Wireless e livelli di registro.

      {
    "timestamp": "2021-05-13T16:56:08.853Z",
    "resource": "WirelessDevice",
    "wirelessDeviceType": "LoRaWAN",
    "WirelessDeviceId": "5da85cc8-3361-4c79-8be3-3360fb87abda",    
    "devEui": "feffff00000000e2",
    "event": "Rejoin",
    "logLevel": "INFO",
    "message": "Rejoin succeeded"
}

    • Se si verifica un errore, verranno visualizzate le voci di log con un logLevel di ERROR e i messaggi includeranno dettagli sull'errore. Esempi di quando si può imbattere in un errore per Join e Rejoin includono l'impostazione della regione LoRaWAN non valida o il controllo MIC (Message Integrity Code) non valido. L’esempio seguente mostra un errore di join a causa del controllo MIC. Per risolvere l'errore, verifica se sono state immesse le chiavi root corrette.

      {
    "timestamp": "2020-11-24T01:46:50.883481989Z",
    "resource": "WirelessDevice",
    "wirelessDeviceType": "LoRaWAN",
    "WirelessDeviceId": "cb4c087c-1be5-4990-8654-ccf543ee9fff",
    "devEui": "58a0cb000020255c",
    "event": "Join",
    "logLevel": "ERROR",
    "message": "invalid MIC. It's most likely caused by wrong root keys."
}

  • Uplink_Data e Downlink_Data

    Il tipo di evento Uplink_Data viene utilizzato per i messaggi generati da AWS IoT Wireless quando il carico utile viene inviato dal dispositivo LoRaWAN o Sidewalk ad AWS IoT. Il tipo di evento Downlink_Data viene utilizzato per i messaggi correlati ai messaggi downlink inviati da AWS IoT al dispositivo wireless.

    Per questo tipo di evento, se imposti il livello di log su INFO durante la configurazione dell'interfaccia della riga di comando per i dispositivi wireless, nei registri verrà visualizzato:

    • Se l'evento viene completato correttamente, vengono visualizzati i messaggi di log con un logLevel di INFO. I messaggi includeranno dettagli sullo stato del messaggio di uplink o downlink inviato e sull'identificatore del dispositivo wireless. Di seguito viene illustrato un esempio di questa voce di log per un dispositivo Sidewalk. Per ulteriori informazioni su logLevel e altri campi nella voce di log, consulta Risorse AWS IoT Wireless e livelli di registro.

      {
    "resource": "WirelessDevice",
    "wirelessDeviceId": "5371db88-d63d-481a-868a-e54b6431845d",
    "wirelessDeviceType": "Sidewalk",
    "event": "Downlink_Data",
    "logLevel": "INFO",
    "messageId": "8da04fa8-037d-4ae9-bf67-35c4bb33da71",
    "message": "Message delivery succeeded.  MessageId: 8da04fa8-037d-4ae9-bf67-35c4bb33da71. AWS IoT Core: {\"message\":\"OK\",\"traceId\":\"038b5b05-a340-d18a-150d-d5a578233b09\"}"
}

    • Se si verifica un errore, verranno visualizzate le voci di log con un logLevel di ERROR e i messaggi includeranno dettagli sull'errore, che ti aiuteranno a risolverlo. Esempi di quando si può imbattere in un errore Registration per l'evento includono: problemi di autenticazione, richieste non valide o troppe, impossibile crittografare o decrittare il payload o impossibile trovare il dispositivo wireless utilizzando l'ID specificato. L'esempio seguente mostra un errore di autorizzazione riscontrato durante l'elaborazione di un messaggio.

      {
    "resource": "WirelessDevice",
    "wirelessDeviceId": "cb4c087c-1be5-4990-8654-ccf543ee9fff",
    "wirelessDeviceType": "LoRaWAN",
    "event": "Uplink_Data",
    "logLevel": "ERROR",
    "message": "Cannot assume role MessageId: ef38877f-3454-4c99-96ed-5088c1cd8dee. 
    Access denied: User: arn:aws:sts::005196538709:assumed-role/DataRoutingServiceRole/6368b35fd48c445c9a14781b5d5890ed is not authorized to perform: sts:AssumeRole on resource: arn:aws:iam::400232685877:role/ExecuteRules_Role\tstatus code: 403, request id: 471c3e35-f8f3-4e94-b734-c862f63f4edb"
}

Voci dei log di dispositivo Sidewalk

Le voci di log per il dispositivo Sidewalk possono essere classificate in base ai seguenti tipi di eventi:

  • Registration

    Queste voci di registro ti aiuteranno a monitorare lo stato di tutti i dispositivi Sidewalk che stai registrando con AWS IoT Wireless. Per questo tipo di evento, se si imposta il livello di log su INFO durante la configurazione dell'interfaccia della riga di comando per la risorsa del dispositivo wireless, nei log verranno visualizzati i messaggi di log con un logLevel di INFO e ERROR. I messaggi includeranno dettagli sullo stato di avanzamento della registrazione dall'inizio al completamento. I messaggi di log ERROR conterranno informazioni su come risolvere i problemi relativi alla registrazione del dispositivo.

    Di seguito viene illustrato un esempio per un messaggio di log con livello di log di INFO. Per ulteriori informazioni su logLevel e altri campi nella voce di log, consulta Risorse AWS IoT Wireless e livelli di registro.

    {
    "resource": "WirelessDevice",
    "wirelessDeviceId": "8d0b2775-e19b-4b2a-a351-cb8a2734a504",
    "wirelessDeviceType": "Sidewalk",
    "event": "Registration",
    "logLevel": "INFO",
    "message": "Successfully completed device registration. Amazon SidewalkId = 2000000002"
}

  • Uplink_Data e Downlink_Data

    I tipi di eventi Uplink_Data e Downlink_Data per i dispositivi Sidewalk sono simili ai tipi di eventi corrispondenti per i dispositivi LoRaWAN. Per ulteriori informazioni, consulta la sezione Uplink_Data e Downlink_Data descritta in precedenza per le voci di log dei dispositivi LoRaWAN.

Passaggi successivi

Hai appreso come visualizzare le voci di registro per le risorse e le diverse voci di registro che è possibile visualizzare nella console CloudWatch dopo aver abilitato la registrazione per AWS IoT Wireless. Anche se è possibile creare flussi di filtro utilizzando Gruppi di log, ti consigliamo di utilizzare CloudWatch Insights per creare e utilizzare flussi di filtri. Per ulteriori informazioni, consultare Usa CloudWatch Insights per filtrare i log per AWS IoT Wireless.