

# 使用 CloudWatch Insights 來篩選 AWS IoT Wireless 的記錄
<a name="cwl-insights"></a>

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

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

## 在 CloudWatch Logs 洞察主控台中檢視 AWS IoT 記錄
<a name="viewing-logs"></a>

在 [CloudWatch 主控台](https://console.aws.amazon.com/cloudwatch) 中，CloudWatch 記錄出現在名為 **/aws/iotwireless** 的記錄群組中。如需 CloudWatch Logs 的詳細資訊，請參閱 [CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html)。

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

導覽至 [CloudWatch 主控台](https://console.aws.amazon.com/cloudwatch)，然後在導覽窗格中選擇 **Logs Insights** (記錄洞察)。

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

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

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

## 建立實用查詢來篩選並取得 AWS IoT Wireless 的洞察
<a name="insights-resource-filter"></a>

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

### 僅顯示特定資源類型的記錄
<a name="insights-gateway-filter"></a>

您可以建立一個查詢，協助您僅顯示特定資源類型 (例如 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
```

### 顯示特定訊息或事件
<a name="insights-gateway-filter"></a>

您可以建立一個查詢，協助您顯示特定訊息，並在事件發生時進行觀察。例如，如果您想查看何時從 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
```

## 後續步驟
<a name="insights-next-steps"></a>

您已了解如何使用 CloudWatch Insights，透過建立查詢來篩選記錄訊息，以取得更多實用資訊。您可以結合先前描述的某些篩選條件，並根據您正在監控的資源設計自己的篩選條件。如需使用 CloudWatch Insights 的詳細資訊，請參閱[使用 CloudWatch Insights 分析記錄資料](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData)。

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