# 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).