Entradas de registro para recursos de puertas de enlace inalámbricas y dispositivos inalámbricos - AWS IoT Wireless
Entradas de registro de puerta de enlace inalámbricaEntradas de registro de dispositivos inalámbricos

Entradas de registro para recursos de puertas de enlace inalámbricas y dispositivos inalámbricos

Una vez que haya activado el registro, podrá ver las entradas de registro de sus puertas de enlace inalámbricas y dispositivos inalámbricos. En la siguiente sección se describen los distintos tipos de entradas de registro en función de los tipos de recursos y eventos.

Entradas de registro de puerta de enlace inalámbrica

En esta sección se muestran algunos ejemplos de entradas de registro para los recursos de puerta de enlace inalámbrica que verá en la consola de CloudWatch. Estos mensajes de registro pueden tener el tipo de evento CUPS_Request o Certificate, y se pueden configurar para que muestren un nivel de registro INFO, ERROR o DISABLED a nivel de recursos o eventos. Si solo desea ver la información sobre los errores, defina el nivel de registro en ERROR. El mensaje de la entrada de registro de ERROR contendrá información sobre el motivo del error.

Las entradas de registro de su recurso de puerta de enlace inalámbrica se pueden clasificar en función de los siguientes tipos de eventos:

  • CUPS_request

    El software LoRa Basics Station que se ejecuta en su puerta de enlace envía periódicamente una solicitud de actualizaciones al servidor de configuración y actualización (CUPS). Para este tipo de evento, si establece el nivel de registro en INFO al configurar la CLI para su recurso de puerta de enlace inalámbrica, en los registros sucede lo siguiente:

    • Si el evento se realiza correctamente, verá los mensajes de registro que tienen un logLevel de INFO. Los mensajes incluirán detalles sobre la respuesta de CUPS enviada a su puerta de enlace y los detalles de la puerta de enlace. A continuación se muestra un ejemplo de esta entrada de registro. Para obtener más información sobre logLevel y otros campos de la entrada de registro, consulte Recursos y niveles de registro de AWS IoT Wireless.

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

    • Si se produce un error, verá las entradas de registro con un logLevel de ERROR y los mensajes incluirán detalles sobre el error. Algunos ejemplos de cuándo puede producirse un error para el evento CUPS_Request son: falta el CRC de CUPS, no coincide el TC Uri de la puerta de enlace con AWS IoT Core para LoRaWAN, falta IoTWirelessGatewayCertManagerRole o no se puede obtener el registro de la puerta de enlace inalámbrica. El siguiente ejemplo muestra una entrada de registro CRC que falta. Para resolver el error, compruebe la configuración de la puerta de enlace para verificar que ha introducido el CRC de CUPS correcto.

      {
    "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,"
}
  • Certificate

    Estas entradas de registro le ayudarán a comprobar si su puerta de enlace inalámbrica presentó el certificado correcto para autenticar la conexión a AWS IoT. Para este tipo de evento, si establece el nivel de registro en INFO al configurar la CLI para su recurso de puerta de enlace inalámbrica, en los registros sucede lo siguiente:

    • Si el evento se realiza correctamente, verá los mensajes de registro que tienen un logLevel de INFO. Los mensajes incluirán detalles sobre el ID del certificado y el identificador de la puerta de enlace inalámbrica. A continuación se muestra un ejemplo de esta entrada de registro. Para obtener más información sobre logLevel y otros campos de la entrada de registro, consulte Recursos y niveles de registro de AWS IoT Wireless.

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

    • Si se produce un error, verá las entradas de registro con un logLevel de ERROR y los mensajes incluirán detalles sobre el error. Algunos ejemplos de casos en los que se puede producir un error en relación con este evento Certificate son un ID de certificado no válido, un identificador de puerta de enlace inalámbrica o una discrepancia entre el identificador de puerta de enlace inalámbrica y el ID del certificado. El siguiente ejemplo muestra un ERROR debido a un identificador de puerta de enlace inalámbrica que no es válido. Para resolver el error, compruebe los identificadores de puerta de enlace.

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

Entradas de registro de dispositivos inalámbricos

En esta sección se muestran algunos ejemplos de entradas de registro para los recursos de dispositivo inalámbrico que verá en la consola de CloudWatch. El tipo de evento de estos mensajes de registro depende de si utiliza un dispositivo LoRaWAN o Sidewalk. Cada tipo de evento o recurso de dispositivo inalámbrico se puede configurar para mostrar un nivel de registro de INFO, ERROR o DISABLED.

nota

Su solicitud no debe contener metadatos inalámbricos de LoRaWAN y Sidewalk al mismo tiempo. Para evitar una entrada de registro de ERROR en este escenario, especifique los datos inalámbricos de LoRaWAN o Sidewalk.

Entradas de registro de dispositivos LoRaWAN

Las entradas de registro de su dispositivo inalámbrico LoRaWAN pueden clasificarse en función de los siguientes tipos de evento:

  • Join y Rejoin

    Cuando agrega un dispositivo LoRaWAN y lo conecta a AWS IoT Core para LoRaWAN, antes de que su dispositivo pueda enviar datos de enlace ascendente, debe completar un proceso llamado activation o join procedure. Para obtener más información, consulte Agregue su dispositivo inalámbrico a AWS IoT Core para LoRaWAN.

    Para este tipo de evento, si establece el nivel de registro en INFO al configurar la CLI para su recurso de puerta de enlace inalámbrica, en los registros sucede lo siguiente:

    • Si el evento se realiza correctamente, verá los mensajes de registro que tienen un logLevel de INFO. Los mensajes incluirán detalles sobre el estado de su solicitud para unirse o volver a unirse. A continuación se muestra un ejemplo de esta entrada de registro. Para obtener más información sobre logLevel y otros campos de la entrada de registro, consulte Recursos y niveles de registro de AWS IoT Wireless.

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

    • Si se produce un error, verá las entradas de registro con un logLevel de ERROR y los mensajes incluirán detalles sobre el error. Algunos ejemplos de casos en los que se puede producir un error en los eventos Join y Rejoin son una configuración de región LoRaWAN no válida o una comprobación del código de integridad de los mensajes (MIC) no válida. El siguiente ejemplo muestra un error de unión debido a una comprobación del MIC. Para resolver el error, compruebe si ha introducido las claves raíz correctas.

      {
    "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 y Downlink_Data

    El tipo de evento Uplink_Data se utiliza para los mensajes generados por AWS IoT Wireless cuando se envía la carga desde el dispositivo LoRaWAN o Sidewalk a AWS IoT. El tipo de evento Downlink_Data se utiliza para los mensajes relacionados con los mensajes de enlace descendente que se envían desde AWS IoT al dispositivo inalámbrico.

    Para este tipo de evento, si establece el nivel de registro en INFO al configurar la CLI para sus dispositivos inalámbricos, entonces en los registros verá:

    • Si el evento se realiza correctamente, verá los mensajes de registro que tienen un logLevel de INFO. Los mensajes incluirán detalles sobre el estado del mensaje de enlace ascendente o descendente que se envió y el identificador del dispositivo inalámbrico. A continuación se muestra un ejemplo de esta entrada de registro para un dispositivo Sidewalk. Para obtener más información sobre logLevel y otros campos de la entrada de registro, consulte Recursos y niveles de registro de AWS IoT Wireless.

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

    • Si se produce un error, verá las entradas de registro con un logLevel de ERROR y los mensajes incluirán detalles sobre el error, lo que le ayudará a resolverlo. Algunos ejemplos de casos en los que se puede producir un error en este tipo de eventos Registration son: problemas de autenticación, solicitudes no válidas o demasiadas, incapacidad para cifrar o descifrar la carga o no poder encontrar el dispositivo inalámbrico con el identificador especificado. El siguiente ejemplo muestra un error de permiso que se produjo al procesar un mensaje.

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

Entradas de registro de dispositivos de Sidewalk

Las entradas de registro de su dispositivo Sidewalk pueden clasificarse en función de los siguientes tipos de evento:

  • Registration

    Estas entradas de registro te ayudarán a supervisar el estado de cualquier dispositivo Sidewalk que esté registrando con AWS IoT Wireless. Para este tipo de evento, si establece el nivel de registro en INFO cuando configure la CLI para el recurso de su dispositivo inalámbrico, entonces en los registros verá mensajes de registro que tienen un logLevel de INFO y ERROR. Los mensajes incluirán detalles sobre el progreso del registro desde el principio hasta su finalización. Los mensajes de registro de ERROR contendrán información sobre cómo solucionar problemas de registro del dispositivo.

    A continuación se muestra un ejemplo de un mensaje de registro con un nivel de registro de INFO. Para obtener más información sobre logLevel y otros campos de la entrada de registro, consulte Recursos y niveles de registro de AWS IoT Wireless.

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

    Los tipos de eventos Uplink_Data y Downlink_Data para los dispositivos Sidewalk son similares a los tipos de eventos correspondientes para los dispositivos LoRaWAN. Para obtener más información, consulte las secciones Uplink_Data y Downlink_Data descritas anteriormente para las entradas de registro de los dispositivos LoRaWAN.

Siguientes pasos

Ha aprendido a ver las entradas de registro de sus recursos y las diferentes entradas de registro que puede consultar en la consola de CloudWatch después de activar el registro de AWS IoT Wireless. Aunque es posible flujos de filtrado mediante grupos de registros, le recomendamos que utilice CloudWatch Insights para crear y utilizar flujos de filtrado. Para obtener más información, consulte Utilización de CloudWatch Insights para filtrar registros de AWS IoT Wireless.