Creazione di una configurazione dell'analizzatore di rete

Prima di poter monitorare i gateway wireless o i dispositivi wireless, è necessario creare una configurazione dell'analizzatore di rete. Quando crei la configurazione, devi solo specificare un nome per la configurazione. Puoi personalizzare le impostazioni di configurazione e aggiungere alla configurazione le risorse che vuoi monitorare anche dopo la creazione. Le impostazioni di configurazione determinano le informazioni della messaggistica di traccia che ricevi per tali risorse.

A seconda delle risorse che vuoi monitorare e del livello di informazioni che desideri ricevere, puoi creare più configurazioni. Ad esempio, puoi creare una configurazione che visualizza solo le informazioni di errore per un set di gateway del tuo Account AWS. Puoi anche creare una configurazione che visualizza tutte le informazioni su un dispositivo wireless che vuoi monitorare.

Le sezioni seguenti mostrano le varie impostazioni di configurazione e come creare la configurazione.

Impostazioni di configurazione

Quando crei o aggiorni la configurazione dell'analizzatore di rete, puoi anche personalizzare i seguenti parametri per filtrare le informazioni sul flusso di registro.

• Informazioni sul frame

  Questa impostazione è l'informazione del frame per le risorse del dispositivo wireless per i messaggi di traccia. Le informazioni del frame possono essere utilizzate per eseguire il debug della comunicazione tra il server di rete e i dispositivi finali. È abilitato per impostazione predefinita.

• Livelli di log

  È possibile visualizzare i registri di informazioni o errori oppure disattivare la registrazione.

  • Info

    I registri con un livello di registro Informazioni sono più dettagliati e contengono i flussi di registro che sono informativi e contengono errori. I registri informativi possono essere utilizzati per visualizzare le modifiche allo stato di un dispositivo o di un gateway.

    Nota

    La raccolta di flussi di log più dettagliati può comportare costi aggiuntivi. Per ulteriori informazioni sui prezzi, consulta Prezzi di AWS IoT Core.

  • Errore

    Registri con un livello di log di Errore sono meno dettagliati e mostrano solo le informazioni sugli errori. È possibile utilizzare questi registri quando un'applicazione presenta un errore, ad esempio un errore di connessione del dispositivo. Utilizzando le informazioni del flusso di log, è possibile identificare e risolvere gli errori relativi alle risorse del parco istanze.

Creazione di una configurazione utilizzando la console

È possibile creare una configurazione dell'analizzatore di rete e personalizzare i parametri opzionali utilizzando la console AWS IoT o l'API AWS IoT Wireless. Inoltre è possibile creare più configurazioni e successivamente eliminare le configurazioni che non vengono più utilizzate.

Creazione di una configurazione dell'analizzatore di rete

1. Apri l'hub dell'analizzatore di rete della console AWS IoT e scegli Crea configurazione.

2. Specifica le impostazioni di configurazione.

   • Nome, descrizione e tag

     Specifica un nome per la configurazione univoco che contenga solo lettere, numeri, trattini o caratteri di sottolineatura. Utilizza il campo Description (Descrizione) per fornire informazioni sulla configurazione e il campo Tags (Tag) per aggiungere coppie chiave-valore di metadati sulla configurazione. Per ulteriori informazioni sulla denominazione e sulla descrizione delle risorse, consulta Descrizione delle risorse AWS IoT Wireless.

   • Impostazioni di configurazione

     Scegli se disabilitare le informazioni del frame e utilizzare Select log levels (Seleziona i livelli di registro) per scegliere i livelli di registro da usare per i registri dei messaggi di traccia. Seleziona Avanti.

3. Aggiungi le risorse alla configurazione. Puoi aggiungere le tue risorse ora o scegliere Create (Crea) e aggiungerle in un secondo momento. Per aggiungere le risorse in un secondo momento, scegli Create (Crea).

   Nella pagina dell'hub dell'analizzatore di rete viene visualizzata la configurazione creata insieme alle relative impostazioni. Per visualizzare i dettagli della nuova configurazione, scegli il nome della configurazione.

Eliminazione della configurazione dell'analizzatore di rete

È possibile creare più configurazioni dell'analizzatore di rete a seconda delle risorse che vuoi monitorare e del livello di informazioni sulla messaggistica di traccia che vuoi ricevere.

Per rimuovere le configurazioni dalla console

1. Apri l'hub dell'analizzatore di rete della console AWS IoT e scegli la configurazione che vuoi rimuovere.

2. Scegli Actions (Operazioni), quindi Delete (Elimina).

Creazione di una configurazione utilizzando l'API

Per creare una configurazione dell'analizzatore di rete con l'API, utilizza l'operazione API CreateNetworkAnalyzerConfiguration o il comando create-network-analyzer-configuration dell'interfaccia a riga di comando.

Quando crei la configurazione, devi solo specificare un nome per la configurazione. Puoi utilizzare questa operazione API anche per specificare le impostazioni di configurazione e aggiungere le risorse durante la creazione della configurazione. In alternativa, puoi specificarle in un secondo momento utilizzando l'operazione API UpdateNetworkAnalyzerConfiguration o il comando update-network-analyzer-configuration dell'interfaccia a riga di comando.

• Creazione di una configurazione

  Quando crei la configurazione, devi specificare un nome. Il comando seguente crea ad esempio una configurazione semplicemente fornendo un nome e una descrizione facoltativa. Per impostazione di default, la configurazione ha le informazioni del frame attivate e utilizza il livello di registro INFO.

  aws iotwireless create-network-analyzer-configuration \ 
      --configuration-name My_Network_Analyzer_Config \ 
      --description "My first network analyzer configuration"                 

  L'esecuzione di questo comando visualizza l'ARN e l'ID della configurazione dell'analizzatore di rete.

  {
      "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
      "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
  }

• Creazione di una configurazione con le risorse

  Per personalizzare queste impostazioni di configurazione, utilizza il parametro trace-content. Per aggiungere risorse, utilizza i parametri WirelessDevices e WirelessGateways per specificare i gateway, i dispositivi oppure entrambi, che vuoi aggiungere alla configurazione. Ad esempio, il seguente comando personalizza le impostazioni di configurazione e aggiunge alla configurazione le risorse wireless, specificate da WirelessGatewayID e WirelessDeviceID.

  aws iotwireless create-network-analyzer-configuration \ 
      --configuration-name My_NetworkAnalyzer_Config \ 
      --trace-content WirelessDeviceFrameInfo=DISABLED,LogLevel="ERROR" \ 
      --wireless-gateways "12345678-a1b2-3c45-67d8-e90fa1b2c34d" "90123456-de1f-2b3b-4c5c-bb1112223cd1"   
      --wireless-devices "1ffd32c8-8130-4194-96df-622f072a315f"

  L'esempio seguente mostra l'output dell'esecuzione del comando:

  {
      "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
      "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
  }

Elenco delle configurazioni dell'analizzatore di rete

È possibile creare più configurazioni dell'analizzatore di rete in base alle risorse che vuoi monitorare e al livello di dettaglio delle informazioni sulla messaggistica di traccia che vuoi ricevere per le risorse. Dopo aver creato le configurazioni, puoi utilizzare l'operazione API ListNetworkAnalyzerConfigurations o il comando list-network-analyzer-configuration dell'interfaccia a riga di comando per ottenere l'elenco delle configurazioni.

aws iotwireless list-network-analyzer-configurations

L'esecuzione di questo comando visualizza tutte le configurazioni dell'analizzatore di rete nel tuo Account AWS. Puoi anche utilizzare il parametro max-results per specificare quante configurazioni vuoi visualizzare. L'esempio seguente mostra l'output dell'esecuzione del comando.

{
   "NetworkAnalyzerConfigurationList": [ 
      { 
         "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
         "Name": "My_Network_Analyzer_Config1"
      },
      { 
         "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/90123456-a1a2-9a87-65b4-c12bf3c2d09a",
         "Name": "My_Network_Analyzer_Config2"
      }
   ]
}

Eliminazione della configurazione dell'analizzatore di rete

È possibile eliminare una configurazione che non serve più con l'operazione API DeleteNetworkAnalyzerConfiguration o il comando delete-network-analyzer-configuration dell'interfaccia a riga di comando.

aws iotwireless delete-network-analyzer-configuration \ 
    --configuration-name My_NetworkAnalyzer_Config

L'esecuzione di questo comando non produce output. Per visualizzare le configurazioni disponibili, puoi utilizzare l'operazione API ListNetworkAnalyzerConfigurations.

Passaggi successivi

Ora che hai creato una configurazione dell'analizzatore di rete, puoi aggiungere le risorse alla configurazione o aggiornare le impostazioni di configurazione. Per ulteriori informazioni, consultare Aggiunta di risorse e aggiornamento della configurazione dell'analizzatore di rete.