本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Visual Studio 中的 CloudWatch 日志
<a name="cloudwatch-log-overview"></a>

Amazon CloudWatch Logs 集成允许您使用 Amazon Q 监控、存储和访问 CloudWatch 来自 Visual Studio 的 AWS Toolkit for Visual Studio 中的 CloudWatch 日志。无需离开 IDE 即可访问日志功能，从而简化 CloudWatch 日志开发过程并减少对工作流程的干扰，从而提高效率。以下主题介绍如何使用 Lo CloudWatch gs 集成的基本特性和功能。

**Topics**
+ [CloudWatch 日志组](#cloudwatch-log-overview-groups)
+ [CloudWatch 日志流](#cloudwatch-log-overview-logstream)
+ [CloudWatch 记录事件](#cloudwatch-log-overview-logevents)
+ [对 CloudWatch 日志的额外访问权限](#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日志组列表。

要访问查看日志组功能并打开 CloudWatch 日志组资源管理器，请完成以下步骤。

1. 在 AWS 资源管理器中，展开 **Amazon CloudWatch**。

1. 双击 “**日志组**” 或打开快捷菜单（右键单击），然后选择 “**查看**”，打开 “**CloudWatch 日志组浏览器**”。
**注意**  
 CloudWatch 日志组资源管理器将在与解决方案资源管理器相同的窗口位置打开。

### 筛选日志组
<a name="cloudwatch-log-overview-groups-filter"></a>

您的个人账户可以包含成千上万个不同的日志组。要简化对特定组的搜索，请使用下述 `filtering` 功能。

1. 在**CloudWatch 日志组资源管理器**中，将光标置于窗口顶部的搜索栏中。

1. 开始键入与要查找的日志组相关的前缀。

1. **CloudWatch 日志组资源管理器**会自动更新，以显示与您在上一步中指定的搜索词匹配的结果。

### 删除日志组
<a name="cloudwatch-log-overview-groups-delete"></a>

要删除特定日志组，请参阅以下步骤。

1. 在**CloudWatch 日志组资源管理器**中，右键单击要删除的日志组。

1. 在提示时，确认您希望删除当前选中的日志组。

1. 选择 “**是**” 按钮会删除选定的日志组，然后刷新 “**CloudWatch 日志组浏览器”**。

### 刷新日志组
<a name="cloudwatch-log-overview-groups-refresh"></a>

要刷新 “日志组**资源管理器” 中显示的当前CloudWatch 日志组**列表，请选择**工具栏**上的 “**刷新” 图标**按钮。

### 复制日志组 ARN
<a name="cloudwatch-log-overview-groups-copyarn"></a>

要复制特定日志组的 ARN，请完成以下步骤。

1. 在**CloudWatch 日志组资源管理器**中，右键单击要从中复制 ARN 的日志组。

1. 从菜单中选择**复制 ARN** 选项。

1. 现在，ARN 已复制到本地剪贴板并可以粘贴了。

## CloudWatch 日志流
<a name="cloudwatch-log-overview-logstream"></a>

日志流是共享同一来源的一系列日志事件。

**注意**  
查看日志流时，请注意以下属性：  
默认情况下，日志流按事件时间戳由近及远排序。
通过切换列标题中的**尖角**符号，可以按升序或降序对与日志流关联的列进行排序。
经过筛选的条目只能按**日志流名称**排序。

### 查看日志流
<a name="cloudwatch-log-overview-logstream-view"></a>

1. 在**CloudWatch 日志组资源管理器**中，双击日志组，或者右键单击日志组，然后从快捷菜单中选择**查看日志流**。

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 记录事件
<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 日志的额外访问权限
<a name="cloudwatch-log-overview-additional"></a>

您可以直接从 Visual Studio 中的 AWS 工具包访问与其他 AWS 服务和资源关联的 CloudWatch 日志。

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

要查看与 Lambda 函数关联的日志流，请执行以下操作：

**注意**  
您的 Lambda 执行角色必须具有相应的权限才能将日志发送到日志。 CloudWatch有关 CloudWatch 日志所需的 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 工具包资源管理器中，展开 **Lambda**。

1. 右键单击要查看的函数，然后选择**查看日志**，以在**文档**窗口中打开关联的日志流。

要使用 Lambda 集成 `function view` 查看日志流，请执行以下操作：

1. 在 AWS 工具包资源管理器中，展开 **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 工具包资源管理器中，展开 **Amazon ECS**。

1. 选择要查看的 Amazon ECS 集群，以在**文档**窗口中打开新的 **ECS 集群**选项卡。

1. 在 **ECS 集群**选项卡左侧的导航菜单中，选择**任务**以列出与该集群关联的所有任务。

1. 在**任务**显示屏中，选择任务并选择位于左下角的**查看日志**链接。
**注意**  
此显示列出了集群中包含的所有任务，但只有符合所需日志配置的任务显示 `View Logs` 链接。  
如果任务仅与单个容器关联，则**查看日志**链接会打开该容器的日志流。
如果一个任务与多个容器关联，则**查看日志**链接会打开**查看 ECS 任务的 CloudWatch 日志**对话框，使用**容器:**下拉菜单选择要查看其日志的容器，然后选择**确定**。

1. 将在**文档**窗口中打开一个新选项卡，显示与您的容器选择相关的日志流。