Use o CloudWatch Insights para filtrar logs do AWS IoT Wireless

Embora você possa usar o CloudWatch Logs para criar expressões de filtro, recomendamos usar o CloudWatch Insights para criar e usar expressões de filtro com maior eficiência, conforme a sua aplicação.

Recomendamos você a usar os grupos de logs do CloudWatch primeiro para aprender sobre os diferentes tipos de recursos, seus tipos de eventos e níveis de log que podem ser usados para visualizar entradas de log no console. Você poderá, então, usar os exemplos de algumas expressões de filtro desta página como referência para criar seus próprios filtros para seus recursos do AWS IoT Wireless.

Visualização de logs do AWS IoT no console do CloudWatch Logs insights

No console do CloudWatch, os logs do CloudWatch aparecem em um grupo de logs chamado /aws/iotwireless. Para obter mais informações sobre o CloudWatch Logs, consulte CloudWatch Logs.

Visualize os logs AWS IoT no console do CloudWatch

Navegue até o console do CloudWatch e selecione Logs Insights no painel de navegação.

1. Na caixa de texto Filtro, insira /aws/iotwireless e selecione o Logs Insights /aws/iotwireless.

2. Para visualizar uma lista completa de grupos de logs, selecione Selecionar grupo(s) de logs. Para ver grupos de logs do AWS IoT Wireless, selecione /aws/iotwireless.

Você pode agora começar a inserir consultas para filtrar os grupos de logs. As seções a seguir contêm algumas consultas úteis que o ajudarão a obter informações sobre suas métricas de recursos.

Criar consultas úteis para filtrar e obter informações do AWS IoT Wireless

É possível usar expressões de filtro para exibir informações de log úteis adicionais com o CloudWatch Insights. O seguinte mostra alguns exemplos de consultas:

Mostrar apenas logs de tipos de recursos específicos

É possível criar uma consulta que o ajudará a exibir logs de tipos de recursos específicos apenas, como um gateway LoRaWAN ou um dispositivo Sidewalk. Por exemplo, para filtrar logs para exibir somente mensagens para dispositivos Sidewalk, é possível inserir a consulta a seguir e selecionar Executar consulta. Para salvar essa consulta, escolha Salvar.

fields @message
| filter @message like /Sidewalk/

Depois que a consulta for executada, você visualizará os resultados na guia Logs, que exibe os registros de data/hora dos logs relacionados aos dispositivos Sidewalk da sua conta. Você também verá um gráfico de barras mostrando a hora em que os eventos ocorreram, caso esses eventos tenham ocorrido anteriormente em relação ao seu dispositivo Sidewalk. O seguinte exibe um exemplo da expansão de um dos resultados na guia Logs. Como alternativa, se quiser solucionar erros relacionados a dispositivos Sidewalk, é possível adicionar outro filtro que defina o nível de log como ERROR e exiba somente as informações de erro.

Field	          Value
@ingestionTime      1623894967640
@log	             954314929104:/aws/iotwireless
@logStream	   WirelessDevice-Downlink_Data-715adccfb34170214ec2f6667ddfa13cb5af2c3ddfc52fbeee0e554a2e780bed
@message	     {                    
                    "resource": "WirelessDevice",
                    "wirelessDeviceId": "3b058d05-4e84-4e1a-b026-4932bddf978d",
                    "wirelessDeviceType": "Sidewalk",
                    "devEui": "feffff000000011a",
                    "event": "Downlink_Data",
                    "logLevel": "INFO",
                    "messageId": "7e752a10-28f5-45a5-923f-6fa7133fedda",
                    "message": "Successfully sent downlink message. Amazon SidewalkId = 2000000006, Sequence number = 0"
                    }
@timestamp          1623894967640
devEui	           feffff000000011a
event	        Downlink_Data
logLevel            INFO
message	          Successfully sent downlink message. Amazon SidewalkId = 2000000006, Sequence number = 0
messageId	    7e752a10-28f5-45a5-923f-6fa7133fedda
resource	     WirelessDevice
wirelessDeviceId    3b058d05-4e84-4e1a-b026-4932bddf978d
wirelessDeviceType  Sidewalk

Exibir mensagens ou eventos específicos

É possível criar uma consulta que o ajude a mostrar mensagens específicas e observar o momento de ocorrência dos eventos. Por exemplo, se quiser ver quando sua mensagem de downlink foi enviada do seu dispositivo sem fio LoRaWAN, você pode inserir a consulta a seguir e selecionar Executar consulta. Para salvar essa consulta, escolha Salvar.

filter @message like /Downlink message sent/

Quando a consulta for executada, você verá os resultados na guia Logs, que mostra os registros de data/hora em que a mensagem de downlink foi enviada com êxito para o dispositivo sem fio. Você também verá um gráfico de barras mostrando a hora em que uma mensagem de downlink foi enviada, caso outras mensagens de downlink tenham sido enviadas anteriormente para o dispositivo sem fio. O seguinte exibe um exemplo da expansão de um dos resultados na guia Logs. Alternativamente, se uma mensagem de downlink não tiver sido enviada, você pode modificar a consulta para exibir somente resultados de ocorrências em que a mensagem não foi enviada, para poder depurar o problema.

Field	          Value
@ingestionTime      1623884043676
@log	             954314929104:/aws/iotwireless
@logStream	   WirelessDevice-Downlink_Data-42d0e6d09ba4d7015f4e9756fcdc616d401cd85fe3ac19854d9fbd866153c872
@message	     {
                    "timestamp": "2021-06-16T22:54:00.770493863Z",
                    "resource": "WirelessDevice",
                    "wirelessDeviceId": "3b058d05-4e84-4e1a-b026-4932bddf978d",
                    "wirelessDeviceType": "LoRaWAN",
                    "devEui": "feffff000000011a",
                    "event": "Downlink_Data",
                    "logLevel": "INFO",
                    "messageId": "7e752a10-28f5-45a5-923f-6fa7133fedda",
                    "message": "Downlink message sent. MessageId: 7e752a10-28f5-45a5-923f-6fa7133fedda"
                    }
@timestamp          1623884040858
devEui	           feffff000000011a
event	        Downlink_Data
logLevel            INFO
message	          Downlink message sent. MessageId: 7e752a10-28f5-45a5-923f-6fa7133fedda
messageId	    7e752a10-28f5-45a5-923f-6fa7133fedda
resource	     WirelessDevice
timestamp	    2021-06-16T22:54:00.770493863Z
wirelessDeviceId    3b058d05-4e84-4e1a-b026-4932bddf978d
wirelessDeviceType  LoRaWAN

Próximas etapas

Você aprendeu como usar o CloudWatch Insights para obter mais informações úteis com a criação de consultas para filtrar mensagens de log. Você pode combinar alguns dos filtros descritos anteriormente e desenvolver seus próprios filtros, conforme o recurso que estiver monitorando. Para obter mais informações sobre como usar o CloudWatch Insights, consulte Analisar dados de log com o CloudWatch Insights.

Após criar consultas com o CloudWatch Insights, se você as salvou, é possível carregar e executar as consultas salvas conforme necessário. Como alternativa, se clicar no botão Histórico no console do CloudWatch Logs Insights, você poderá visualizar as consultas executadas anteriormente e executá-las novamente conforme necessário ou modificá-las ainda mais criando consultas adicionais.