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 AWS Management Console, 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.

• 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.

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 y elija la configuración del analizador de redes, NetworkAnalyzerConfig_Default.

2. 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.

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_Data, Downlink_Data 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 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, 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.