Amazon CloudWatch Logs
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

使用日志组和日志流

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

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

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

在 CloudWatch Logs 中创建日志组

当您使用 Amazon CloudWatch Logs User Guide前面章节中的步骤在 Amazon EC2 实例上安装 CloudWatch Logs 代理时,日志组将作为该过程的一部分创建。您还可以直接在 CloudWatch 控制台中创建日志组。

创建日志组

  1. 通过以下网址打开 CloudWatch 控制台:https://console.amazonaws.cn/cloudwatch/

  2. 在导航窗格中,选择 Logs

  3. 选择 ActionsCreate log group

  4. 键入日志组的名称,然后选择创建日志组

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

您可以查看和滚动浏览 CloudWatch Logs 代理发送到 CloudWatch Logs 的每一个日志流的日志数据。您可以指定要查看的日志数据的时间范围。

查看日志数据

  1. 通过以下网址打开 CloudWatch 控制台:https://console.amazonaws.cn/cloudwatch/

  2. 在导航窗格中,选择 Logs

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

  4. 对于 Log Streams,选择日志流名称以查看日志数据。

  5. 要更改日志数据的显示方式,请执行下列操作之一:

    • 要展开所有日志事件,请在日志事件列表上方选择 Expand all

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

    • 要筛选日志事件,请在搜索字段中键入所需的搜索筛选器。有关更多信息,请参阅 搜索和筛选日志数据

    • 要查看指定日期和时间范围的日志数据,请在日志事件列表上方选择 custom。您可以选择 Absolute 以指定日期和时间范围,也可以选择 Relative 以选择预定义的分钟数、小时数、天数或周数。还可以在 UTCLocal timezone 之间切换。

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

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

更改日志保留期设置

  1. 通过以下网址打开 CloudWatch 控制台:https://console.amazonaws.cn/cloudwatch/

  2. 在导航窗格中,选择 Logs

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

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

  5. Edit Retention 对话框中,为 Retention 选择日志保留期值,然后选择 Ok

标记 Amazon CloudWatch Logs 中的日志组

您可以使用标签的形式,将自己的元数据分配到您在 Amazon CloudWatch Logs 中创建的日志组。标签是您为日志组定义的键值对。使用标签是管理 AWS 资源和组织数据 (包括账单数据) 的一种简单却强有力的方式。

有关标签的基本知识

可使用 AWS CLI 或 CloudWatch Logs API 完成以下任务:

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

  • 向现有日志组添加标签

  • 列出日志组的标签

  • 删除日志组的标签

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

  • 项目:项目名称

  • 所有者:名称

  • 用途:负载测试

  • 应用程序:应用程序名称

  • 环境:生产

使用标签跟踪成本

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

标签限制

以下限制适用于标签。

基本限制

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

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

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

标签键限制

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

  • 标签键不能以 aws: 开头,因为此前缀将预留以供 AWS 使用。AWS 将代表您创建以此前缀开头的标签,但您不能编辑或删除这些标签。

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

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

标签值限制

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

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

使用 AWS CLI 标记日志组

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

create-log-group

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

tag-log-group

为指定的日志组添加或更新标签。

list-tags-log-group

列出指定日志组的标签。

untag-log-group

删除指定日志组的标签。

使用 CloudWatch Logs API 标记日志组

您可以使用 CloudWatch Logs API 添加、列出和删除标签。有关示例,请参阅以下文档:

CreateLogGroup

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

TagLogGroup

为指定的日志组添加或更新标签。

ListTagsLogGroup

列出指定日志组的标签。

UntagLogGroup

删除指定日志组的标签。