# 透過 AWS Toolkit for JetBrains 使用 CloudWatch Logs Insights
<a name="cloudwatch-log-insights"></a>

您可以透過 AWS Toolkit for JetBrains 使用 Amazon CloudWatch Logs Insights。CloudWatch Logs Insights 可讓您以互動方式搜尋和分析 Amazon CloudWatch Logs 中的日誌資料。如需詳細資訊，請參閱《Amazon CloudWatch Logs 使用者指南》**中的[使用 CloudWatch Logs Insights 分析日誌資料](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)。

## CloudWatch Logs Insights 的 IAM 許可
<a name="iam-permissions-for-cwlog-insights"></a>

 您需要下列許可才能執行和檢視 CloudWatch Logs Insights 查詢結果：

```
{
  "Version": "2012-10-17",
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "logs:StartQuery",
        "logs:GetQueryResults",
        "logs:GetLogRecord",
        "logs:describeLogGroups",
        "logs:describeLogStreams"
      ],
      "Resource" : "*"
    }
  ]
}
```

以下許可不是必要的，但將允許 AWS Toolkit for JetBrains 在您關閉相關聯結果窗格或 IDE 時，自動停止任何當下正在執行的查詢。

```
{
  "Version": "2012-10-17",
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "logs:StopQuery"
      ],
      "Resource" : "*"
    }
  ]
}
```

## 使用 CloudWatch Logs Insights
<a name="working-with-cwlog-insights"></a>

**開啟 CloudWatch Logs Insights 查詢編輯器**

1. 開啟 AWS Explorer。

1.  按兩下 **CloudWatch Logs** 節點展開日誌群組清單。

1.  用滑鼠右鍵按一下要開啟的日誌群組，然後選擇**開啟查詢編輯器**。

**開始 CloudWatch Logs Insights 查詢**

1. 在**查詢日誌群組**視窗中，根據需要變更查詢參數。

   您可以依照日期或相對時間選擇時間範圍。

   **查詢日誌群組**欄位接受 CloudWatch Logs Insights 查詢語法。如需詳細資訊，請參閱《Amazon CloudWatch Logs 使用者指南》**中的[CloudWatch Logs Insights 查詢語法](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html)。

1.  選擇**執行**即可開始查詢。

**儲存 CloudWatch Logs Insights 查詢**

1. 輸入查詢名稱。

1.  選擇**儲存查詢**。

    選取的日誌群組和查詢會儲存到您的 AWS 帳戶。時間範圍不會儲存。

   您可以在 CloudWatch Logs Insights 的 AWS 管理主控台 頁面上，擷取和重複使用儲存的查詢。

**擷取已儲存的 CloudWatch Logs Insights 查詢**

1.  在**查詢日誌群組**視窗中，選擇**擷取已儲存查詢**。

1.  選擇所需的查詢並**確定**。

   選取的日誌群組和查詢會取代現有對話方塊中的任何項目。

**瀏覽查詢結果**
+  在 CloudWatch Logs Insights**查詢結果**視窗的右上角選擇**開啟查詢編輯器**。

**檢視個別日誌記錄**
+  在查詢結果窗格中，按兩下一列以開啟包含目標日誌記錄詳細資料的新索引標籤。

   您也可以選擇右上角**檢視日誌串流**，瀏覽至日誌記錄的相關日誌串流。