# Visualizzazione e monitoraggio in tempo reale dei registri dei messaggi di tracciamento dell'analizzatore
<a name="network-analyzer-logs"></a>

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 Console di gestione AWS, l'API Wireless AWS IoT o la AWS CLI.

## Prerequisiti
<a name="network-analyzer-logs-prereq"></a>

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](network-analyzer-resources.md).
+ 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](network-analyzer-generate-request.md#network-analyzer-presigned-url).

## Attiva la messaggistica di traccia utilizzando la console
<a name="network-analyzer-activate-console"></a>

Per attivare la messaggistica di traccia

1. Apri l'[hub dell'analizzatore di rete della console AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) e scegli la configurazione dell'analizzatore di rete, **Network AnalyzerConfig\$1Default**.

1. 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](https://aws.amazon.com/iot-core/pricing/).

## Visualizza e monitora i messaggi di traccia
<a name="network-analyzer-view-trace"></a>

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\$1Data**, **Downlink\$1Data**, 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
<a name="connect-iot-network-analyzer-trace-logs"></a>

È 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
<a name="network-analyzer-review"></a>

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](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer/details/NetworkAnalyzerConfig_Default) 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](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer/details/NetworkAnalyzerConfig_Default), 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](network-analyzer-resources.md).