# 透過 AWS Toolkit for JetBrains 使用 CloudWatch Logs
Amazon CloudWatch Logs 可將您使用的所有系統、應用程式和 AWS 服務的日誌，集中在可高度擴展的單一服務中。然後，您可以輕鬆檢視日誌、在日誌中搜尋特定的錯誤碼或模式、根據特定欄位篩選日誌，或安全封存日誌以供日後分析。如需更多詳細資訊，請參閱 *Amazon CloudWatch 使用者指南*中的[什麼是 Amazon CloudWatch Logs？](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatchLogs.html)。
下列主題說明如何透過 AWS Toolkit for JetBrains 來使用 AWS 帳戶中的 CloudWatch Logs。
**Topics**
+ [檢視 CloudWatch 日誌群組和日誌串流](viewing-CloudWatch-logs.md)
+ [使用 CloudWatch 日誌事件](working-CloudWatch-log-events.md)
+ [使用 CloudWatch Logs Insights](cloudwatch-log-insights.md)
# 使用 AWS Toolkit for JetBrains 檢視 CloudWatch 日誌群組和日誌串流
*日誌串流*是一系列共用相同來源的日誌事件。每個單獨日誌串流是由 CloudWatch Logs 中的單獨日誌來源所組成。
*日誌群組*是共用相同保留、監控和存取控制設定的日誌串流群組。您可以定義日誌群組，並指定放入每個群組的串流。可以屬於一個日誌群組的日誌串流數量並沒有限制。
如需詳細資訊，請參閱 *Amazon CloudWatch Logs 使用者指南*中的[使用日誌群組和日誌串流](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Working-with-log-groups-and-streams.html)。
**Topics**
+ [以 **CloudWatch Logs** 節點檢視日誌群組和日誌串流](#viewing-log-groups)
+ [透過 **Lambda** 節點檢視日誌串流](#viewing-lamba-log-groups)
+ [透過 **Amazon ECS** 節點檢視日誌串流](#viewing-ecs-log-groups)
## 以 **CloudWatch Logs** 節點檢視日誌群組和日誌串流
1. 開啟 AWS Explorer (如尚未開啟的話)。
1. 按一下 **CloudWatch Logs** 節點展開日誌群組清單。
[目前 AWS 區域](setup-region.md#setup-region-current-region)的日誌群組會顯示在 **CloudWatch Logs** 節點下方。
1. 若要檢視日誌群組中的日誌串流，請執行下列其中一項操作：
+ 請按兩下日誌群組的名稱。
+ 用滑鼠右鍵按一下日誌群組並選擇**檢視日誌串流**。
日誌群組的內容會顯示在**日誌串流**窗格中。如需了解如何與每個串流中的日誌事件互動，請參閱 [使用 CloudWatch 日誌事件使用 CloudWatch Logs Insights](working-CloudWatch-log-events.md)。
![\[在 AWS Explorer 中檢視 CloudWatch 日誌群組中的日誌串流\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/cloudwatch-view-log-streams.png)
## 透過 **Lambda** 節點檢視日誌串流
您可以使用 AWS Explorer 中的 **Lambda** 的節點，檢視 CloudWatch Logs AWS Lambda 函數。
**注意**
您也可以使用 AWS Explorer 中的 **CloudWatch Logs** 節點，檢視所有 AWS 服務的日誌串流，包括 Lambda 函數在內。我們建議使用 **Lambda** 節點，但是只能概觀與 Lambda 函數相關的日誌資料。
1. 開啟 AWS Explorer (如尚未開啟的話)。
1. 按一下 **Lambda** 節點展開 Lambda 函數清單。
[目前 AWS 區域](setup-region.md#setup-region-current-region)的 Lambda 函數會顯示在 **Lambda** 節點底下。
1. 用滑鼠右鍵按一下 Lambda 函數，然後選擇**檢視日誌串流**。
函數的日誌串流會顯示在**日誌串流**窗格中。如需了解如何與每個串流中的日誌事件互動，請參閱 [使用 CloudWatch 日誌事件使用 CloudWatch Logs Insights](working-CloudWatch-log-events.md)。
## 透過 **Amazon ECS** 節點檢視日誌串流
您可以使用 AWS Explorer 中的 ** Amazon ECS** 節點，檢視 CloudWatch Logs 的叢集和容器 (由 Amazon Elastic Container Service 執行和維護)
**注意**
您也可以使用 AWS Explorer 中的 **CloudWatch Logs** 節點，檢視所有 AWS 服務的日誌群組，包括 Amazon ECS 在內。我們建議使用 **Amazon ECS** 節點，但是只能概觀與 Amazon ECS 叢集和容器相關的日誌資料。
1. 開啟 AWS Explorer (如尚未開啟的話)。
1. 按一下 **Amazon ECS** 節點展開 Amazon ECS 叢集清單。
[目前 AWS 區域](setup-region.md#setup-region-current-region)的 Amazon ECS 叢集會顯示在 **Amazon ECS** 節點底下。
1. 用滑鼠右鍵按一下叢集，然後選擇**檢視日誌串流**。
叢集的日誌串流會顯示在**日誌串流**窗格中。
1. 若要檢視特定容器的日誌串流，請按一下叢集展開其已註冊容器的清單。
為該叢集註冊的容器會顯示在下方。
1. 用滑鼠右鍵按一下容器，然後選擇**檢視容器日誌串流**。
容器的日誌串流會顯示在**日誌串流**窗格中。如需了解如何與每個叢集和容器的日誌事件互動，請參閱：[使用 CloudWatch 日誌事件使用 CloudWatch Logs Insights](working-CloudWatch-log-events.md)。
# 透過 AWS Toolkit for JetBrains 使用日誌串流中的 CloudWatch 日誌事件
開啟**日誌串流**視窗後，您可以存取每個串流中的日誌事件。日誌事件是由應用程式或正受到系統監控的資源所記錄的活動記錄。
**Topics**
+ [檢視和篩選串流中的日誌事件](#viewing-log-events)
+ [使用日誌動作](#working-with-log-actions)
+ [將 CloudWatch 日誌事件件匯出至檔案或編輯器](#exporting-CW-logs)
## 檢視和篩選串流中的日誌事件
開啟日誌串流時，**日誌串流**視窗會顯示串流的日誌事件序列。
1. 若要找到要檢視的日誌串流，請開啟**日誌串流**視窗 (請參閱：[檢視 CloudWatch 日誌群組和日誌串流](viewing-CloudWatch-logs.md))。
**注意**
您可以使用模式比對功能來尋找清單中的串流。按一下**日誌串流**窗格並開始輸入文字。包含相符文字的第一個日誌串流名稱會反白顯示。您也可以按一下**最後事件時間**欄頂端來重新排列清單。
1. 按兩下日誌串流以檢視其日誌事件序列。
**日誌事件**窗格會顯示組成日誌串流的日誌事件。
1. 若要根據內容篩選日誌事件，請在**篩選日誌串流**欄位中輸入文字，然後按 **Return**。
結果為包含與篩選文字相符 (區分大小寫) 的日誌事件。篩選器會搜尋完整的日誌串流，包括畫面上未顯示的事件。
**注意**
您也可以使用模式比對功能在窗格中尋找日誌事件。按一下**日誌事件**窗格並開始輸入文字。包含相符文字的第一個日誌事件名稱會反白顯示。與**篩選日誌串流**搜尋不同，只會檢查畫面上顯示的事件。
1. 若要根據時間篩選日誌事件，請用滑鼠右鍵按一下日誌事件，然後選擇**顯示以下時段的日誌:**。
您可以選擇**一分鐘**、**五分鐘**或**十分鐘**。例如，如果您選取**五分鐘**，篩選清單只會顯示在所選項目之前和之後五分鐘發生的日誌事件。
![\[在在日誌事件窗格中檢視和篩選日誌動作。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/cloudwatch-filter-log-events.png)
**日誌事件**窗格左邊的[日誌動作](#working-with-log-actions)提供更多與日誌事件互動的方式。
## 使用日誌動作
在**日誌事件**窗格的左邊有四個日誌動作，可讓您重新整理、編輯、追蹤和封裝 CloudWatch 日誌事件。
![\[在在日誌事件窗格中檢視日誌動作。\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/cloudwatch-log-actions.png)
1. 若要尋找要互動的日誌事件，請[開啟**日誌串流**](#viewing-log-events)窗格。
1. 選擇下列其中一項日誌動作：
+ **重新整理**：更新開啟**日誌事件**窗格之後發生的日誌事件清單。
+ **在編輯器中開啟**：在 IDE 的預設編輯器中開啟螢幕日誌事件。
**注意**
此動作只會將螢幕日誌事件匯出至 IDE 編輯器。若要在編輯器中檢視串流的所有事件，請選擇[**匯出日誌串流**](#exporting-CW-logs)選項。
+ **結尾日誌**：將新日誌事件串流至**日誌事件**窗格。對於持續更新執行時間較長的服務 (例如 Amazon EC2 執行個體和 AWS CodeBuild 組建)，此功能很實用。
+ **封裝日誌**：如果窗格受限於大小而隱藏了較長的項目，則會以多行顯示日誌事件文字。
## 將 CloudWatch 日誌事件件匯出至檔案或編輯器
匯出 CloudWatch 日誌串流可讓您在 IDE 的預設編輯器中開啟其日誌事件，或將事件下載到本機資料夾。
1. 若要尋找要存取的日誌串流，請[開啟**日誌串流**](#viewing-log-events)窗格。
1. 用滑鼠右鍵按一下日誌串流，然後選擇**匯出日誌串流**、**在編輯器中開啟**，或是**匯出日誌串流**、**儲存至檔案**。
+ **在編輯器中開啟**：在此 IDE 的預設編輯器中開啟組成所選串流的日誌事件。
**注意**
此選項會將日誌串流中的所有事件匯出至 IDE 編輯器。
+ **儲存至檔案**：開啟**下載日誌串流**對話方塊。這可讓您選取下載資料夾並重新命名包含日誌事件的檔案。
# 透過 AWS Toolkit for JetBrains 使用 CloudWatch Logs Insights
您可以透過 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 許可
您需要下列許可才能執行和檢視 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
**開啟 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**查詢結果**視窗的右上角選擇**開啟查詢編輯器**。
**檢視個別日誌記錄**
+ 在查詢結果窗格中，按兩下一列以開啟包含目標日誌記錄詳細資料的新索引標籤。
您也可以選擇右上角**檢視日誌串流**，瀏覽至日誌記錄的相關日誌串流。