# Criar a configuração do analisador de rede e adicionar recursos
Antes de transmitir mensagens de rastreamento, crie uma configuração do analisador de rede e adicione os recursos que você deseja monitorar a essa configuração. Ao criar uma configuração, você pode:
+ Especificar um nome de configuração e uma descrição opcional.
+ Personalizar as configurações, como informações do quadro e nível de detalhes das mensagens de log.
+ Adicionar os recursos que você deseja monitorar. Os recursos podem ser dispositivos ou gateways sem fio ou ambos.
As configurações que você especificar determinarão as informações de rastreamento de mensagens que você receberá dos recursos adicionados à configuração. Talvez você também queira criar várias configurações, dependendo do caso de uso de monitoramento.
Veja a seguir como criar uma configuração e adicionar recursos.
**Topics**
+ [Criar uma configuração do analisador de rede](network-analyzer-create.md)
+ [Adicionar recursos e atualizar a configuração do analisador de rede](network-analyzer-resources.md)
# 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](https://aws.amazon.com/iot-core/pricing/).
+
**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](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) e escolha **Criar configuração**.
1. 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](iotwireless-describe-resources.md).
+
**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**.
1. 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](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) e escolha a configuração que deseja remover.
1. 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](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateNetworkAnalyzerConfiguration.html) ou o comando da CLI [create-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-network-analyzer-configuration.html).
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](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) ou o [update-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-network-analyzer-configuration.html) 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](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListNetworkAnalyzerConfigurations.html) ou o comando da CLI [list-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-network-analyzer-configuration.html) 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](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteNetworkAnalyzerConfiguration.html) ou o comando da CLI [delete-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-network-analyzer-configuration.html).
```
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](network-analyzer-resources.md).
# Adicionar recursos e atualizar a configuração do analisador de rede
Para poder ativar as mensagens de rastreamento, adicione os recursos à configuração. É possível utilizar uma única configuração padrão do analisador de rede. O AWS IoT Core for LoRaWAN atribui o nome **NetworkAnalyzerConfig\$1Default** a essa configuração, e esse campo não pode ser editado. Essa configuração é adicionada automaticamente ao Conta da AWS quando você utiliza o analisador de rede no console.
É possível adicionar os recursos que deseja monitorar à configuração padrão. Os recursos podem ser dispositivos LoRaWAN e gateways LoRaWAN. Para adicionar cada recurso à configuração, utilize o gateway sem fio e os identificadores dos dispositivos sem fio.
## Definições de configuração
Para definir as configurações, primeiro adicione recursos à configuração padrão e ative as mensagens de rastreamento. Após o recebimento dos logs de mensagens de rastreamento, também é possível personalizar os parâmetros a seguir para atualizar a configuração padrão e filtrar o fluxo de logs.
+
**Informações sobre o quadro**
Essa configuração são as informações de quadro dos recursos de dispositivos sem fio para mensagens de rastreamento. As informações de quadro são habilitadas por padrão e podem ser utilizadas para depurar a comunicação entre o servidor de rede e os dispositivos finais.
+
**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 o nível **Informações** são mais detalhados e contêm fluxos de logs tanto informativos como de erros. Os logs informativos podem ser utilizados para visualizar alterações no estado de um dispositivo ou de um 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](https://aws.amazon.com/iot-core/pricing/).
+
**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.
## Pré-requisitos
Para poder adicionar recursos, os gateways e dispositivos a serem monitorados já devem estar integrados ao AWS IoT Core for LoRaWAN. Para ter mais informações, consulte [Conectar gateways e dispositivos ao AWS IoT Core for LoRaWAN](lorawan-getting-started.md).
## Adicionar recursos e atualizar a configuração do analisador de rede com o console
É possível adicionar recursos e personalizar os parâmetros opcionais utilizando o console do AWS IoT ou a API do AWS IoT Wireless. Além dos recursos, você também pode editar as definições de configuração e salvar a configuração atualizada.
**Como adicionar recursos à configuração (console)**
1. Abra o [Hub do analisador de rede no console do AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) e escolha a configuração do analisador de rede, **NetworkAnalyzerConfig\$1Default**.
1. Selecione **Adicionar recursos**.
1. Adicione os recursos que deseja monitorar usando o gateway sem fio e os identificadores de dispositivos sem fio. É possível adicionar até 250 gateways ou dispositivos sem fio. Para adicionar o recurso:
1. Utilize a guia **Visualizar gateways** ou **Visualizar dispositivos** para ver a lista de gateways e dispositivos que você adicionou ao Conta da AWS.
1. Copie o `WirelessDeviceID` ou o `WirelessGatewayID` do dispositivo ou do gateway que você deseja monitorar e insira o valor do identificador para o recurso correspondente.
1. Para continuar a adicionar recursos, escolha **Adicionar gateway** ou **Adicionar dispositivo** e adicione o gateway ou dispositivo sem fio. Se você adicionou um recurso que não deseja mais monitorar, escolha **Remover recurso**.
1. Depois de adicionar todos os recursos, escolha **Adicionar**.
Você verá o número de gateways e dispositivos que adicionou na **página Hub do analisador de rede**. É possível continuar adicionando gateways e dispositivos até que a sessão de rastreamento de mensagens seja ativada. Depois que a sessão for ativada, para adicionar recursos, será necessário desativar a sessão.
**Como editar a configuração do analisador de rede (console)**
É possível editar a configuração do analisador de rede e escolher se deseja desabilitar as informações de quadro e o nível de log das mensagens de rastreamento.
1. Abra o [Hub do analisador de rede no console do AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) e escolha a configuração do analisador de rede, **NetworkAnalyzerConfig\$1Default**.
1. Selecione a opção **Editar**.
1. 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 os logs de mensagens de rastreamento. Escolha **Salvar**.
Você verá as definições de configuração especificadas na página de detalhes da configuração do analisador de rede.
## Adicionar recursos e atualizar a configuração do analisador de rede com a API
É possível utilizar as [operações de API do AWS IoT Wireless](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/) ou os [comandos da CLI do AWS IoT Wireless](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html) para adicionar recursos e atualizar as configurações do analisador de rede.
+ Para adicionar recursos ou atualizar a configuração do analisador de rede, utilize a API [UpdateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) ou o comando [update-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-network-analyzer-configuration.html) da CLI.
+
**Adicionar recursos**
Para os dispositivos sem fio que você deseja adicionar, utilize `WirelessDevicesToAdd` para inserir o `WirelessDeviceID` dos dispositivos como uma matriz de strings. Para os gateways sem fio que você deseja adicionar, utilize `WirelessGatewaysToAdd` para inserir o `WirelessGatewayID` dos gateways como uma matriz de strings.
+
**Editar a configuração**
Para editar a configuração do analisador de rede, utilize o parâmetro `TraceContent` para especificar se `WirelessDeviceFrameInfo` deve ser `ENABLED` ou `DISABLED`, e se o parâmetro `LogLevel` deve ser `INFO`, `ERROR` ou `DISABLED`.
```
{
"TraceContent": {
"LogLevel": "string",
"WirelessDeviceFrameInfo": "string"
},
"WirelessDevicesToAdd": [ "string" ],
"WirelessDevicesToRemove": [ "string" ],
"WirelessGatewaysToAdd": [ "string" ],
"WirelessGatewaysToRemove": [ "string" ]
}
```
+ Para obter informações sobre a configuração e os recursos adicionados, utilize a operação de API [GetNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) ou o comando [get-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-network-analyzer-configuration.html). Forneça o nome da configuração do analisador de rede, `NetworkAnalyzerConfig_Default`, como entrada.
## Próximas etapas
Agora que adicionou recursos e especificou todas as definições opcionais para a configuração, é possível utilizar o protocolo WebSocket para estabelecer uma conexão com o AWS IoT Core for LoRaWAN e utilizar o analisador de rede. Em seguida, você pode ativar as mensagens de rastreamento e começar a receber essas mensagens para os recursos. Para ter mais informações, consulte [Transmitir mensagens de rastreamento do analisador de rede com WebSockets](network-analyzer-api.md).