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 AWS Management Console, 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.

• 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.

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 e escolha a configuração do analisador de rede, NetworkAnalyzerConfig_Default.

2. 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.

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_Data, Downlink_Data 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 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, 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.