Entradas de log para recursos de gateways sem fio e dispositivos sem fio - AWS IoT Wireless
Entradas de log de gateway sem fioEntradas de log de dispositivo sem fio

Entradas de log para recursos de gateways sem fio e dispositivos sem fio

Após habilitar o registro em log, é possível visualizar as entradas de log de gateways sem fio e dispositivos sem fio. A seção a seguir descreve os vários tipos de entradas de log com base em seus tipos de recursos e eventos.

Entradas de log de gateway sem fio

Esta seção mostra alguns exemplos de entradas de log para recursos de gateway sem fio que você encontrará no console do CloudWatch. Essas mensagens de log podem ter o tipo de evento CUPS_Request ou Certificate e podem ser configuradas para exibir um nível de log de INFO, ERROR ou DISABLED no nível do recurso ou no nível do evento. Se quiser ver somente as informações de erro, defina o nível do log como ERROR. A mensagem na entrada de log ERROR conterá informações sobre o motivo da falha.

As entradas de log de um recurso de gateway sem fio podem ser classificadas com base nos seguintes tipos de eventos:

  • CUPS_Request

    A LoRa Basics Station em execução no seu gateway envia uma solicitação periódica ao Servidor de Configuração e Atualização (CUPS) para obter atualizações. Para esse tipo de evento, se você definir o nível de log como INFO quando configurar a CLI para seu recurso de gateway sem fio, então, nos logs:

    • Se o evento obtiver êxito, você verá mensagens de log com um logLevel de INFO. As mensagens incluirão detalhes da resposta do CUPS enviada ao seu gateway e os detalhes do gateway. O seguinte mostra um exemplo dessa entrada de log. Para acessar mais informações sobre o logLevel e outros campos da entrada de log, consulte Recursos e níveis de log do 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,"
}

    • Caso haja um erro, você verá entradas de log com um logLevel de ERROR e as mensagens incluirão detalhes sobre o erro. Exemplos de quando um erro pode ocorrer no evento CUPS_Request incluem: falta de CRC do CUPS, incompatibilidade no Uri do TC do gateway com AWS IoT Core for LoRaWAN, ausência de IoTWirelessGatewayCertManagerRole ou impossibilidade de obter o registro do gateway sem fio. O exemplo a seguir mostra uma entrada de log CRC. Para solucionar o erro, cheque a configuração do gateway para verificar se você inseriu o CRC do CUPS correto.

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

    Essas entradas de log ajudarão você a verificar se o gateway sem fio apresentou o certificado correto para autenticar a conexão ao AWS IoT. Para esse tipo de evento, se você definir o nível de log como INFO quando configurar a CLI para seu recurso de gateway sem fio, então, nos logs:

    • Se o evento obtiver êxito, você verá mensagens de log com um logLevel de INFO. As mensagens incluirão detalhes do ID do certificado e do identificador do gateway sem fio. O seguinte mostra um exemplo dessa entrada de log. Para acessar mais informações sobre o logLevel e outros campos da entrada de log, consulte Recursos e níveis de log do 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)"
}

    • Caso haja um erro, você verá entradas de log com um logLevel de ERROR e as mensagens incluirão detalhes sobre o erro. Exemplos de quando um erro pode ocorrer no evento Certificate incluem um ID de certificado inválido, um identificador de gateway sem fio ou uma incompatibilidade entre o identificador de gateway sem fio e o ID do certificado. O exemplo a seguir exibe um ERROR devido a um identificador de gateway sem fio inválido. Para solucionar o erro, verifique os identificadores do 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)"
}

Entradas de log de dispositivo sem fio

Esta seção mostra alguns exemplos de entradas de log para recursos de dispositivo sem fio que você encontrará no console do CloudWatch. O tipo de evento dessas mensagens de log depende se você está usando um dispositivo LoRaWAN ou Sidewalk. Cada recurso de dispositivo sem fio ou tipo de evento pode ser configurado para exibir um nível de log de INFO, ERROR ou DISABLED.

nota

Sua solicitação não pode possuir metadados sem fio de LoRaWAN e Sidewalk ao mesmo tempo. Para evitar uma entrada de log de ERROR para esse cenário, especifique os dados sem fio LoRaWAN ou Sidewalk.

Entradas de log de dispositivo LoRaWAN

As entradas de log de um dispositivo sem fio LoRaWAN podem ser classificadas com base nos seguintes tipos de eventos:

  • Join e Rejoin

    Quando você adicionar um dispositivo LoRaWAN e conectá-lo ao AWS IoT Core for LoRaWAN, antes que seu dispositivo possa enviar dados de uplink, você deve concluir um processo chamado activation ou join procedure. Para ter mais informações, consulte Adicione o dispositivo sem fio ao AWS IoT Core for LoRaWAN.

    Para esse tipo de evento, se você definir o nível de log como INFO quando configurar a CLI para seu recurso de gateway sem fio, então, nos logs:

    • Se o evento obtiver êxito, você verá mensagens de log com um logLevel de INFO. As mensagens incluirão detalhes do status de sua solicitação de adesão ou reingresso. O seguinte mostra um exemplo dessa entrada de log. Para acessar mais informações sobre o logLevel e outros campos da entrada de log, consulte Recursos e níveis de log do 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"
}

    • Caso haja um erro, você verá entradas de log com um logLevel de ERROR e as mensagens incluirão detalhes sobre o erro. Exemplos de quando um erro pode ocorrer nos eventos Join e Rejoin incluem a configuração inválida da região LoRaWAN ou verificação inválida do Código de Integridade da Mensagem (MIC). O exemplo a seguir exibe um erro de adesão devido à verificação do MIC. Para solucionar o erro, verifique se você inseriu as chaves raiz corretas.

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

    O tipo de evento Uplink_Data é utilizado para mensagens geradas pelo AWS IoT Wireless quando a carga útil é enviada do dispositivo LoRaWAN ou Sidewalk ao AWS IoT. O tipo de evento Downlink_Data é usado para mensagens relacionadas a mensagens de downlink enviadas do AWS IoT para um dispositivo sem fio.

    Para esse tipo de evento, se você definir o nível de log como INFO quando configurar a CLI para seus dispositivos sem fio, então, nos logs, você verá:

    • Se o evento obtiver êxito, você verá mensagens de log com um logLevel de INFO. As mensagens incluirão detalhes do status da mensagem de uplink ou downlink enviada e do identificador do dispositivo sem fio. O seguinte mostra um exemplo dessa entrada de log para um dispositivo Sidewalk. Para acessar mais informações sobre o logLevel e outros campos da entrada de log, consulte Recursos e níveis de log do 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\"}"
}

    • Caso haja um erro, você verá entradas de log com um logLevel de ERROR e as mensagens incluirão detalhes sobre o erro, o que ajudará você a resolvê-lo. Exemplos de quando um erro pode ocorrer para o evento Registration incluem: problemas de autenticação, solicitações inválidas ou em número muito elevado, incapacidade de criptografar ou descriptografar a carga ou incapacidade de encontrar o dispositivo sem fio usando o ID especificado. O exemplo a seguir exibe um erro de permissão encontrado durante o processamento de uma mensagem.

      {
    "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 log de dispositivo Sidewalk

As entradas de log de um dispositivo Sidewalk podem ser classificadas com base nos seguintes tipos de eventos:

  • Registration

    Essas entradas de log ajudarão você a monitorar o status de qualquer dispositivo Sidewalk que você esteja se registrando no AWS IoT Wireless. Para esse tipo de evento, se você definir o nível de log como INFO ao configurar a CLI para seu recurso de dispositivo sem fio, então, nos logs, você verá mensagens de log com um logLevel de INFO e ERROR. As mensagens incluirão detalhes do progresso de registro, do início até a conclusão. As mensagens de log ERROR conterão informações sobre como solucionar problemas com o registro do dispositivo.

    O seguinte mostra um exemplo de uma mensagem de log com nível de log de INFO. Para acessar mais informações sobre o logLevel e outros campos da entrada de log, consulte Recursos e níveis de log do 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 e Downlink_Data

    Os tipos de eventos Uplink_Data e Downlink_Data para dispositivos Sidewalk se assemelham aos tipos de eventos correspondentes para dispositivos LoRaWAN. Para obter mais informações, consulte a seção Uplink_Data e Downlink_Data descrita anteriormente para entradas de log de dispositivos LoRaWAN.

Próximas etapas

Você aprendeu a visualizar as entradas de log de recursos e as diferentes entradas de log que podem ser visualizadas no console do CloudWatch depois de ativar o registro em log do AWS IoT Wireless. Embora possa criar fluxos de filtros usando grupos de logs, recomendamos que você use o CloudWatch Insights para criar e usar fluxos de filtro. Para ter mais informações, consulte Use o CloudWatch Insights para filtrar logs do AWS IoT Wireless.