# Visualize e monitore os logs de mensagens de rastreamento do analisador de rede em tempo real Se adicionou recursos à configuração do analisador de rede, você pode ativar as mensagens de rastreamento para começar a receber mensagens de rastreamento para seus recursos. É possível utilizar o Console de gerenciamento da AWS, a API do AWS IoT Wireless ou a AWS CLI. ## Pré-requisitos Antes de ativar o rastreamento de mensagens usando o analisador de rede, você deve ter: + Adicionado os recursos que deseja monitorar à configuração padrão do analisador de rede. Para ter mais informações, consulte [Adicionar recursos e atualizar a configuração do analisador de rede](network-analyzer-resources.md). + Gerado uma solicitação pré-assinada usando o URL da solicitação `StartNetworkAnalyzerStream`. A solicitação será assinada usando as credenciais do perfil do AWS Identity and Access Management que faz essa solicitação. Para ter mais informações, consulte [Criar um URL pré-assinado](network-analyzer-generate-request.md#network-analyzer-presigned-url). ## Ativado o rastreamento de mensagens usando o console Para ativar o rastreamento de mensagens 1. Abra o [Hub do analisador de rede do console de AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) e escolha a configuração do analisador de rede, **NetworkAnalyzerConfig\$1Default**. 1. Na página de detalhes da configuração do analisador de rede, escolha **Ativar rastreamento de mensagens** e, em seguida, escolha **Ativar**. Você começará a receber mensagens de rastreamento quando a mensagem de rastreamento mais recente aparecer primeiro no console. **nota** Após o início da sessão de mensagens, o recebimento de mensagens de rastreamento pode gerar custos adicionais até que você desative a sessão ou saia da sessão de rastreamento. Para obter mais informações sobre a definição de preço, consulte [Definição de preço do AWS IoT Core](https://aws.amazon.com/iot-core/pricing/). ## Visualizar e monitorar mensagens de rastreamento Depois de ativar o rastreamento de mensagens, a conexão do WebSocket é estabelecida e as mensagens de rastreamento começam a aparecer em tempo real, primeiro as mais recentes. Você pode personalizar as preferências para especificar o número de mensagens de rastreamento a serem exibidas em cada página e exibir somente os campos relevantes para cada mensagem. Por exemplo, você pode personalizar o log de mensagens de rastreamento para mostrar somente logs de recursos de gateway sem fio que tenham o **Nível de log** definido como `ERROR`, para que você possa identificar e depurar erros com rapidez com seus gateways. As mensagens de rastreamento contêm as seguintes informações: + **Número da mensagem**: um número exclusivo que mostra a última mensagem recebida primeiro. + **ID do recurso**: o gateway sem fio ou ID do dispositivo sem fio do recurso. + **Carimbo de data/hora**: a hora em que a mensagem foi recebida. + **ID da mensagem**: um identificador que o AWS IoT Core for LoRaWAN atribui a cada mensagem recebida. + **FPort**: a porta de frequência para comunicação com o dispositivo usando a conexão WebSocket. + **DevEui**: o identificador exclusivo estendido (EUI) para o dispositivo sem fio. + **Recurso**: se o recurso monitorado é um dispositivo sem fio ou um gateway sem fio. + **Evento**: o evento de uma mensagem de log para um dispositivo sem fio, que pode ser **Join**, **Rejoin**, **Uplink\$1Data**, **Downlink\$1Data** ou **Registration**. + **Nível de log**: informações sobre os fluxos de logs `INFO` ou `ERROR` para o dispositivo. ## Mensagem de log JSON do analisador de rede Você também pode escolher uma mensagem de rastreamento por vez para visualizar a carga útil JSON dessa mensagem. Dependendo da mensagem selecionada nos logs de mensagens de rastreamento, você verá informações na carga útil JSON que indicam que há duas partes: **CustomerLog** e **LoRaFrame**. **CustomerLog** A parte **CustomerLog** do JSON exibe o tipo e o identificador do recurso que recebeu a mensagem, o nível do log e o conteúdo da mensagem. O exemplo a seguir mostra uma mensagem de log **CustomerLog**. Você pode usar o campo `message` no JSON para obter mais informações sobre o erro e como ele pode ser resolvido. **LoRaFrame** A parte **LoRaFrame** do JSON tem um **ID de mensagem** e contém informações sobre a carga útil física do dispositivo e os metadados sem fio. O exemplo a seguir mostra a estrutura da mensagem de rastreamento. ``` export type TraceMessage = { ResourceId: string; Timestamp: string; LoRaFrame: { MessageId: string; PhysicalPayload: any; WirelessMetadata: { fPort: number; dataRate: number; devEui: string; frequency: number, timestamp: string; }, } CustomerLog: { resource: string; wirelessDeviceId: string; wirelessDeviceType: string; event: string; logLevel: string; messageId: string; message: string; }, }; ``` ## Revisão e próximas etapas Nesta seção, você visualizou mensagens de rastreamento e aprendeu como usar as informações para depurar erros. Depois de ver todas as mensagens, você pode: + **Desativar o rastreamento de mensagens** Para evitar custos adicionais, você pode desativar a sessão de rastreamento de mensagens. A desativação da sessão desconecta a conexão WebSocket para que você não receba nenhuma mensagem de rastreamento adicional. Você ainda pode continuar a visualizar as mensagens existentes no console. + **Edite as informações do quadro para a configuração** Você pode editar a configuração do analisador de rede e escolher se deseja desativar as informações do quadro e escolher os níveis de log para suas mensagens. Antes de atualizar a configuração, considere desativar a sessão de rastreamento de mensagens. Para fazer essas edições, abra a [página de detalhes do analisador de rede no console de AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer/details/NetworkAnalyzerConfig_Default) e escolha **Editar**. Em seguida, você pode atualizar a configuração com as novas definições de configuração e ativar o rastreamento de mensagens para ver as mensagens atualizadas. + **Adicionar recursos à configuração** Você também pode adicionar mais recursos à configuração do analisador de rede e monitorá-los em tempo real. Você pode adicionar um total combinado de 250 recursos de gateway sem fio e dispositivo sem fio. Para adicionar recursos, na [página de detalhes do analisador de rede do console de AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer/details/NetworkAnalyzerConfig_Default), escolha a guia **Recursos** e **Adicionar recursos**. Em seguida, você pode atualizar a configuração com os novos recursos e ativar o rastreamento de mensagens para ver as mensagens atualizadas dos recursos adicionais. Para obter mais informações sobre como atualizar a configuração do analisador de rede editando as definições de configuração e adicionando recursos, consulte [Adicionar recursos e atualizar a configuração do analisador de rede](network-analyzer-resources.md).