Criar uma configuração do analisador de rede

Para poder monitorar os gateways ou os dispositivos sem fio, crie uma configuração para o analisador de rede. Ao criar a configuração, você só precisa especificar um nome de configuração. Você pode personalizar as configurações e adicionar os recursos que deseja monitorar à sua configuração mesmo depois de criada. As configurações determinam as informações de rastreamento de mensagens que você receberá para esses recursos.

Dependendo dos recursos que você deseja monitorar e do nível de informações que deseja receber sobre eles, talvez você queira criar várias configurações. Por exemplo, você pode criar uma configuração que exiba somente informações de erro para um conjunto de gateways em sua Conta da AWS. Você também pode criar uma configuração que exiba todas as informações sobre um dispositivo sem fio que você queira monitorar.

As seções a seguir mostram as várias definições de configuração e como criar a configuração.

Definições de configuração

Ao criar ou atualizar a configuração do analisador de rede, você também pode personalizar os parâmetros a seguir para filtrar as informações do fluxo de logs.

• Informações sobre o quadro

  Essa configuração é a informação do quadro dos recursos do seu dispositivo sem fio para mensagens de rastreamento. As informações do quadro podem ser usadas para depurar a comunicação entre o servidor de rede e os dispositivos finais. Ele é habilitado por padrão.

• Níveis de log

  Você pode ver os logs de informações ou de erros, ou pode desativar o log.

  • Informações

    Os logs com um nível de log de Informações são mais detalhados e contêm fluxos de logs de erros e fluxos de logs informativos. Os logs informativos podem ser usados para visualizar alterações no estado de um dispositivo ou gateway.

    nota

    A coleta de fluxos de logs mais detalhados pode gerar custos adicionais. Para obter mais informações sobre a definição de preço, consulte Definição de preço do AWS IoT Core.

  • Erro

    Os logs com um nível de log de Erro são menos detalhados e exibem somente informações de erro. Você pode usar esses logs quando um aplicativo tem um erro, como um erro de conexão do dispositivo. Ao usar as informações do fluxo de logs, você pode identificar e solucionar erros nos recursos da sua frota.

Criar uma configuração usando o console

É possível criar uma configuração do analisador de rede e personalizar os parâmetros opcionais utilizando o console do AWS IoT ou a API do AWS IoT Wireless. Você também pode criar várias configurações e, posteriormente, excluir qualquer configuração que não esteja mais usando.

Criar uma configuração do analisador de rede

1. Abra o Hub do analisador de rede do console de AWS IoT e escolha Criar configuração.

2. Especifique as definições da configuração.

   • Nome, descrição e tags

     Especifique um Nome de configuração exclusivo que contenha somente letras, números, hifens ou sublinhados. Utilize o campo opcional Descrição, para fornecer informações sobre a configuração, e o campo Tags, para adicionar pares de chave-valor de metadados sobre a configuração. Para obter mais informações sobre nomenclatura e descrição dos recursos, consulte Descrever os recursos do AWS IoT Wireless.

   • Definições de configuração

     Escolha se deseja desativar as informações do quadro e use Selecionar níveis de log para escolher os níveis de log que você deseja usar para seus logs de mensagens de rastreamento. Escolha Próximo.

3. Adicione recursos à configuração. Você pode adicionar recursos agora ou escolher Criar e adicioná-los mais tarde. Para adicionar recursos posteriormente, escolha Criar.

   Na página Hub do analisador de rede, você verá a configuração que criou junto com as configurações. Para visualizar os detalhes da nova configuração, escolha o nome da configuração.

Excluir a configuração do analisador de rede

É possível criar várias configurações do analisador de rede dependendo dos recursos que você deseja monitorar e do nível de informações de rastreamento de mensagens que deseja receber sobre eles.

Para remover configurações do console

1. Vá para o Hub do analisador de rede do console de AWS IoT e escolha a configuração que deseja remover.

2. Escolha Ações e, em seguida, escolha Excluir.

Criar uma configuração usando a API

Para criar uma configuração do analisador de rede usando a API, use a operação de API CreateNetworkAnalyzerConfiguration ou o comando da CLI create-network-analyzer-configuration.

Ao criar a configuração, você só precisa especificar um nome de configuração. Você também pode usar essa operação de API para especificar as definições de configuração e adicionar recursos ao criar a configuração. Também é possível especificá-las posteriormente utilizando a operação de API UpdateNetworkAnalyzerConfiguration ou o update-network-analyzer-configuration da CLI.

• Criar uma configuração

  Ao criar sua configuração, é necessário especificar um nome. Por exemplo, o comando a seguir cria uma configuração apresentando somente um nome e uma descrição opcional. Por padrão, a configuração tem as informações do quadro ativadas e usa um nível de log de INFO.

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

  A execução desse comando exibe o ARN e o ID da configuração do analisador de rede.

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

• Criar configurações com recursos

  Para personalizar as definições de configuração, use o parâmetro trace-content. Para adicionar recursos, utilize os parâmetros WirelessDevices e WirelessGateways para especificar os gateways e dispositivos que você deseja adicionar à configuração. Por exemplo, o comando a seguir personaliza as definições de configuração e adiciona os recursos sem fio, especificados por WirelessGatewayID e WirelessDeviceID, à configuração.

  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"

  O exemplo a seguir mostra a saída da execução do comando:

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

Listar configurações do analisador de rede

É possível criar várias configurações do analisador de rede dependendo dos recursos que você deseja monitorar e do nível de detalhes das informações de rastreamento de mensagens que deseja receber sobre eles. Depois de criar essas configurações, você pode usar a operação de API ListNetworkAnalyzerConfigurations ou o comando da CLI list-network-analyzer-configuration para obter uma lista dessas configurações.

aws iotwireless list-network-analyzer-configurations

A execução desse comando exibe todas as configurações do analisador de rede na Conta da AWS. Você também pode usar o parâmetro max-results para especificar quantas configurações deseja exibir. Confira a seguir a saída de execução desse 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"
      }
   ]
}

Excluir a configuração do analisador de rede

Você pode excluir uma configuração que não esteja mais usando com a operação de API DeleteNetworkAnalyzerConfiguration ou o comando da CLI delete-network-analyzer-configuration.

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

A execução desse comando não retorna nenhuma saída. Para ver as configurações disponíveis, você pode usar a operação de API ListNetworkAnalyzerConfigurations.

Próximas etapas

Agora que criou uma configuração do analisador de rede, você pode adicionar recursos à sua configuração ou atualizar as definições de configuração. Para ter mais informações, consulte Adicionar recursos e atualizar a configuração do analisador de rede.