Verwenden von CloudWatch Insights zum Filtern von Protokollen nach AWS IoT Wireless

Sie können CloudWatch-Protokolle zwar verwenden, um Filterausdrücke zu erstellen, wir empfehlen jedoch, CloudWatch Insights zu verwenden, um Filterausdrücke je nach Ihrer Anwendung effektiver zu erstellen und zu verwenden.

Wir empfehlen, dass Sie zunächst CloudWatch-Protokollgruppen verwenden, um mehr über die verschiedenen Ressourcentypen, ihre Ereignistypen und Protokollebenen zu erfahren, mit denen Sie Protokolleinträge in der Konsole anzeigen können. Anschließend können Sie die Beispiele einiger Filterausdrücke auf dieser Seite als Referenz verwenden, um Ihre eigenen Filter für Ihre AWS IoT Wireless-Ressourcen zu erstellen.

Anzeigen von AWS IoT-Protokollen in der Konsole für CloudWatch Insights-Protokolle

In der CloudWatch-Konsole werden CloudWatch-Protokolle in einer Protokollgruppe namens /aws/iotwireless angezeigt. Weitere Informationen zu CloudWatch-Protokollen finden Sie unter CloudWatch-Protokolle.

Um die AWS IoT-Protokolle in der CloudWatch-Konsole anzuzeigen

Wählen Sie im Navigationsbereich der CloudWatch-Konsole Protokolle Insights aus.

1. Geben Sie im Textfeld Filter /aws/iotwireless ein und wählen Sie dann die /aws/iotwireless Protokolleinblicke aus.

2. Um eine vollständige Liste der Protokollgruppen anzuzeigen, wählen Sie Protokollgruppe(n) aus. Um nach Protokollgruppen für AWS IoT Wireless zu suchen, wählen Sie /aws/iotwireless.

Sie können jetzt mit der Eingabe von Abfragen beginnen, um die Protokollgruppen zu filtern. Die folgenden Abschnitte enthalten einige nützliche Abfragen, die Ihnen helfen, Einblicke in Ihre Ressourcenmetriken zu gewinnen.

Erstellen Sie nützliche Abfragen zum Filtern und Gewinnen von Erkenntnissen für AWS IoT Wireless

Sie können Filterausdrücke verwenden, um zusätzliche hilfreiche Protokollinformationen mit CloudWatch Insights anzuzeigen. Im Folgenden werden einige Beispielabfragen gezeigt:

Nur Protokolle für bestimmte Ressourcentypen anzeigen

Sie können eine Abfrage erstellen, mit der Sie Protokolle nur für bestimmte Ressourcentypen anzeigen können, z. B. für ein LoRaWAN-Gateway oder ein Sidewalk-Gerät. Um beispielsweise Protokolle so zu filtern, dass nur Nachrichten für Sidewalk-Geräte angezeigt werden, können Sie die folgende Abfrage eingeben und Abfrage ausführen auswählen: Um diese Abfrage zu speichern, wählen Sie Speichern aus.

fields @message
| filter @message like /Sidewalk/

Nachdem die Abfrage ausgeführt wurde, werden die Ergebnisse auf der Registerkarte Protokolle angezeigt, auf der die Zeitstempel für Protokolle angezeigt werden, die sich auf Sidewalk-Geräte in Ihrem Konto beziehen. Außerdem wird ein Balkendiagramm angezeigt, das den Zeitpunkt des Auftretens der Ereignisse anzeigt, sofern es solche Ereignisse gab, die zuvor im Zusammenhang mit Ihrem Sidewalk-Gerät aufgetreten sind. Im Folgenden finden Sie ein Beispiel, wenn Sie eines der Ergebnisse auf der Registerkarte Protokolle erweitern. Wenn Sie Fehler im Zusammenhang mit Sidewalk-Geräten beheben möchten, können Sie alternativ einen weiteren Filter hinzufügen, der die Protokollebene auf ERROR festlegt und nur Fehlerinformationen anzeigt.

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

Bestimmte Meldungen oder Ereignisse anzeigen

Sie können eine Abfrage erstellen, mit der Sie bestimmte Meldungen anzeigen und beobachten können, wann die Ereignisse eingetreten sind. Wenn Sie beispielsweise sehen möchten, wann Ihre Downlink-Nachricht von Ihrem LoRaWAN-WLAN-Gerät gesendet wurde, können Sie die folgende Abfrage eingeben und Abfrage ausführen auswählen. Um diese Abfrage zu speichern, wählen Sie Speichern aus.

filter @message like /Downlink message sent/

Nachdem die Abfrage ausgeführt wurde, sehen Sie die Ergebnisse auf der Registerkarte Protokolle, auf der die Zeitstempel angezeigt werden, zu denen die Downlink-Nachricht erfolgreich an Ihr WLAN-Gerät gesendet wurde. Außerdem wird ein Balkendiagramm angezeigt, das den Zeitpunkt anzeigt, zu dem eine Downlink-Nachricht gesendet wurde, falls zuvor Downlink-Nachrichten an Ihr WLAN-Gerät gesendet wurden. Im Folgenden finden Sie ein Beispiel, wenn Sie eines der Ergebnisse auf der Registerkarte Protokolle erweitern. Wenn keine Downlink-Nachricht gesendet wurde, können Sie die Abfrage auch so ändern, dass nur Ergebnisse angezeigt werden, wenn die Nachricht nicht gesendet wurde, sodass Sie das Problem debuggen können.

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

Nächste Schritte

Sie haben gelernt, wie Sie CloudWatch Insights verwenden können, um weitere hilfreiche Informationen zu erhalten, indem Sie Abfragen zum Filtern von Protokollnachrichten erstellen. Sie können einige der zuvor beschriebenen Filter kombinieren und je nach der Ressource, die Sie überwachen, Ihre eigenen Filter entwerfen. Weitere Informationen zu CloudWatch Logs Insights finden Sie unter Analysieren von Protokolldaten mit CloudWatch Logs Insights.

Nachdem Sie Abfragen mit CloudWatch Insights erstellt haben und diese gespeichert haben, können Sie die gespeicherten Abfragen nach Bedarf laden und ausführen. Wenn Sie alternativ in der CloudWatch Logs Insights-Konsole auf die Schaltfläche Verlauf klicken, können Sie die zuvor ausgeführten Abfragen anzeigen und sie bei Bedarf erneut ausführen oder sie weiter ändern, indem Sie zusätzliche Abfragen erstellen.