# Supervisión de su flota de recursos inalámbricos en tiempo real mediante un analizador de redes
El analizador de redes utiliza una conexión WebSocket predeterminada para recibir registros de mensajes de rastreo en tiempo real para sus recursos de conectividad inalámbrica. Con el analizador de redes, puede agregar los recursos que desee supervisar, activar una sesión de mensajería de rastreo y empezar a recibir mensajes de rastreo en tiempo real.
Para supervisar recursos, también puede utilizar Amazon CloudWatch. Para usar CloudWatch, debe configurar un rol de IAM para configurar el registro y, a continuación, esperar a que las entradas del registro se muestren en la consola. El analizador de redes reduce considerablemente el tiempo que se tarda en configurar una conexión y empezar a recibir mensajes de rastreo, para proporcionarle información de registro justo a tiempo para su flota de recursos. Para obtener más información sobre la monitorización con CloudWatch, consulte [Monitorización de recursos de AWS IoT Wireless con los Registros de Amazon CloudWatch](monitoring-cloudwatch.md).
Reducir el tiempo de configuración y utilizar la información de los mensajes de rastreo le permite supervisar sus recursos de forma más eficaz, obtener información útil y solucionar errores. Puede monitorizar tanto los dispositivos LoRaWAN como las puertas de enlace LoRaWAN. Por ejemplo, puede identificar rápidamente un error de unión al incorporar uno de sus dispositivos LoRaWAN. Para depurar el error, utilice la información del registro de mensajes de rastreo proporcionado.
**Cómo utilizar el analizador de redes**
Para supervisar la flota de recursos y comenzar a recibir mensajes de seguimiento, lleve a cabo los siguientes pasos.
1.
**Crear la configuración del analizador de redes y agregar recursos**
Para poder activar la mensajería de rastreo, cree una configuración de analizador de red y agregue recursos a la configuración. En primer lugar, especifique los ajustes de configuración, lo que incluye los niveles de registro y la información sobre los marcos de dispositivos inalámbricos. Luego, agregue los recursos inalámbricos que desee supervisar mediante la puerta de enlace inalámbrica y los identificadores de los dispositivos inalámbricos.
1.
**Transmitir mensajes de rastreo con WebSockets**
Puede generar una URL de solicitud prefirmada con las credenciales de su rol de IAM para transmitir los mensajes de rastreo del analizador de redes mediante el protocolo WebSocket.
1.
**Activar la sesión de mensajería de rastreo y supervisar los mensajes de rastreo**
Para empezar a recibir mensajes de rastreo, active su sesión de mensajería de rastreo. Para evitar incurrir en costes adicionales, puede desactivar o cerrar la sesión de mensajería de rastreo del analizador de redes.
En el siguiente vídeo, se describe cómo funciona el analizador de redes de AWS IoT Core para LoRaWAN, y se explica el proceso para agregar recursos y rastrear las actividades de unión con el analizador de redes.
[](http://www.youtube.com/watch?v=https://www.youtube.com/embed/Qk9pkhL8xjc)
Los siguientes temas muestran cómo crear la configuración, agregar recursos y activar la sesión de mensajería de seguimiento.
**Topics**
+ [Agregar el rol de IAM necesario para el analizador de redes](network-analyzer-iam.md)
+ [Crear una configuración de analizador de red y agregar recursos](network-analyzer-create-resources.md)
+ [Transmitir los mensajes de rastreo del analizador de redes con WebSockets](network-analyzer-api.md)
+ [Ver y supervisar los registros de mensajes de rastreo del analizador de redes en tiempo real](network-analyzer-logs.md)
+ [Depurar y solucionar los problemas de sus grupos de multidifusión y tareas de FUOTA mediante el analizador de redes](lorawan-network-analyzer-fuota.md)
# Agregar el rol de IAM necesario para el analizador de redes
Cuando utilice el analizador de redes, debe conceder a un usuario permiso para utilizar las operaciones de API [UpdateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) y [GetNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetNetworkAnalyzerConfiguration.html) para acceder a los recursos del analizador de redes. A continuación, se muestran las políticas de IAM que se utilizan para conceder permisos.
## Políticas de IAM para el analizador de redes
Utilice una de las dos siguientes:
+
**Política inalámbrica de acceso completo**
Otórguele a AWS IoT Core para LoRaWAN el acceso completo a la política; para ello, adjunte la política **AWSIoTWirelessFullAccess** a su rol. Para obtener más información, consulte [Resumen de políticas de `AWSIoTWirelessFullAccess`](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AWSIoTWirelessFullAccess$serviceLevelSummary).
+
**Política de IAM con ámbito para obtener y actualizar la API**
Cree la siguiente política de IAM desde la página [Crear políticas](https://console.aws.amazon.com/iam/home#/policies$new?step=edit) de la consola de IAM y desde la pestaña **Editor visual**:
1. Elija **IoTWireless** como **Servicio**.
1. En **Nivel de acceso**, expanda **Leer** y elija **GetNetworkAnalyzerConfiguration** y, a continuación, expanda **Escribir** y elija **UpdateNetworkAnalyzerConfiguration**.
1. Seleccione **Siguiente: Etiquetas** e introduzca un **Nombre** para la política, como **IoTWirelessNetworkAnalyzerPolicy**. Elija **Crear política**.
A continuación se muestra la política **IoTWirelessNetworkAnalyzerPolicy** que creó. Para obtener más información sobre cómo crear una política de IAM, consulte [Crear políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create).
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"iotwireless:GetNetworkAnalyzerConfiguration",
"iotwireless:UpdateNetworkAnalyzerConfiguration"
],
"Resource": "*"
}
]
}
```
**Política con ámbito para acceder a recursos específicos**
Para configurar un control de acceso más detallado, debe agregar las puertas de enlace y los dispositivos inalámbricos en el campo **Recurso**. La siguiente política utiliza el ARN comodín para conceder acceso a todas las puertas de enlace y dispositivos. Puede controlar el acceso a dispositivos y puertas de enlace específicos mediante el `WirelessGatewayId` y el `WirelessDeviceId`.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"iotwireless:GetNetworkAnalyzerConfiguration",
"iotwireless:UpdateNetworkAnalyzerConfiguration"
],
"Resource": [
"arn:aws:iotwireless:*:{accountId}:WirelessDevice/*",
"arn:aws:iotwireless:*:{accountId}:WirelessGateway/*",
"arn:aws:iotwireless:*:{accountId}:NetworkAnalyzerConfiguration/*"
]
}
]
}
```
Para concederle a un usuario el permiso para usar el analizador de redes, pero no para usar puertas de enlace o dispositivos inalámbricos, utilice la siguiente política. A menos que se especifique, los permisos para usar los recursos se deniegan implícitamente.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"iotwireless:GetNetworkAnalyzerConfiguration",
"iotwireless:UpdateNetworkAnalyzerConfiguration"
],
"Resource": [
"arn:aws:iotwireless:*:{accountId}:NetworkAnalyzerConfiguration/*"
]
}
]
}
```
## Siguientes pasos
Ahora que ha creado la política, puede agregar recursos a la configuración del analizador de redes y recibir información de mensajería de rastreo para esos recursos. Para obtener más información, consulte [Crear una configuración de analizador de red y agregar recursos](network-analyzer-create-resources.md).
# 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).
# Transmitir los mensajes de rastreo del analizador de redes con WebSockets
Cuando utiliza el protocolo WebSocket, puede transmitir los mensajes de rastreo del analizador de redes en tiempo real. Al enviar una solicitud, el servicio responde con una estructura JSON. Después de activar la mensajería de rastreo, puede usar los registros de mensajes para obtener información sobre sus recursos y solucionar errores. Para obtener más información, consulte [Protocolo WebSocket](https://tools.ietf.org/html/rfc6455).
A continuación, se muestra cómo transmitir los mensajes de rastreo del analizador de redes con WebSockets.
**Topics**
+ [Generar una solicitud prefirmada con la biblioteca WebSocket](network-analyzer-generate-request.md)
+ [Mensajes y códigos de estado de WebSocket](network-analyer-messages-status.md)
# Generar una solicitud prefirmada con la biblioteca WebSocket
A continuación, se muestra cómo generar una solicitud prefirmada con el fin de poder usar la biblioteca WebSocket para enviar solicitudes al servicio.
## Agregar una política para solicitudes de WebSocket a su rol de IAM
Si desea utilizar el protocolo WebSocket para llamar al analizador de redes, debe asociar la siguiente política al rol AWS Identity and Access Management de IAM que realiza la solicitud.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iotwireless:StartNetworkAnalyzerStream",
"Resource": "*"
}
]
}
```
## Crear una URL prefirmada
Cree una URL para la solicitud de WebSocket que contenga la información necesaria para configurar la comunicación entre la aplicación y el analizador de redes. Para verificar la identidad de la solicitud, el streaming de WebSocket utiliza el proceso Signature Version 4 de Amazon para firmar solicitudes. Para obtener más información acerca de Signature Version 4, consulte [Firma de solicitudes de la API de AWS](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) en la *Referencia general de Amazon Web Services*.
Para llamar al analizador de redes, utilice la URL de solicitud `StartNetworkAnalyzerStream`. La solicitud se firmará con las credenciales del rol de IAM mencionado anteriormente. La URL tiene el siguiente formato con saltos de línea agregados para facilitar la lectura.
```
GET wss://api.iotwireless..amazonaws.com/start-network-analyzer-stream?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=Signature Version 4 credential scope
&X-Amz-Date=date
&X-Amz-Expires=time in seconds until expiration
&X-Amz-Security-Token=security-token
&X-Amz-Signature=Signature Version 4 signature
&X-Amz-SignedHeaders=host
```
Utilice los siguientes valores para los parámetros de Signature Version 4:
+ **X-Amz-Algorithm**: el algoritmo que está utilizando en el proceso de firma. El único valor válido es `AWS4-HMAC-SHA256`.
+ **X-Amz-Credential**: una cadena separada por barras diagonales ("/") que se forma concatenando sus componentes de ID de clave de acceso y ámbito de credenciales. El ámbito de credenciales incluye la fecha con el formato AAAAMMDD, la región de AWS, el nombre del servicio, así como una cadena de terminación (aws4\$1request).
+ **X-Amz-Date**: la fecha y hora en que se creó la firma. Genere la fecha y la hora siguiendo las instrucciones de [Control de fechas en Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/sigv4-date-handling.html) en la *Referencia general de Amazon Web Services*.
+ **X-Amz-Expires**: el tiempo en segundos que transcurre hasta que caduquen las credenciales. El valor máximo es de 300 segundos (5 minutos).
+ **X-Amz-Security-Token**: (opcional) un token de Signature Version 4 para credenciales temporales. Si especifica este parámetro, inclúyalo en la solicitud canónica. Para obtener más información, consulte [Solicitud de credenciales de seguridad temporales](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html) en la *AWSGuía del usuario de Administración de identidades y accesos*.
+ **X-Amz-Signature**: la firma de Signature Version 4 que generó para la solicitud.
+ **X-AMZ-SignedHeaders**: los encabezados que se firman al crear la firma de la solicitud. El único valor válido es `host`.
## Construya la URL de la solicitud y cree la firma de Signature Version 4
Para construir la URL de la solicitud y crear la firma de Signature Version 4, utilice los siguientes pasos. Los ejemplos están en pseudocódigo.
### Tarea 1: Crear una solicitud canónica
Cree una cadena que incluya información de su solicitud en un formato estandarizado. Esto garantiza que, cuando AWS reciba la solicitud, pueda calcular la misma firma que ha calculado en [Tarea 3: Calcular la firma](#calculate-signature). Para obtener más información, consulte [Creación de una solicitud canónica para Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/sigv4-create-canonical-request.html) en la *Referencia general de Amazon Web Services*.
1. Defina variables para la solicitud en su aplicación.
```
# HTTP verb
method = "GET"
# Service name
service = "iotwireless"
# Región de AWS
region = "Región de AWS"
# Service streaming endpoint
endpoint = "wss://api.iotwireless.region.amazonaws.com"
# Host
host = "api.iotwireless..amazonaws.com"
# Date and time of request
amz-date = YYYYMMDD'T'HHMMSS'Z'
# Date without time for credential scope
datestamp = YYYYMMDD
```
1. Cree un URI canónico (identificador uniforme de recursos). El URI canónico es la parte del URI entre el dominio y la cadena de consulta.
```
canonical_uri = "/start-network-analyzer-stream"
```
1. Cree los encabezados canónicos y los encabezados firmados. Tenga en cuenta la `\n` final en los encabezados canónicos.
+ Agregue el nombre de encabezado en minúsculas seguido de un signo de dos puntos.
+ Agregue una lista de valores separados por comas para ese encabezado. No ordene los valores de los encabezados que tienen múltiples valores.
+ Agregue una nueva línea (`\n`).
```
canonical_headers = "host:" + host + "\n"
signed_headers = "host"
```
1. Haga coincidir el algoritmo con el algoritmo de hash. Debe utilizar SHA-256.
```
algorithm = "AWS4-HMAC-SHA256"
```
1. Cree el ámbito de credenciales, que abarca la clave derivada de la fecha, la región y el servicio para el que se realiza la solicitud.
```
credential_scope = datestamp + "/" + region + "/" + service + "/" + "aws4_request"
```
1. Cree la cadena de consulta canónica. Los valores de cadena de la consulta deben estar codificados en URI y ordenados por nombre.
+ Ordene los nombres de los parámetros en orden ascendente según el punto del código de caracteres. Los parámetros con nombres duplicados deben ordenarse por valor. Por ejemplo, un nombre de parámetro que comienza por la letra mayúscula F precede a un nombre de parámetro que empieza por la letra minúscula b.
+ No codifique según las normas de los URI ninguno de los caracteres no reservados definidos en la norma [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986): A-Z, a-z, 0-9, guion (-), guion bajo (\$1), punto (. ) y tilde ( \$1 ).
+ Codifique con signos de porcentaje el resto de los caracteres con %XY, donde X e Y son caracteres hexadecimales (0-9 y A-F mayúsculas). Por ejemplo, el carácter de espacio debe codificarse como %20 (no mediante el signo “\$1” como en algunos esquemas de codificación) y los caracteres extendidos UTF-8 deben indicarse con el formato %XY%ZA%BC.
+ Codifique dos veces los caracteres de equivalencia (=) en los valores de los parámetros.
```
canonical_querystring = "X-Amz-Algorithm=" + algorithm
canonical_querystring += "&X-Amz-Credential="+ URI-encode(access key + "/" + credential_scope)
canonical_querystring += "&X-Amz-Date=" + amz_date
canonical_querystring += "&X-Amz-Expires=300"
canonical_querystring += "&X-Amz-Security-Token=" + token
canonical_querystring += "&X-Amz-SignedHeaders=" + signed_headers
canonical_querystring += "&language-code=en-US&media-encoding=pcm&sample-rate=16000"
```
1. Cree un hash de la carga. Para una solicitud GET, la carga es una cadena vacía.
```
payload_hash = HashSHA256(("").Encode("utf-8")).HexDigest()
```
1. Combine todos los elementos para crear la solicitud canónica.
```
canonical_request = method + '\n'
+ canonical_uri + '\n'
+ canonical_querystring + '\n'
+ canonical_headers + '\n'
+ signed_headers + '\n'
+ payload_hash
```
### Tarea 2: Crear la cadena para firmar
La cadena para firmar contiene metainformación sobre su solicitud. Puede utilizar la cadena para firmar en el siguiente paso cuando calcule la firma de la solicitud. Para obtener más información, consulte [Crear una cadena para firmar de Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/sigv4-create-string-to-sign.html) en la *Referencia general de Amazon Web Services*.
```
string_to_sign=algorithm + "\n"
+ amz_date + "\n"
+ credential_scope + "\n"
+ HashSHA256(canonical_request.Encode("utf-8")).HexDigest()
```
### Tarea 3: Calcular la firma
Genere una clave de firma a partir de la clave de acceso secreta de AWS. Para un mayor grado de protección, la clave derivada es específica de la fecha, el servicio y la región de AWS. Utilice la clave derivada para firmar la solicitud. Para obtener más información, consulte [Calcular la firma para AWS Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/sigv4-calculate-signature.html) en la *Referencia general de Amazon Web Services*.
El código se supone que ha implementado la función `GetSignatureKey` para generar una clave de firma. Para obtener más información y funciones de ejemplo, consulte [Ejemplos de cómo generar una clave de firma para Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/signature-v4-examples.html) en la *Referencia general de Amazon Web Services*.
La función `HMAC(key, data)` representa una función HMAC-SHA256 que devuelve los resultados en formato binario.
```
#Create the signing key
signing_key = GetSignatureKey(secret_key, datestamp, region, service)
# Sign the string_to_sign using the signing key
signature = HMAC.new(signing_key, (string_to_sign).Encode("utf-8"), Sha256()).HexDigest
```
### Tarea 4: Agregar información de firma a la solicitud y crear la URL de la solicitud
Después de calcular la firma, agréguesela a la cadena de la solicitud. Para obtener más información, consulte [Agregar la firma a la solicitud de la API](https://docs.aws.amazon.com/general/latest/gr/sigv4-add-signature-to-request.html) en la *Referencia general de Amazon Web Services*.
```
#Add the authentication information to the query string
canonical_querystring += "&X-Amz-Signature=" + signature
# Sign the string_to_sign using the signing key
request_url = endpoint + canonical_uri + "?" + canonical_querystring
```
## Siguientes pasos
Puede utilizar la URL de la solicitud con su biblioteca de WebSocket para realizar la solicitud al servicio y observar los mensajes. Para obtener más información, consulte [Mensajes y códigos de estado de WebSocket](network-analyer-messages-status.md).
# Mensajes y códigos de estado de WebSocket
Una vez creada una solicitud prefirmada, puede usar la URL de la solicitud con su biblioteca de WebSocket, o una biblioteca que se adapte a su lenguaje de programación, para realizar solicitudes al servicio. Para obtener más información acerca de cómo puede generar esta solicitud prefirmada, consulte [Generar una solicitud prefirmada con la biblioteca WebSocket](network-analyzer-generate-request.md).
## Mensajes de WebSocket
El protocolo WebSocket se puede utilizar para establecer una conexión bidireccional. Los mensajes se pueden transmitir del cliente al servidor y del servidor al cliente. Sin embargo, el analizador de redes solo admite los mensajes que se envían del servidor al cliente. Cualquier mensaje recibido del cliente es inesperado y el servidor cerrará automáticamente la conexión WebSocket si recibe un mensaje del cliente.
Cuando se recibe la solicitud y se inicia una sesión de mensajería de rastreo, el servidor responde con una estructura JSON, que es la carga. Para obtener más información sobre la carga y sobre cómo activar los mensajes de rastreo desde Consola de administración de AWS, consulte [Ver y supervisar los registros de mensajes de rastreo del analizador de redes en tiempo real](network-analyzer-logs.md).
## Códigos de estado de WebSocket
A continuación se muestran los códigos de estado de WebSocket para la comunicación del servidor al cliente. Los códigos de estado de WebSocket siguen el [estándar RFC de cierre normal de conexiones](https://datatracker.ietf.org/doc/html/rfc6455#section-7.3).
A continuación se muestran los códigos de estado admitidos:
+
**1 000**
Este código de estado indica un cierre normal, lo que significa que se ha establecido la conexión WebSocket y se ha completado la solicitud. Este estado se puede observar cuando una sesión está inactiva, lo que hace que se agote el tiempo de espera de la conexión.
+
**1002**
Este código de estado indica que el punto de conexión está finalizando la conexión debido a un error de protocolo.
+
**1003**
Este código de estado indica un estado de error en el que el punto de conexión finalizó la conexión porque recibió datos en un formato que no puede aceptar. El punto de conexión solo admite datos de texto y puede mostrar este código de estado si recibe un mensaje binario o un mensaje del cliente que utiliza un formato no compatible.
+
**1008**
Este código de estado indica un estado de error en el que el punto de conexión finalizó la conexión porque recibió un mensaje que infringe su política. Este estado es genérico y se muestra cuando los demás códigos de estado, como 1003 o 1009, no son aplicables. También verá este estado si es necesario ocultar la política o si se produce un error en la autorización, por ejemplo, si la firma ha caducado.
+
**1011**
Este código de estado indica un estado de error en el que el servidor está finalizando la conexión porque se ha encontrado con una condición inesperada o un error interno que le ha impedido cumplir la solicitud.
## Siguientes pasos
Ahora que ha aprendido a generar una solicitud prefirmada y a observar los mensajes del servidor mediante la conexión WebSocket, puede activar la mensajería de rastreo y empezar a recibir registros de mensajes para la puerta de enlace inalámbrica y los recursos del dispositivo inalámbrico. Para obtener más información, consulte [Ver y supervisar los registros de mensajes de rastreo del analizador de redes en tiempo real](network-analyzer-logs.md).
# Ver y supervisar los registros de mensajes de rastreo del analizador de redes en tiempo real
Si ha agregado recursos a la configuración del analizador de redes, puede activar la mensajería de rastreo para empezar a recibir mensajes de rastreo para sus recursos. Puede utilizar la Consola de administración de AWS, la API de AWS IoT Wireless o la AWS CLI.
## Requisitos previos
Para poder activar la mensajería de rastreo mediante el analizador de redes, debe haber:
+ Agregado los recursos que desea supervisar a la configuración predeterminada del analizador de redes. Para obtener más información, consulte [Agregar recursos y actualizar la configuración del analizador de red](network-analyzer-resources.md).
+ Generado una solicitud prefirmada mediante la URL de la solicitud `StartNetworkAnalyzerStream`. La solicitud se firmará con las credenciales del rol de AWS Identity and Access Management que realiza la solicitud. Para obtener más información, consulte [Crear una URL prefirmada](network-analyzer-generate-request.md#network-analyzer-presigned-url).
## Activar la mensajería de rastreo mediante la consola
Para activar la mensajería de rastreo
1. Abra el [hub de Network Analyzer 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. En la página de detalles de la configuración del analizador de redes, elija **¿Desea activar la mensajería de seguimiento?** y, a continuación, elija **Activar**.
Empezará a recibir mensajes de rastreo cuando el mensaje de rastreo más reciente aparezca primero en la consola.
**nota**
Una vez iniciada la sesión de mensajería, la recepción de mensajes de rastreo puede conllevar costes adicionales hasta que desactive la sesión o abandone la sesión de rastreo. Para obtener más información acerca de los precios, consulte [Precios de AWS IoT Core](https://aws.amazon.com/iot-core/pricing/).
## Ver y supervisar los mensajes de rastreo
Tras activar la mensajería de rastreo, se establece la conexión de WebSocket y los mensajes de rastreo comienzan a aparecer en tiempo real, primero los más recientes. Puede personalizar las preferencias para especificar el número de mensajes de rastreo que se mostrarán en cada página y para mostrar solo los campos relevantes de cada mensaje. Por ejemplo, puede personalizar el registro de mensajes de rastreo para que muestre solo los registros de los recursos de las puertas de enlace inalámbricas que tengan el **nivel de registro** establecido en `ERROR`, para permitirle identificar y depurar rápidamente los errores en las puertas de enlace. Los mensajes de rastreo contienen la siguiente información.
+ **Número de mensaje**: un número único que muestra el último mensaje recibido primero.
+ **ID del recurso**: la puerta de enlace inalámbrica o el ID del dispositivo inalámbrico del recurso.
+ **Marca de tiempo**: hora en que se recibió el mensaje.
+ **ID de mensaje**: un identificador que AWS IoT Core para LoRaWAN asigna a cada mensaje recibido.
+ **FPort**: el puerto de frecuencia para comunicarse con el dispositivo mediante la conexión WebSocket.
+ **DevEui**: el identificador único extendido (EUI) de su dispositivo inalámbrico.
+ **Recurso**: si el recurso supervisado es un dispositivo inalámbrico o una puerta de enlace inalámbrica.
+ **Evento**: el evento de un mensaje de registro de un dispositivo inalámbrico, que puede ser **Join**, **Rejoin**, **Uplink\$1Data**, **Downlink\$1Data** o **Registration**.
+ **Nivel de registro**: información sobre la secuencia de registro `INFO` o `ERROR` de su dispositivo.
## Mensaje de registro JSON del analizador de redes
También puede elegir un mensaje de rastreo a la vez para ver la carga JSON de ese mensaje. Según el mensaje que seleccione en los registros de mensajes de rastreo, verá información en la carga JSON que indica que contiene dos partes: **CustomerLog** y **LoRaFrame.**
**CustomerLog**
La parte **CustomerLog** del JSON muestra el tipo y el identificador del recurso que recibió el mensaje, el nivel de registro y el contenido del mensaje. En el siguiente ejemplo se muestra un mensaje de registro **CustomerLog**. Puede usar el campo `message` del JSON para obtener más información sobre el error y cómo resolverlo.
**LoRaFrame**
La parte **LoRaFrame** del JSON tiene un **ID de mensaje** y contiene información sobre la carga física del dispositivo y los metadatos inalámbricos.
La estructura del mensaje de rastreo se muestra en el ejemplo siguiente.
```
export type TraceMessage = {
ResourceId: string;
Timestamp: string;
LoRaFrame:
{
MessageId: string;
PhysicalPayload: any;
WirelessMetadata:
{
fPort: number;
dataRate: number;
devEui: string;
frequency: number,
timestamp: string;
},
}
CustomerLog:
{
resource: string;
wirelessDeviceId: string;
wirelessDeviceType: string;
event: string;
logLevel: string;
messageId: string;
message: string;
},
};
```
## Revisión y próximos pasos
En esta sección ha visto los mensajes de rastreo y ha aprendido a utilizar la información para depurar errores. Una vez que haya visto todos los mensajes, puede:
+
**Desactivar la mensajería de rastreo**
Para evitar incurrir en costes adicionales, puede desactivar la sesión de mensajería de rastreo. Al desactivar la sesión, se desconecta la conexión de WebSocket, por lo que no recibirá ningún mensaje de rastreo adicional. Puede seguir viendo los mensajes existentes en la consola.
+
**Editar la información del marco para su configuración**
Puede editar la configuración del analizador de redes y elegir si desea desactivar la información del marco y elegir los niveles de registro de sus mensajes. Antes de actualizar la configuración, considere la posibilidad de desactivar la sesión de mensajería de rastreo. Para realizar estas modificaciones, abra la [página de detalles del analizador de redes en la consola de AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer/details/NetworkAnalyzerConfig_Default) y seleccione **Editar**. A continuación, puede actualizar la configuración con los nuevos ajustes de configuración y activar la mensajería de rastreo para ver los mensajes actualizados.
+
**Agregar recursos a la configuración**
También puede agregar más recursos a la configuración de su analizador de redes y supervisarlos en tiempo real. Puede agregar un total combinado de 250 recursos de puerta de enlace inalámbrica y dispositivo inalámbrico. Para agregar recursos, en la [página de detalles del analizador de redes de la consola de AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer/details/NetworkAnalyzerConfig_Default), seleccione la pestaña **Recursos** y, a continuación, elija **Agregar recursos**. A continuación, puede actualizar la configuración con los nuevos recursos y activar la mensajería de rastreo para ver los mensajes actualizados de los recursos adicionales.
Para obtener más información sobre cómo actualizar la configuración del analizador de redes mediante la edición de los ajustes de configuración y la incorporación de recursos, consulte [Agregar recursos y actualizar la configuración del analizador de red](network-analyzer-resources.md).
# Depurar y solucionar los problemas de sus grupos de multidifusión y tareas de FUOTA mediante el analizador de redes
Los recursos inalámbricos que puede supervisar incluyen dispositivos LoRaWAN, puertas de enlace LoRaWAN y grupos de multidifusión. También puede usar el analizador de redes para depurar y solucionar cualquier problema relacionado con su tarea de FUOTA. También puedes supervisar y rastrear los mensajes relacionados con la configuración, la transmisión de datos y la consulta de estado cuando la tarea de FUOTA esté en curso.
Para supervisar la tarea de FUOTA, si la tarea contiene grupos de multidifusión, debe agregar tanto el grupo de multidifusión como los dispositivos del grupo a la configuración del analizador de redes. También debe activar la información de marco y de marco de multidifusión para realizar un seguimiento de los mensajes de enlace ascendente y descendente de unidifusión y multidifusión que se intercambian con el grupo de multidifusión y los dispositivos mientras la tarea FUOTA está en curso.
Para supervisar los grupos de multidifusión, puede agregarlos a la configuración de su analizador de redes y utilizar la información del marco de multidifusión para solucionar los problemas de los mensajes de enlace descendente de multidifusión que se envían a estos grupos. Para solucionar problemas de los dispositivos que intentan unirse a un grupo en el que se utiliza la comunicación de unidifusión, también debe incluir estos dispositivos en la configuración del analizador de redes. Para supervisar únicamente la comunicación de unidifusión con los dispositivos del grupo, active la información de marco para los dispositivos inalámbricos. Este enfoque garantiza una supervisión y un diagnóstico exhaustivos tanto para los grupos de multidifusión como para los dispositivos que se unen al grupo.
En las siguientes secciones se describe cómo depurar y solucionar los problemas de los grupos de multidifusión y las tareas de FUOTA mediante un analizador de redes.
**Topics**
+ [Depurar las tareas FUOTA que solo contengan dispositivos](#lorawan-network-analyzer-fuota-devices)
+ [Depurar las tareas de FUOTA con grupos de multidifusión](#lorawan-network-analyzer-fuota-multicast)
+ [Depurar los dispositivos que intentan unirse a un grupo de multidifusión](#lorawan-network-analyzer-fuota-multicast)
+ [Depurar una sesión de grupo de multidifusión](#lorawan-network-analyzer-fuota-multicastsession)
## Depurar las tareas FUOTA que solo contengan dispositivos
Puede usar el analizador de redes para depurar una tarea de FUOTA a la que solo se hayan agregado dispositivos LoRaWAN a la tarea. Para obtener información sobre cómo agregar dispositivos a una tarea de FUOTA, consulte [Agregar dispositivos y grupos de multidifusión a una tarea de FUOTA y programar una sesión FUOTA](lorawan-fuota-add-devices.md). Para depurar la tarea de FUOTA, realice los siguientes pasos:
1. Genere una configuración de analizador de redes activando la información del marco para los dispositivos inalámbricos, de modo que pueda supervisar los mensajes de enlace ascendente y descendente de FUOTA que se intercambian con los dispositivos mientras la tarea está en curso.
1. Agregue los dispositivos de su tarea de FUOTA a la configuración del analizador de redes mediante sus identificadores de dispositivos inalámbricos.
1. Active la mensajería de rastreo para empezar a recibir mensajes de rastreo para los dispositivos de la configuración de su analizador de redes.
En la columna `applicationCommandType` de la información del mensaje de seguimiento, empezará a recibir mensajes de enlace descendente de unidifusión relacionados con la configuración de la transmisión y fragmentación de datos.
**nota**
Si no ve la columna `applicationCommandType` en la tabla de mensajes de seguimiento, puede ajustar la configuración para que la tabla muestre esta columna.
También puede ver `applicationCommandType` y otros mensajes detallados en el mensaje de registro JSON, en **WirelessMetadata > ApplicationInfo**.
## Depurar las tareas de FUOTA con grupos de multidifusión
Puede usar el analizador de redes para depurar una tarea de FUOTA a la que se hayan agregado grupos de multidifusión y dispositivos LoRaWAN al grupo. Para obtener información sobre cómo agregar dispositivos a una tarea de FUOTA, consulte [Agregar dispositivos y grupos de multidifusión a una tarea de FUOTA y programar una sesión FUOTA](lorawan-fuota-add-devices.md). Para depurar la tarea de FUOTA, realice los siguientes pasos:
1. Cree una configuración de analizador de red activando los ajustes de información del marco e información del marco de multidifusión para los dispositivos inalámbricos y los grupos de multidifusión.
1. Agregue el grupo de multidifusión de su tarea de FUOTA a la configuración del analizador de redes mediante su identificador de grupo de multidifusión. Al habilitar la información de marcos de multidifusión, puede depurar el mensaje de datos del firmware y los mensajes de consulta de estado de FUOTA que se envían al grupo mientras la tarea de FUOTA está en curso.
1. Agregue los dispositivos de su grupo de multidifusión a la configuración del analizador de redes mediante sus identificadores de dispositivos inalámbricos. Al activar la información del marco, puede supervisar los mensajes de enlace ascendente y descendente que se intercambian directamente con los dispositivos mientras la tarea de FUOTA está en curso.
1. Active la mensajería de rastreo para empezar a recibir mensajes de rastreo para los dispositivos y grupos de multidifusión de la configuración de su analizador de redes.
A continuación, puede ver los mensajes de seguimiento y depurarlos mediante la columna `applicationCommandType` de la tabla de mensajes de seguimiento, y usar los detalles del mensaje de registro JSON como se describe en [Depurar las tareas FUOTA que solo contengan dispositivos](#lorawan-network-analyzer-fuota-devices).
## Depurar los dispositivos que intentan unirse a un grupo de multidifusión
Puede usar el analizador de redes para depurar los dispositivos que intentan unirse a un grupo de multidifusión. Para obtener información sobre cómo agregar dispositivos a un grupo de multidifusión, consulte [Crear grupos de multidifusión y agregar dispositivos al grupo](lorawan-create-multicast-groups.md). Para depurar el grupo de multidifusión, realice los siguientes pasos:
1. Cree una configuración de analizador de redes activando la información del marco para los dispositivos inalámbricos.
1. Agregue los dispositivos que desee supervisar a la configuración del analizador de redes mediante sus identificadores de dispositivos inalámbricos.
1. Active la mensajería de rastreo para empezar a recibir mensajes de rastreo para los dispositivos de la configuración de su analizador de redes.
1. Comience a asociar los dispositivos al grupo de multidifusión una vez que se haya activado la mensajería de rastreo para los dispositivos del grupo.
## Depurar una sesión de grupo de multidifusión
Puede usar el analizador de redes para depurar una sesión de grupo de multidifusión. Para obtener más información, consulte [Programar un mensaje de enlace descendente para enviarlo a los dispositivos de su grupo de multidifusión](lorawan-multicast-schedule-downlink.md). Para depurar una sesión de grupo de multidifusión, realice los siguientes pasos:
1. Cree una configuración de analizador de redes activando la información del marco de multidifusión para el grupo de multidifusión.
1. Agregue el grupo de multidifusión que desee supervisar a la configuración del analizador de redes mediante su identificador de grupo de multidifusión.
1. Antes de que comience la sesión de multidifusión, active la mensajería de rastreo para empezar a recibir mensajes de rastreo para la sesión del grupo de multidifusión.
1. Inicie la sesión del grupo de multidifusión y supervise el estado viendo los mensajes que se muestran en la tabla de mensajes de rastreo y en el mensaje de registro JSON.
En la tabla de mensajes de rastreo, se mostrará `MulticastAddr` en la columna `DevAddr`. En el mensaje de registro JSON, puede ver información detallada, como el `MulticastGroupId` en **WirelessMetadata > ApplicationInfo**.