Utilización de CloudWatch Insights para filtrar registros de AWS IoT Wireless

Si bien puede utilizar CloudWatch Logs para crear expresiones de filtro, le recomendamos que utilice CloudWatch Insights para crear y utilizar expresiones de filtro de forma más eficaz en función de su aplicación.

Recomendamos que utilice primero los grupos de registros de CloudWatch para obtener información sobre los distintos tipos de recursos, sus tipos de eventos y los niveles de registro que puede utilizar para ver las entradas de registro en la consola. A continuación, puede utilizar los ejemplos de algunas expresiones de filtro de esta página como referencia para crear sus propios filtros para los recursos de AWS IoT Wireless.

Visualización de registros de AWS IoT en la consola de CloudWatch Logs Insights

En la consola de CloudWatch, los registros de CloudWatch aparecen en un grupo de registro denominado /aws/iotwireless. Para obtener más información sobre CloudWatch Logs, consulte CloudWatch Logs.

Para visualizar los registros de AWS IoT en la consola de CloudWatch

Vaya a la consola de CloudWatch y seleccione Logs Insights en el panel de navegación.

1. En el cuadro de texto Filtro, introduzca /aws/iotwireless y, a continuación, elija /aws/iotwireless Logs Insights.

2. Para ver una lista completa de los grupos de registros, elija Seleccionar grupo(s) de registros. Para buscar grupos de registros de AWS IoT Wireless, elija /aws/iotwireless.

Ahora puede empezar a introducir consultas para filtrar los grupos de registros. Las siguientes secciones contienen algunas consultas útiles que le ayudarán a obtener información sobre las métricas de sus recursos.

Creación de consultas útiles para filtrarlas y obtener información de AWS IoT Wireless

Puede usar expresiones de filtro para mostrar información de registro adicional útil con CloudWatch Insights. A continuación se muestran algunos ejemplos de consultas:

Mostrar solo los registros de tipos de recursos específicos

Puede crear una consulta que le ayude a mostrar los registros solo de tipos de recursos específicos, como una puerta de enlace LoRaWAN o un dispositivo Sidewalk. Por ejemplo, para filtrar los registros y mostrar solo los mensajes de los dispositivos Sidewalk, puede introducir la siguiente consulta y elegir Ejecutar consulta. Para guardar esta consulta, elija Save (Guardar).

fields @message
| filter @message like /Sidewalk/

Cuando se ejecute la consulta, verá los resultados en la pestaña Registros, que muestra las marcas temporales de los registros relacionados con los dispositivos de Sidewalk de su cuenta. También verá un gráfico de barras en el que aparece la hora a la que se produjeron los eventos, si se produjeron anteriormente y estuvieron relacionados con su dispositivo Sidewalk. A continuación se muestra un ejemplo si amplía uno de los resultados de la pestaña Registros. Como alternativa, si quiere solucionar los errores relacionados con los dispositivos Sidewalk, puede agregar otro filtro que establezca el nivel de registro en ERROR y muestre solo la información sobre los errores.

Field	          Value
@ingestionTime      1623894967640
@log	             954314929104:/aws/iotwireless
@logStream	   WirelessDevice-Downlink_Data-715adccfb34170214ec2f6667ddfa13cb5af2c3ddfc52fbeee0e554a2e780bed
@message	     {                    
                    "resource": "WirelessDevice",
                    "wirelessDeviceId": "3b058d05-4e84-4e1a-b026-4932bddf978d",
                    "wirelessDeviceType": "Sidewalk",
                    "devEui": "feffff000000011a",
                    "event": "Downlink_Data",
                    "logLevel": "INFO",
                    "messageId": "7e752a10-28f5-45a5-923f-6fa7133fedda",
                    "message": "Successfully sent downlink message. Amazon SidewalkId = 2000000006, Sequence number = 0"
                    }
@timestamp          1623894967640
devEui	           feffff000000011a
event	        Downlink_Data
logLevel            INFO
message	          Successfully sent downlink message. Amazon SidewalkId = 2000000006, Sequence number = 0
messageId	    7e752a10-28f5-45a5-923f-6fa7133fedda
resource	     WirelessDevice
wirelessDeviceId    3b058d05-4e84-4e1a-b026-4932bddf978d
wirelessDeviceType  Sidewalk

Mostrar mensajes o eventos específicos

Puede crear una consulta que le ayude a mostrar mensajes específicos y observar cuándo ocurrieron los eventos. Por ejemplo, si quiere ver cuándo se envió el mensaje de enlace descendente desde su dispositivo inalámbrico LoRaWAN, puede introducir la siguiente consulta y elegir Ejecutar consulta. Para guardar esta consulta, elija Save (Guardar).

filter @message like /Downlink message sent/

Una vez ejecutada la consulta, verá los resultados en la pestaña Registros, que muestra las marcas temporales en las que el mensaje de enlace descendente se envió correctamente a su dispositivo inalámbrico. También verá un gráfico de barras con la hora a la que se envió un mensaje de enlace descendente, si ya se habían enviado mensajes de enlace descendente a su dispositivo inalámbrico. A continuación se muestra un ejemplo si amplía uno de los resultados de la pestaña Registros. Como alternativa, si no se envió un mensaje de enlace descendente, puede modificar la consulta para que muestre solo los resultados de cuando el mensaje no se haya enviado, de forma que puedas solucionar el problema.

Field	          Value
@ingestionTime      1623884043676
@log	             954314929104:/aws/iotwireless
@logStream	   WirelessDevice-Downlink_Data-42d0e6d09ba4d7015f4e9756fcdc616d401cd85fe3ac19854d9fbd866153c872
@message	     {
                    "timestamp": "2021-06-16T22:54:00.770493863Z",
                    "resource": "WirelessDevice",
                    "wirelessDeviceId": "3b058d05-4e84-4e1a-b026-4932bddf978d",
                    "wirelessDeviceType": "LoRaWAN",
                    "devEui": "feffff000000011a",
                    "event": "Downlink_Data",
                    "logLevel": "INFO",
                    "messageId": "7e752a10-28f5-45a5-923f-6fa7133fedda",
                    "message": "Downlink message sent. MessageId: 7e752a10-28f5-45a5-923f-6fa7133fedda"
                    }
@timestamp          1623884040858
devEui	           feffff000000011a
event	        Downlink_Data
logLevel            INFO
message	          Downlink message sent. MessageId: 7e752a10-28f5-45a5-923f-6fa7133fedda
messageId	    7e752a10-28f5-45a5-923f-6fa7133fedda
resource	     WirelessDevice
timestamp	    2021-06-16T22:54:00.770493863Z
wirelessDeviceId    3b058d05-4e84-4e1a-b026-4932bddf978d
wirelessDeviceType  LoRaWAN

Siguientes pasos

Ha aprendido a utilizar CloudWatch Insights para obtener más información útil mediante la creación de consultas para filtrar los mensajes de registro. Puede combinar algunos de los filtros descritos anteriormente y diseñar sus propios filtros en función del recurso que esté monitorizando. Para obtener información sobre el uso de CloudWatch Insights, consulte Análisis de datos de registro con CloudWatch Insights.

Una vez creadas las consultas con CloudWatch Insights, si las ha guardado, puede cargarlas y ejecutarlas según sea necesario. Como alternativa, si hace clic en el botón Historial de la consola de CloudWatch Logs Insights, puede ver las consultas ejecutadas anteriormente y volver a ejecutarlas según sea necesario, o modificarlas aún más creando consultas adicionales.