# 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](https://console.aws.amazon.com/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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html).
**Visualize os logs AWS IoT no console do CloudWatch**
Navegue até o [console do CloudWatch](https://console.aws.amazon.com/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`.
1. 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData).
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.