Visualizzazione e monitoraggio in tempo reale dei registri dei messaggi di tracciamento dell'analizzatore

Se hai aggiunto risorse alla configurazione dell'analizzatore di rete, puoi attivare la messaggistica di traccia per iniziare a ricevere messaggi di traccia per le tue risorse. È possibile utilizzare il AWS Management Console, l'API AWS IoT Wireless o la AWS CLI.

Prerequisiti

Prima di poter attivare la messaggistica di traccia utilizzando l'analizzatore di rete, devi aver:

• Aggiunto le risorse che vuoi far monitorare alla configurazione predefinita dell'analizzatore di rete. Per ulteriori informazioni, consultare Aggiunta di risorse e aggiornamento della configurazione dell'analizzatore di rete.

• Generato una richiesta prefirmata utilizzando l'URL della richiesta StartNetworkAnalyzerStream. La richiesta verrà firmata utilizzando le credenziali per il ruolo AWS Identity and Access Management che fa questa richiesta. Per ulteriori informazioni, consultare Creare un URL prefirmato.

Attiva la messaggistica di traccia utilizzando la console

Per attivare la messaggistica di traccia

1. Apri l'hub dell'analizzatore di rete della console AWS IoT e scegli la configurazione dell'analizzatore di rete, Network AnalyzerConfig_Default.

2. Nella pagina dei dettagli della configurazione dell'analizzatore di rete, scegli Attiva la messaggistica di traccia quindi scegli Attivare.

   Inizierai a ricevere messaggi di traccia in cui viene visualizzato per primo il messaggio di traccia più recente nella console.

   Nota

   Dopo l'avvio della sessione di messaggistica, la ricezione di messaggi di traccia può comportare costi aggiuntivi fino a quando non si disattiva la sessione o si lascia la sessione di traccia. Per ulteriori informazioni sui prezzi, consulta Prezzi di AWS IoT Core.

Visualizza e monitora i messaggi di traccia

Dopo aver attivato la messaggistica di traccia, viene stabilita la connessione WebSocket e i messaggi di traccia iniziano a comparire in tempo reale, prima i più recenti. È possibile personalizzare le preferenze per specificare il numero di messaggi di traccia da visualizzare in ogni pagina e visualizzare solo i campi pertinenti per ciascun messaggio. Ad esempio, è possibile personalizzare il registro dei messaggi di traccia per mostrare solo i registri per le risorse del gateway wireless che hanno Livello di log impostato su ERROR, in modo da poter identificare ed eseguire il debug rapidamente degli errori con i gateway. I messaggi di traccia contengono le informazioni seguenti.

• Numero messaggio: un numero univoco che mostra per primo l'ultimo messaggio ricevuto.

• ID risorsa: Il gateway wireless o l'ID del dispositivo wireless della risorsa.

• Timestamp: L'ora in cui il messaggio è stato ricevuto.

• ID messaggio: un identificatore che AWS IoT Core per LoRaWAN assegna a ciascun messaggio ricevuto.

• FPort: La porta di frequenza per comunicare con il dispositivo utilizzando la connessione WebSocket.

• DevEui: Identificatore univoco esteso (EUI) per il dispositivo wireless.

• Risorsa: Se la risorsa monitorata è un dispositivo wireless o un gateway wireless.

• Evento: evento per un messaggio di registro per un dispositivo wireless, che può essere Unisciti, Unisciti di nuovo, Uplink_Data, Downlink_Data, oppure Registrazione.

• Livello di log:Informazioni su flussi di log di INFO o ERROR per il tuo dispositivo.

Messaggio di log JSON dell'analizzatore di rete

È inoltre possibile scegliere un messaggio di traccia alla volta per visualizzare il payload JSON per quel messaggio. A seconda del messaggio selezionato nei registri dei messaggi di traccia, verranno visualizzate le informazioni nel payload JSON che indica che contiene 2 parti: Customerlog e LoRaFrame.

CustomerLog

La parte CustomerLog del JSON visualizza il tipo e l'identificatore della risorsa che ha ricevuto il messaggio, il livello di registro e il contenuto del messaggio. Nell'esempio seguente viene mostrato un messaggio di log CustomerLog . Puoi utilizzare il campo message nel JSON per ottenere ulteriori informazioni sull'errore e su come può essere risolto.

LoRaFrame

La parte LoRaFrame del JSON ha un Messaggio ID e contiene informazioni sul payload fisico per il dispositivo e i metadati wireless.

Il seguente esempio illustra la struttura del messaggio di traccia.

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;
  },
};

Revisione e passaggi successivi

In questa sezione, hai visualizzato i messaggi di traccia e hai appreso come utilizzare le informazioni per eseguire il debug degli errori. Dopo aver visualizzato tutti i messaggi, è possibile:

• Disattivare i messaggi di traccia

  Per evitare costi aggiuntivi, è possibile disattivare la sessione di messaggistica di traccia. La disattivazione della sessione disconnette la connessione WebSocket in modo da non ricevere alcun messaggio di traccia aggiuntivo. È comunque possibile continuare a visualizzare i messaggi esistenti nella console.

• Modifica le informazioni sul frame per la tua configurazione

  È possibile modificare la configurazione dell'analizzatore di rete e scegliere se disattivare le informazioni sui frame e scegliere i livelli di registro per i messaggi. Prima di aggiornare la configurazione, prendi in considerazione la possibilità di disattivare la sessione di messaggistica di traccia. Per apportare queste modifiche, apri la Pagina dei dettagli dell'analizzatore di rete nella console AWS IoT e scegli Modificare. È quindi possibile aggiornare la configurazione con le nuove impostazioni di configurazione e attivare la messaggistica di traccia per visualizzare i messaggi aggiornati.

• Aggiungere risorse alla configurazione

  È inoltre possibile aggiungere altre risorse alla configurazione dell'analizzatore di rete e monitorarle in tempo reale. È possibile aggiungere fino a un totale di 250 risorse wireless gateway e dispositivi wireless combinati. Per aggiungere risorse, sulla Pagina dei dettagli dell'analizzatore di reye della console AWS IoT, scegli la scheda Risorse e scegli Aggiungere risorse. È quindi possibile aggiornare la configurazione con le nuove risorse e attivare la messaggistica di traccia per visualizzare i messaggi aggiornati per le risorse aggiuntive.

Per ulteriori informazioni sull'aggiornamento della configurazione dell'analizzatore di rete modificando le impostazioni di configurazione e l'aggiunta di risorse, consultare Aggiunta di risorse e aggiornamento della configurazione dell'analizzatore di rete.