# Crear una configuración de analizador de red y agregar recursos Para poder transmitir los mensajes de rastreo, cree una configuración de analizador de red y agregue a esta configuración los recursos que desee supervisar. Cuando crea una configuración, puede: + Especificar un nombre de configuración y una descripción opcional. + Personalizar los ajustes de configuración, como la información del marco y el nivel de detalle de los mensajes de registro. + Agregar los recursos que desea supervisar. Los recursos pueden ser dispositivos inalámbricos, puertas de enlace inalámbricas o ambos. Los valores de configuración que especifique determinarán la información de mensajería de rastreo que recibirá por los recursos que agregue a la configuración. Es posible que también desee crear varias configuraciones en función del caso de uso de la supervisión. El ejemplo siguiente muestra cómo crear una configuración y agregar recursos. **Topics** + [Crear una configuración del analizador de red](network-analyzer-create.md) + [Agregar recursos y actualizar la configuración del analizador de red](network-analyzer-resources.md) # Crear una configuración del analizador de red A fin de poder supervisar las puertas de enlace o los dispositivos inalámbricos, debe crear una configuración para el analizador de redes. Cuando cree la configuración, solo tiene que especificar un nombre de configuración. Puede personalizar los ajustes de configuración y agregar los recursos que desee supervisar a la configuración incluso después de crearla. Los valores de configuración determinan la información de mensajería de rastreo que recibirá para esos recursos. En función de los recursos que desee supervisar y del nivel de información que desee recibir de ellos, es posible que desee crear varias configuraciones. Por ejemplo, puede crear una configuración que muestre solo la información de error de un conjunto de puertas de enlace de su Cuenta de AWS. También puede crear una configuración que muestre toda la información sobre el dispositivo inalámbrico que desee supervisar. En las siguientes secciones se muestran las distintas opciones de configuración y cómo crear la configuración. ## Opciones de configuración Al crear o actualizar la configuración del analizador de redes, también puede personalizar los siguientes parámetros para filtrar la información del flujo de registro. + **Información del marco** Esta configuración es la información del marco de los recursos del dispositivo inalámbrico para los mensajes de rastreo. La información del marco se puede utilizar para depurar la comunicación entre el servidor de red y los dispositivos finales. Está habilitada de forma predeterminada. + **Niveles de registro** Puede ver los registros de información o errores, o puede desactivar el registro. + **Información** Los registros con un nivel de registro de **información** son más detallados y contienen tanto secuencias de registro de errores como secuencias de registro informativos. Los registros informativos se pueden usar para ver los cambios en el estado de un dispositivo o puerta de enlace. **nota** La recopilación de secuencias de registros más detallados puede dar lugar costes adicionales. Para obtener más información acerca de los precios, consulte [Precios de AWS IoT Core](https://aws.amazon.com/iot-core/pricing/). + **Error** Los registros con un nivel de registro de **error** son menos detallados y solo muestran información sobre errores. Puede usar estos registros cuando una aplicación tenga un error, como un error de conexión de un dispositivo. Al utilizar la información del flujo de registro, puede identificar y solucionar los errores de los recursos de su flota. ## Crear una configuración con la consola Puede crear una configuración de analizador de redes y personalizar los parámetros opcionales mediante la consola de AWS IoT o la API de AWS IoT Wireless. También puede crear varias configuraciones y, posteriormente, eliminar las configuraciones que ya no utilice. **Crear una configuración del analizador de red** 1. Abra el [hub de Network Analyzer de la consola de AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) y seleccione **Crear configuración**. 1. Especifique las opciones de configuración. + **El nombre, la descripción y las etiquetas** Especifique un **Nombre de configuración** único que conste solo de letras, números, guiones o guiones bajos. Utilice el campo **Descripción** opcional para proporcionar información sobre la configuración, y el campo **Etiquetas** para añadir pares de metadatos clave-valor sobre la configuración. Para obtener más información acerca del nombre y la descripción de los recursos, consulte [Descripción de los recursos de AWS IoT Wireless](iotwireless-describe-resources.md). + **Opciones de configuración** Elija si desea deshabilitar la información del marco y utilice **Seleccionar niveles de registro** para elegir los niveles de registro que desea usar en los registros de mensajes de rastreo. Seleccione **Siguiente**. 1. Agregar recursos a la configuración. Puede agregar sus recursos ahora o puede elegir **Crear** y, a continuación, agregar los recursos más adelante. Para agregar recursos más adelante, seleccione **Crear**. En la **página del hub de Network Analyzer**, verá la configuración que creó junto con sus ajustes. Para ver los detalles de la nueva configuración, elija el nombre de la configuración. **Eliminar la configuración del analizador de red** Puede crear varias configuraciones de analizadores de red en función de los recursos que desee supervisar y del nivel de información de mensajería de rastreo que desee recibir de ellos. **Para eliminar las configuraciones de la consola** 1. Vaya al [hub de Network Analyzer de la consola de AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) y elija la configuración que desee eliminar. 1. Elija **Acciones** y, a continuación, elija **Eliminar**. ## Crear una configuración con la API Para crear una configuración de analizador de red mediante la API, utilice la operación de API [CreateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateNetworkAnalyzerConfiguration.html) o el comando CLI [create-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-network-analyzer-configuration.html). Cuando cree la configuración, solo tiene que especificar un nombre de configuración. También puede usar esta operación de API para especificar los ajustes de configuración y agregar recursos al crear la configuración. Si lo prefiere, puede especificarlos más adelante mediante la operación API [UpdateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) o el comando [update-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-network-analyzer-configuration.html) de la CLI. + **Crear una configuración** Cuando cree su configuración, debe especificar un nombre. Por ejemplo, el comando siguiente crea una configuración proporcionando solo un nombre y una descripción opcional. De forma predeterminada, la configuración tiene activada la información del marco y utiliza un nivel de registro de `INFO`. ``` aws iotwireless create-network-analyzer-configuration \ --configuration-name My_Network_Analyzer_Config \ --description "My first network analyzer configuration" ``` Al ejecutar este comando, se muestran el ARN y el ID de la configuración del analizador de redes. ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" } ``` + **Crear una configuración con recursos** Para personalizar estos ajustes de configuración, utilice el parámetro `trace-content`. Para agregar recursos, utilice los parámetros `WirelessDevices` y `WirelessGateways` a fin de especificar las puertas de enlace y los dispositivos que desea agregar a la configuración. Por ejemplo, el siguiente comando actualiza los parámetros de configuración y agrega a esta los recursos inalámbricos, especificados por sus `WirelessGatewayID` y `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" ``` El siguiente ejemplo muestra los resultados del comando: ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" } ``` **Enumerar las configuraciones del analizador de red** Puede crear varias configuraciones de analizadores de red en función de los recursos que desee supervisar y del nivel de detalle de la información de mensajería de rastreo que desee recibir para los recursos. Después de crear estas configuraciones, puede usar la operación de API [ListNetworkAnalyzerConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListNetworkAnalyzerConfigurations.html) o el comando CLI [list-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-network-analyzer-configuration.html) para obtener una lista de estas configuraciones. ``` aws iotwireless list-network-analyzer-configurations ``` Al ejecutar este comando, se muestran todas las configuraciones del analizador de red en su Cuenta de AWS. También puede usar el parámetro `max-results` para especificar cuántas configuraciones desea mostrar. El ejemplo siguiente muestra el ejemplo de salida de la ejecución de este 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" } ] } ``` **Eliminar la configuración del analizador de red** Puede eliminar una configuración que ya no utilice con la operación de API [DeleteNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteNetworkAnalyzerConfiguration.html) o el comando 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 ``` Este comando no proporciona ningún resultado. Para ver las configuraciones disponibles, puede utilizar la operación API de `ListNetworkAnalyzerConfigurations`. ## Siguientes pasos Ahora que ha creado una configuración de analizador de redes, puede agregar recursos a la configuración o actualizar los ajustes de configuración. Para obtener más información, consulte [Agregar recursos y actualizar la configuración del analizador de red](network-analyzer-resources.md). # Agregar recursos y actualizar la configuración del analizador de red Para poder activar la mensajería de seguimiento, debe agregar recursos a su configuración. Puede usar solo una configuración de analizador de redes predeterminada y única. AWS IoT Core para LoRaWAN asigna el nombre (**NetworkAnalyzerConfig\$1Default**) a esta configuración y el campo no se puede editar. Esta configuración se agrega automáticamente a su Cuenta de AWS al usar el analizador de redes desde la consola. Puede agregar los recursos que desea supervisar a esta configuración predeterminada. Los recursos pueden ser dispositivos o puertas de enlace LoRaWAN (o ambos). Para agregar cada recurso individual a la configuración, utilice la puerta de enlace inalámbrica y los identificadores de los dispositivos inalámbricos. ## Opciones de configuración Para configurar los ajustes, primero añada recursos a la configuración predeterminada y active la mensajería de seguimiento. Una vez que haya recibido los registros de los mensajes de seguimiento, también puede personalizar los siguientes parámetros para actualizar la configuración predeterminada y filtrar el flujo de registro. + **Información del marco** Esta configuración es la información del marco de los recursos de dispositivos inalámbricos para los mensajes de seguimiento. La información del marco está habilitada de forma predeterminada, y se puede utilizar para depurar la comunicación entre el servidor de red y los dispositivos finales. + **Niveles de registro** Puede ver los registros de información o errores, o puede desactivar el registro. + **Información** Los registros con un nivel de registro **Información** son más detallados, y contienen flujos de registro informativos y con errores. Los registros informativos se pueden usar para ver los cambios en el estado de un dispositivo o una puerta de enlace. **nota** La recopilación de secuencias de registros más detallados puede dar lugar costes adicionales. Para obtener más información acerca de los precios, consulte [Precios de AWS IoT Core](https://aws.amazon.com/iot-core/pricing/). + **Error** Los registros con un nivel de registro de **error** son menos detallados y solo muestran información sobre errores. Puede usar estos registros cuando una aplicación tenga un error, como un error de conexión de un dispositivo. Al utilizar la información del flujo de registro, puede identificar y solucionar los errores de los recursos de su flota. ## Requisitos previos Para poder agregar recursos, debe haber incorporado las puertas de enlace y los dispositivos que desee supervisar a AWS IoT Core para LoRaWAN. Para obtener más información, consulte [Conexión de puertas de enlace y dispositivos a AWS IoT Core para LoRaWAN](lorawan-getting-started.md). ## Agregar recursos y actualizar la configuración del analizador de redes con la consola Puede agregar recursos y personalizar los parámetros opcionales mediante la consola de AWS IoT o la API de AWS IoT Wireless. Además de los recursos, también puede editar los ajustes de configuración y guardar la configuración actualizada. **Para agregar recursos a su configuración (consola)** 1. Abra el [hub del analizador de redes de la consola de AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) y elija la configuración del analizador de redes (**NetworkAnalyzerConfig\$1Default**). 1. Elija **Agregar recursos**. 1. Agregue los recursos que desee supervisar mediante la puerta de enlace inalámbrica y los identificadores de los dispositivos inalámbricos. Puede agregar hasta 250 puertas de enlace inalámbricas o dispositivos inalámbricos. Para añadir su recurso: 1. Utilice la pestaña **Ver gateways** o **Ver dispositivos** a fin de ver la lista de puertas de enlace y dispositivos que ha agregado a su Cuenta de AWS. 1. Copie el `WirelessDeviceID` o `WirelessGatewayID` del dispositivo o la puerta de enlace que desee supervisar e introduzca el valor del identificador del recurso correspondiente. 1. Para seguir agregando recursos, elija **Agregar gateway** o **Agregar dispositivo** y agregue su puerta de enlace o dispositivo inalámbrico. Si ha añadido un recurso que ya no desea monitorizar, seleccione **Eliminar recurso**. 1. Una vez que haya agregado todos los recursos, elija **Agregar**. Verá la cantidad de puertas de enlace y dispositivos que agregó en **la página del hub de Network Analyzer**. Puede seguir agregando puertas de enlace y dispositivos hasta que active la sesión de mensajería de seguimiento. Una vez activada la sesión, tendrá que desactivarla para agregar recursos. **Para editar la configuración del analizador de redes (consola)** Puede editar la configuración del analizador de redes y elegir si desea desactivar la información del marco y el nivel de registro de sus registros de mensajes de seguimiento. 1. Abra el [hub del analizador de redes de la consola de AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) y elija la configuración del analizador de redes (**NetworkAnalyzerConfig\$1Default**). 1. Elija **Editar**. 1. Elija si desea deshabilitar la información del marco y utilice **Seleccionar niveles de registro** para elegir los niveles de registro que desea usar en los registros de mensajes de rastreo. Seleccione **Guardar**. Verá los ajustes de configuración que especificó en la página de detalles de la configuración de su analizador de redes. ## Agregar recursos y actualizar la configuración del analizador de redes con la API Puede usar las [operaciones de API de AWS IoT Wireless](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/) o los [comandos de la CLI de AWS IoT Wireless](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html) para agregar recursos y actualizar los ajustes de configuración de su analizador de redes. + Para agregar recursos o actualizar la configuración del analizador de redes, utilice la API [UpdateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) o el comando [update-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-network-analyzer-configuration.html) de la CLI. + **Agregar recursos** Para los dispositivos inalámbricos que desee agregar, utilice `WirelessDevicesToAdd` para introducir el `WirelessDeviceID` para los dispositivos como una matriz de cadenas. Para las puertas de enlace inalámbricas que desee agregar, utilice `WirelessGatewaysToAdd` para introducir el `WirelessGatewayID` para las puertas de enlace como una matriz de cadenas. + **Editar una configuración** Para editar la configuración del analizador de redes, utilice el parámetro `TraceContent` para especificar si `WirelessDeviceFrameInfo` debe ser `ENABLED` o `DISABLED`, y si el parámetro `LogLevel` debe ser `INFO`, `ERROR` o `DISABLED`. ``` { "TraceContent": { "LogLevel": "string", "WirelessDeviceFrameInfo": "string" }, "WirelessDevicesToAdd": [ "string" ], "WirelessDevicesToRemove": [ "string" ], "WirelessGatewaysToAdd": [ "string" ], "WirelessGatewaysToRemove": [ "string" ] } ``` + Para obtener información sobre la configuración y los recursos que ha agregado, utilice la operación API [GetNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) o el comando [get-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-network-analyzer-configuration.html). Proporcione el nombre de la configuración del analizador de redes (`NetworkAnalyzerConfig_Default`) como entrada. ## Siguientes pasos Ahora que ha agregado recursos y ha especificado los ajustes de configuración opcionales para su configuración, puede usar el protocolo WebSocket para establecer una conexión con AWS IoT Core para LoRaWAN y usar el analizador de redes. A continuación, puede activar la mensajería de rastreo y empezar a recibir mensajes de rastreo para sus recursos. Para obtener más información, consulte [Transmitir los mensajes de rastreo del analizador de redes con WebSockets](network-analyzer-api.md).