本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Visual Studio 的 Amazon CloudWatch Logs 整合
<a name="cloudwatch-log"></a>

來自 AWS Toolkit for Visual Studio 與 Amazon Q 的 Amazon CloudWatch Logs 整合可讓您監控、存放和存取 CloudWatch Logs 資源，而不必離開 IDE。若要進一步了解如何設定 CloudWatch 服務以及如何使用 CloudWatch Logs 功能，請從下列主題中選擇。

**Topics**
+ [設定 CloudWatch Logs](cloudwatch-log-setup.md)
+ [使用 CloudWatch Logs](cloudwatch-log-overview.md)

# 設定 Visual Studio 的 CloudWatch Logs 整合
<a name="cloudwatch-log-setup"></a>

您需要有 AWS 帳戶，才能使用 Amazon CloudWatch Logs 與 AWS Toolkit with Amazon Q 整合。您可以從[AWS 登入](https://console.aws.amazon.com/console/home)網站建立新 AWS 帳戶。大多數可從 AWS Toolkit with Amazon Q 取得的 CloudWatch Logs 功能都可以使用作用中的 AWS 登入資料存取。如果特定功能需要額外的組態，這些要求會包含在[使用 CloudWatch Logs](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/cloudwatch-log-overview.html) 指南的相關區段中。

如需設定 CloudWatch Logs 的其他資訊和選項，請參閱《Amazon CloudWatch Logs 指南》中的[開始設定](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/GettingSetup_cwl.html)一節。

# 在 Visual Studio 中使用 CloudWatch Logs
<a name="cloudwatch-log-overview"></a>

Amazon CloudWatch Logs 整合可讓您透過 Toolkit for Visual Studio 搭配 Amazon Q 監控、存放和存取 CloudWatch Logs。無需離開 IDE 即可存取 CloudWatch Logs 功能，透過簡化 CloudWatch Logs 開發程序並減少對工作流程的中斷來提高效率。 AWS 下列主題說明如何使用 CloudWatch Logs 整合的基本功能。

**Topics**
+ [CloudWatch 日誌群組](#cloudwatch-log-overview-groups)
+ [CloudWatch Log Streams](#cloudwatch-log-overview-logstream)
+ [CloudWatch Log Events](#cloudwatch-log-overview-logevents)
+ [對 CloudWatch Logs 的其他存取](#cloudwatch-log-overview-additional)

## CloudWatch 日誌群組
<a name="cloudwatch-log-overview-groups"></a>

`log group` 是`log streams`共用相同保留、監控和存取控制設定的 群組。可以屬於一個日誌群組的日誌串流數量並沒有限制。

### 檢視日誌群組
<a name="cloudwatch-log-overview-groups-view"></a>

`View Log Groups` 此功能會顯示 CloudWatch Log Groups Explorer 中的日誌群組清單。

若要存取檢視日誌群組功能並開啟 CloudWatch Log Groups Explorer，請完成下列步驟。

1. 從 AWS Explorer 展開 **Amazon CloudWatch**。

1. 按兩下**日誌群組**或開啟內容功能表 （按一下滑鼠右鍵），然後選取**檢視**，以開啟 **CloudWatch Log Groups Explorer**。
**注意**  
CloudWatch Log Groups Explorer 會在與 Solutions Explorer 相同的視窗位置開啟。

### 篩選日誌群組
<a name="cloudwatch-log-overview-groups-filter"></a>

您的個別帳戶可以包含數千個不同的日誌群組。若要簡化特定群組的搜尋，請使用下列`filtering`功能。

1. 從 **CloudWatch Log Groups Explorer**，在視窗頂端的搜尋列中設定游標。

1. 開始輸入與您要尋找的日誌群組相關的字首。

1. **CloudWatch Log Groups Explorer** 會自動更新，以顯示符合您在上一個步驟中指定的搜尋詞彙的結果。

### 刪除日誌群組
<a name="cloudwatch-log-overview-groups-delete"></a>

若要刪除特定日誌群組，請參閱下列程序。

1. 從 **CloudWatch Log Groups Explorer**，在要刪除的日誌群組上按一下滑鼠右鍵。

1. 出現提示時，請確認您想要刪除目前選取的日誌群組。

1. 選擇**是**按鈕會刪除選取的日誌群組，然後重新整理 **CloudWatch Log Groups Explorer**。

### 重新整理日誌群組
<a name="cloudwatch-log-overview-groups-refresh"></a>

若要重新整理 **CloudWatch Log Groups Explorer 中顯示的目前日誌群組**清單，請選擇工具列中的**重新整理圖示**按鈕****。

### 複製日誌群組 ARN
<a name="cloudwatch-log-overview-groups-copyarn"></a>

若要複製特定日誌群組的 ARN，請完成下列步驟。

1. 從 **CloudWatch Log Groups Explorer**，在您要從中複製 ARN 的日誌群組上按一下滑鼠右鍵。

1. 從功能表中選擇**複製 ARN** 選項。

1. ARN 現在會複製到本機剪貼簿並準備好貼上。

## CloudWatch Log Streams
<a name="cloudwatch-log-overview-logstream"></a>

日誌串流是共享相同來源的一系列日誌事件。

**注意**  
檢視日誌串流時，請注意下列屬性：  
根據預設，日誌串流會依最新的事件時間戳記排序。
與日誌串流相關聯的資料欄可以依遞增或遞減順序排序，方法是切換位於資料欄標頭中的**插入。**
篩選的項目只能依**日誌串流名稱**排序。

### 檢視日誌串流
<a name="cloudwatch-log-overview-logstream-view"></a>

1. 從 **CloudWatch Log Groups Explorer** 按兩下日誌群組，或在日誌群組上按一下滑鼠右鍵，然後從內容功能表中選取**檢視日誌串流**。

1. 新的索引標籤會在**文件**視窗中開啟，其中包含與您的日誌群組相關聯的日誌串流清單。

### 篩選日誌串流
<a name="cloudwatch-log-overview-logstream-filter"></a>

1. 從**日誌串流**索引標籤**的文件**視窗中，在搜尋列中設定游標。

1. 開始輸入與您要尋找的日誌串流相關的字首。

1. 當您輸入 時，目前的顯示會自動更新，以依您的輸入篩選日誌串流。

### 重新整理日誌串流
<a name="cloudwatch-log-overview-logstream-refresh"></a>

若要重新整理**文件**視窗中顯示的目前日誌串流清單，請選擇**搜尋列**旁邊的**工具列**中的**重新整理圖示**按鈕。

### 複製日誌串流 ARN
<a name="cloudwatch-log-overview-logstream-copyarn"></a>

若要複製特定日誌串流的 ARN，請完成下列步驟。

1. 從**日誌串流**索引標籤**的文件**視窗中，在您要從中複製 ARN 的日誌串流上按一下滑鼠右鍵。

1. 從功能表中選擇**複製 ARN** 選項。

1. ARN 現在會複製到本機剪貼簿並準備好貼上。

### 下載日誌串流
<a name="cloudwatch-log-overview-logstream-delete"></a>

**匯出日誌串流**功能會在本機下載和存放選取的日誌串流，以供自訂工具和軟體存取以進行其他處理。

1. 從**日誌串流**索引標籤**的文件**視窗中，在您要下載的日誌串流上按一下滑鼠右鍵。

1. 選擇**匯出日誌串流**以開啟**匯出至文字檔案**對話方塊。

1. 選擇您要在本機存放檔案的位置，並在提供的文字欄位中指定名稱。

1. 選取**確定**以確認下載。下載的狀態會顯示在 **Visual Studio 任務狀態中心**

## CloudWatch Log Events
<a name="cloudwatch-log-overview-logevents"></a>

日誌事件是由 CloudWatch 監控的應用程式或資源記錄的活動記錄。

### 記錄事件動作
<a name="cloudwatch-log-overview-logevents-actions"></a>

日誌事件會顯示為資料表。根據預設，事件會從最舊的事件排序為最新的事件。

下列動作與 Visual Studio 中的日誌事件相關聯：
+ 包裝文字模式：您可以按一下事件來切換包裝文字。
+ 文字包裝按鈕：位於 中`document window toolbar`，此按鈕會切換所有項目的文字包裝開啟和關閉。
+ 將訊息複製到剪貼簿：選取您要複製的訊息，然後在選取項目上按一下滑鼠右鍵，然後選擇**複製** （鍵盤快速鍵 `Ctrl + C`)。

### 檢視日誌事件
<a name="cloudwatch-log-overview-logevents-view"></a>

1. 從**文件**視窗中，選擇包含日誌串流清單的標籤。

1. 按兩下日誌串流，或在日誌串流上按一下滑鼠右鍵，然後從功能表中選取**檢視日誌串流**。

1. 新的**日誌事件**索引標籤會在**文件**視窗中開啟，其中包含與所選日誌串流相關聯的日誌事件資料表。

### 篩選日誌事件
<a name="cloudwatch-log-overview-logevents-filter"></a>

您可以透過三種方式篩選日誌事件：依內容、時間範圍或兩者。若要依內容和時間範圍篩選日誌事件，請先依內容或時間範圍篩選您的訊息，然後依其他方法篩選這些結果。

若要依內容篩選日誌事件：

1. 從**日誌事件**索引標籤的文件****視窗中，在視窗頂端的搜尋列中設定游標。

1. 開始輸入與您正在搜尋的日誌事件相關的詞彙或片語。

1. 當您輸入 時，目前的顯示會自動開始篩選您的日誌事件。
**注意**  
篩選條件模式區分大小寫。您可以用雙引號 (\$1""\$1) 括住具有非英數字元的確切詞彙和片語，以改善搜尋結果。如需篩選模式的詳細資訊，請參閱《Amazon CloudWatch 指南》中的[篩選和模式語法](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html)主題。

若要檢視在特定時間範圍內產生的日誌事件：

1. 從**日誌事件**索引標籤**的文件**視窗中，選擇工具列中的**行事曆圖示**按鈕****。

1. 使用提供的欄位，指定您要搜尋的時間範圍。

1. 當您指定日期和時間限制時，篩選的結果會自動更新。
**注意**  
**清除篩選條件**選項會清除目前所有的date-and-time篩選條件選擇。

### 重新整理日誌事件
<a name="cloudwatch-log-overview-logevents-refresh"></a>

若要重新整理日誌事件索引標籤中顯示的目前**日誌事件**清單，請選擇工具列中的**重新整理圖示**按鈕****。

## 對 CloudWatch Logs 的其他存取
<a name="cloudwatch-log-overview-additional"></a>

您可以直接從 Visual Studio 中的 AWS Toolkit 存取與其他 AWS 服務和資源相關聯的 CloudWatch Logs。

### Lambda
<a name="cloudwatch-log-overview-additional-lambda"></a>

若要檢視與 Lambda 函數相關聯的日誌串流：

**注意**  
您的 Lambda 執行角色必須具有適當的許可，才能將日誌傳送至 CloudWatch Logs。如需 CloudWatch Logs 所需 Lambda 許可的詳細資訊，請參閱 [https://docs.aws.amazon.com/lambda/latest/dg/monitoring-cloudwatchlogs.html#monitoring-cloudwatchlogs-prereqs](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-cloudwatchlogs.html#monitoring-cloudwatchlogs-prereqs)

1. 從 AWS Toolkit Explorer 中，展開 **Lambda**。

1. 在您要檢視的函數上按一下滑鼠右鍵，然後選擇**檢視日誌**以在**文件**視窗中開啟相關聯的日誌串流。

若要使用 Lambda 整合 檢視日誌串流`function view`：

1. 從 AWS Toolkit Explorer 中，展開 **Lambda**。

1. 在您要檢視的函數上按一下滑鼠右鍵，然後選擇**檢視函數**以在**文件**視窗中開啟函數檢視。

1. 從 `function view`切換到**日誌**索引標籤，隨即顯示與所選 Lambda 函數相關聯的日誌串流。

### ECS
<a name="cloudwatch-log-overview-additional-ecs"></a>

若要檢視與 ECS 任務容器相關聯的日誌資源，請完成下列程序。

**注意**  
為了讓 Amazon ECS 服務將日誌傳送至 CloudWatch，特定 Amazon ECS 任務的每個容器必須符合必要的組態。如需所需設定和組態的詳細資訊，請參閱[使用 AWS 日誌日誌驅動程式](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html)指南。

1. 從 AWS Toolkit Explorer 中，展開 **Amazon ECS**。

1. 選擇您要檢視的 Amazon ECS 叢集，以在**文件**視窗中開啟新的 **ECS 叢集**索引標籤。

1. 從位於 **ECS 叢集**標籤左側的導覽選單中，選擇**任務**以列出與叢集相關聯的所有任務。

1. 從**任務**顯示中，選取任務，然後選擇位於左下角**的檢視日誌**連結。
**注意**  
此顯示會列出叢集中包含的所有任務，只有符合所需日誌組態的每個任務才會顯示`View Logs`連結。  
如果任務僅與單一容器相關聯，則**檢視日誌**連結會開啟該容器的日誌串流。
如果任務與多個容器相關聯，**檢視日誌**連結會開啟**檢視 ECS 任務的 CloudWatch Logs** 對話方塊，使用**容器：**下拉式功能表選擇您要檢視日誌的容器，然後選擇**確定**。

1. 新的索引標籤會在**文件**視窗中開啟，顯示與您容器選擇相關聯的日誌串流。