使用日志组和日志流 - Amazon CloudWatch 日志
创建日志组将日志发送到日志组查看日志数据更改日志数据保留期标记日志组
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用日志组和日志流

日志流是共享同一来源的一系列日志事件。Logs 中每个单独的 CloudWatch 日志源构成一个单独的日志流。

日志组是一组具有相同保留期、监控和访问控制设置的日志流。您可以定义日志组并指定向各组中放入哪些流。对可属于一个日志组的日志流数没有限制。

使用本部分中的过程处理日志组和日志流。

在 Log CloudWatch s 中创建日志组

当您按照《Amazon CloudWatch 日志用户指南》前几节中的步骤在 Amazon CloudWatch EC2 实例上安装日志代理时，将在该过程中创建日志组。您也可以直接在 CloudWatch 控制台中创建日志组。

创建日志组

  1. 打开 CloudWatch 控制台，网址为 https://console.aws.amazon.com/cloudwatch/。

  2. 在导航窗格中，选择日志组。

  3. 选择操作，然后选择创建日志组。

  4. 输入日志组的名称，然后选择创建日志组。

提示

您可以通过导航窗格中的 Favorites and recents（收藏夹和最近记录）菜单收藏日志组以及控制面板和警报。在 Recently visited（最近访问）列中，将鼠标悬停在您想要收藏的日志组上，然后选择旁边的星形符号。

将日志发送到日志组

CloudWatch 日志会自动接收来自多个 Amazon 服务的日志事件。您也可以使用以下方法之一将其他 CloudWatch 日志事件发送到 Logs：

查看发送到日志的 CloudWatch 日志数据

您可以 stream-by-stream 根据日志代理发送到 Logs 的日志数据来 CloudWatch 查看和滚动浏览 CloudWatch 日志数据。您可以指定要查看的日志数据的时间范围。

查看日志数据

  1. 打开 CloudWatch 控制台，网址为 https://console.aws.amazon.com/cloudwatch/。

  2. 在导航窗格中，选择 日志组。

  3. 对于 Log Groups（日志组），选择日志组以查看日志流。

  4. 在日志组列表中，选择要查看的日志组的名称。

  5. 从日志流列表中，选择要查看的日志流的名称。

  6. 要更改日志数据的显示方式，请执行下列操作之一：

    • 要展开单个日志事件，请选择该日志事件旁边的箭头。

    • 要展开所有日志事件并以纯文本形式查看它们，请在日志事件列表上方选择 Text。

    • 要筛选日志事件，请在搜索字段中键入所需的搜索筛选条件。有关更多信息，请参阅使用筛选条件从日志事件创建指标。

    • 要查看指定日期和时间范围的日志数据，请在搜索筛选条件旁边，选择日期和时间旁的箭头。要指定日期和时间范围，请选择 Absolute（绝对）。要选择预定义的分钟数、小时数、天数或周数，请选择 Relative（相对）。还可以在 UTC 和本地时区之间切换。

更改日志中的 CloudWatch 日志数据保留期

默认情况下，日志数据无限期地存储在 CloudWatch 日志中。但是，您可以配置要在日志组中存储日志数据多长时间。存储时间超过当前保留期设置的所有数据将被删除。您可以随时更改每个日志组的日志保留期。

注意

CloudWatch Logs 不会在日志事件达到保留设置时立即将其删除。此后通常需要 72 小时才能删除日志事件，但在极少数情况下可能需要更长时间。

这意味着，如果将日志组更改为具有更长的保留期设置，而该日志组包含已过期但实际上尚未删除的日志事件，则在达到新保留日期后，这些日志事件最多需要 72 小时才能被删除。要确保永久删除日志数据，请将日志组保留在较低的保留期设置，直到上一个保留期结束后 72 小时过去，或者您确认已删除较早的日志事件。

当日志事件达到其保留设置时，这些日志事件将被标记为待删除。在被标记为待删除后，即使它们要等到以后才真正被删除，也不会再增加您的档案存储成本。当您使用 API 检索 storedBytes 值以查看日志组存储了多少字节时，这些标记为待删除的日志事件也不包括在内。

更改日志保留期设置

  1. 打开 CloudWatch 控制台，网址为 https://console.aws.amazon.com/cloudwatch/。

  2. 在导航窗格中，选择 日志组。

  3. 找到要更新的日志组。

  4. 在该日志组的 Expire Events After 列中，选择当前保留期设置，例如 Never Expire。

  5. 在 Edit Retention（编辑保留期）中，为 Retention（保留期）选择日志保留期值，然后选择 Ok（确定）。

在 Amazon 日志中标记 CloudWatch 日志组

您可以将自己的元数据以标签的形式分配给您在 Amazon Logs 中创建的 CloudWatch 日志组。标签是您为日志组定义的键值对。使用标签是一种管理 Amazon 资源和整理数据（包括账单数据）的简单而强大的方法。

注意

您可以使用标签来控制对 CloudWatch 日志资源的访问权限，包括日志组和目标。由于日志组和日志流之间存在分层关系，因此在日志组级别控制对日志流的访问。有关使用标签控制访问的更多信息，请参阅使用标签控制对 Amazon Web Services 资源的访问。

有关标签的基本知识

您可以使用或 Amazon CloudFormation Amazon CLI日 CloudWatch 志 API 来完成以下任务：

  • 在创建日志组时向其添加标签。

  • 向现有日志组添加标签。

  • 列出日志组的标签。

  • 从日志组删除标签。

您可以使用标签对日志组进行分类。例如，您可以按用途、所有者或环境对它们进行分类。由于您定义每个标签的键和值，因此您可以创建一组自定义类别来满足您的特定需求。例如，您可以定义一组标签来帮助您按所有者和关联应用程序跟踪日志组。以下几个标签示例：

  • 项目：项目名称

  • 所有者：名称

  • 用途：负载测试

  • 应用程序：应用程序名称

  • 环境：生产

使用标签跟踪成本

您可以使用标签对 Amazon 费用进行分类和跟踪。当您将标签应用于 Amazon 资源（包括日志组）时，您的 Amazon 成本分配报告包括按标签汇总的使用量和成本。您可以设置代表业务类别（例如成本中心、应用程序名称或所有者）的标签，以便整理多种服务的成本。有关更多信息，请参阅 Amazon Billing 用户指南中的对自定义账单报告使用成本分配标签。

标签限制

以下限制适用于标签。

基本限制

  • 每个日志组的最大标签数为 50。

  • 标签键和值区分大小写。

  • 无法更改或编辑已删除日志组的标签。

标签键限制

  • 每个标签键必须是唯一的。如果您添加的标签具有已使用的键，则您的新标签将覆盖现有键值对。

  • 标签密钥不能以开头，aws:因为此前缀已保留供使用 Amazon。 Amazon 代表您创建以此前缀开头的标签，但您无法对其进行编辑或删除。

  • 标签键的长度必须介于 1 和 128 个 Unicode 字符之间。

  • 标签键必须包含以下字符：Unicode 字母、数字、空格和以下特殊字符：_ . / = + - @。

标签值限制

  • 标签值的长度必须介于 0 和 255 个 Unicode 字符之间。

  • 标签值可以为空。另外，它们必须包含以下字符：Unicode 字母、数字、空格和以下任意特殊字符：_ . / = + - @。

使用标记日志组 Amazon CLI

您可以使用 Amazon CLI添加、列出和删除标签。有关示例，请参阅以下文档：

create-log-group

创建日志组。您可以选择在创建日志组时添加标签。

tag-resource

为指定 CloudWatch 的 Logs 资源分配一个或多个标签（键值对）。

list-tags-for-resource

显示与 CloudWatch 日志资源关联的标签。

untag-resource

从指定的 L CloudWatch ogs 资源中移除一个或多个标签。

使用日志 API 标记 CloudWatch 日志组

您可以使用 CloudWatch 日志 API 添加、列出和移除标签。有关示例，请参阅以下文档：

CreateLogGroup

创建日志组。您可以选择在创建日志组时添加标签。

TagResource

为指定 CloudWatch 的 Logs 资源分配一个或多个标签（键值对）。

ListTagsForResource

显示与 CloudWatch 日志资源关联的标签。

UntagResource

从指定的 L CloudWatch ogs 资源中移除一个或多个标签。