Amazon CloudWatch Logs
用户指南
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

标记 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

删除指定日志组的标签。