使用 CloudWatch Insights 來篩選 AWS IoT Wireless 的記錄 - AWS IoT Wireless

使用 CloudWatch Insights 來篩選 AWS IoT Wireless 的記錄

儘管您可以使用 CloudWatch Logs 來建立篩選表達式,但我們建議您使用 CloudWatch Insights,根據您的應用程式更有效地建立和使用篩選表達式。

建議您首先使用 CloudWatch Log groups (記錄群組),來了解不同類型的資源、其事件類型,以及您可以用來在主控台中檢視記錄項目的日誌層級。然後,您可以使用此頁面上某些篩選表達式的範例作為參考,為 AWS IoT Wireless 資源建立自己的篩選條件。

在 CloudWatch Logs 洞察主控台中檢視 AWS IoT 記錄

CloudWatch 主控台 中,CloudWatch 記錄出現在名為 /aws/iotwireless 的記錄群組中。如需 CloudWatch Logs 的詳細資訊,請參閱 CloudWatch Logs

在 CloudWatch 主控台中檢視您的 AWS IoT 記錄

導覽至 CloudWatch 主控台,然後在導覽窗格中選擇 Logs Insights (記錄洞察)。

  1. Filter (篩選條件) 文字方塊中,輸入 /aws/iotwireless,然後選擇 /aws/iotwireless 記錄洞察。

  2. 若要查看記錄群組的完整清單,請選擇 Select log group(s) (選取記錄群組)。若要查看 AWS IoT Wireless 的記錄群組,請選擇 /aws/iotwireless

您現在可以開始輸入查詢以篩選記錄群組。下列各節包含一些實用查詢,將協助您取得有關資源指標的洞察。

建立實用查詢來篩選並取得 AWS IoT Wireless 的洞察

您可以使用篩選表達式,搭配 CloudWatch Insights 來顯示其他實用記錄資訊。下列顯示一些範例查詢:

僅顯示特定資源類型的記錄

您可以建立一個查詢,協助您僅顯示特定資源類型 (例如 LoRaWAN 閘道或 Sidewalk 裝置) 的記錄。例如,若要篩選記錄以僅顯示 Sidewalk 裝置的訊息,您可以輸入下列查詢並選擇 Run query (執行查詢)。若要儲存此查詢,請選擇 Save (儲存)。

fields @message | filter @message like /Sidewalk/

在執行查詢之後,您會在 Logs (記錄) 標籤中看到結果,其中顯示與您帳戶中 Sidewalk 裝置相關的記錄時間戳記。如果先前發生與 Sidewalk 裝置相關的事件,您也會看到橫條圖,其中顯示事件發生的時間。如果展開 Logs (日誌) 標籤中的其中一個結果,下列會顯示一個範例。或者,如果想要疑難排解與 Sidewalk 裝置相關的錯誤,您可以新增另一個篩選條件,將日誌層級設定為 ERROR 並僅顯示錯誤資訊。

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

顯示特定訊息或事件

您可以建立一個查詢,協助您顯示特定訊息,並在事件發生時進行觀察。例如,如果您想查看何時從 LoRaWAN 無線裝置傳送下行訊息,您可以輸入下列查詢並選擇 Run query (執行查詢)。若要儲存此查詢,請選擇 Save (儲存)。

filter @message like /Downlink message sent/

在執行查詢之後,您會在 Logs (記錄) 標籤中看到結果,其中顯示下行訊息成功傳送至無線裝置時的時間戳記。您也會看到長條圖,其中顯示下行訊息的傳送時間,如果先前有下行訊息傳送到無線裝置的話。如果展開 Logs (日誌) 標籤中的其中一個結果,下列會顯示一個範例。或者,如果未傳送下行訊息,您可以修改查詢,僅顯示未傳送訊息時的結果,以便您可以偵錯問題。

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

後續步驟

您已了解如何使用 CloudWatch Insights,透過建立查詢來篩選記錄訊息,以取得更多實用資訊。您可以結合先前描述的某些篩選條件,並根據您正在監控的資源設計自己的篩選條件。如需使用 CloudWatch Insights 的詳細資訊,請參閱使用 CloudWatch Insights 分析記錄資料

在使用了 CloudWatch Insights 來建立查詢之後,如果您已儲存這些查詢,則可以視需要載入並執行已儲存的查詢。或者,如果您在 CloudWatch Logs Insights (記錄洞察) 主控台中按一下 History (歷史記錄) 按鈕,則可以檢視先前執行的查詢,並視需要重新執行它們,或建立其他查詢來進一步修改它們。