View a markdown version of this page

使用 facet 对日志进行分组和浏览 - 亚马逊 CloudWatch 日志
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用 facet 对日志进行分组和浏览

Facet 对于分析日志很有用,因为它们允许您在不运行查询的情况下以交互方式筛选和分组数据。分面是您的日志中的一个字段(例如 ServiceName 要么 StatusCode),支持跨日志组的过滤、聚合和分析。您可以在中查看多面场的列表 CloudWatch Logs Insights 控制台,以及基于您选择的时间范围的每个方面值的日志事件数。当您选择不同的刻面和值时,分面值和计数会实时更新,使您能够交互式浏览日志。

每个方面都显示根据所选时间范围和查询范围自动从日志字段中提取的可用值和计数,并保留 30 天。显示的刻面数是近似值。您可以使用默认方面,例如数据源名称或数据源类型来浏览日志,或者在日志中的任何字段上创建自定义分面。数据源名称是生成日志的 AWS 服务或应用程序(例如,Route 53、Amazon VPC 或 CloudTrail)和数据源类型是该服务生成的特定类型的日志。默认刻面由创建 CloudWatch 并包括 @aws.region, @data_source_name, @data_source_type,以及 @data_format。有关更多信息,请参阅 日志管理。Facet 仅适用于在账户中提取的日志。如果您设置了跨账户可观察性,则监控账户无法根据源账户的日志查看各个方面。

如果你有 遥测的资源标签 已启用,资源标签字段 (@aws.tag.*) 会自动添加为默认构面。这些方面使您能够按生成日志事件的资源的标签对日志事件进行筛选和分组。

要创建其他方面,请在日志中选择与故障排除相关的字段,并使用索引策略对其进行配置。对于自定义方面,我们建议在低基数字段(每天唯一值少于 100 个的字段,例如状态和 ApplicationName)。每天具有超过 100 个唯一值的刻面被归类为高基数,并且不显示这些刻面的值。选择一个或多个方面,然后选择对日志运行查询。

要开始使用 facets CloudWatch 日志见解:

  1. 打开 CloudWatch 控制台在 https://console.aws.amazon.com/cloudwatch/。

  2. 在导航窗格中,依次选择日志、Logs Insights。

  3. (可选)使用时间范围选择器选择要分析的时间段。在所选时间范围内,面板中会显示可用的刻面和值。

  4. 选择方面来浏览您的数据并查看各个方面的价值分布的实时更新。

    不显示具有超过 100 个唯一值的分面。要查询特定值,请在查询中改用筛选器。

运行基于分面的查询

  1. 跨多面选择一个或多个值。

  2. 事件计数将根据所选的方面和值进行更新。

  3. 选择分面值后,查询范围将更新以反映所选内容。

  4. 选择 facets 值后,选择 “运行” 以执行您的查询。

  5. 每个方面支持的最大唯一值数为 100。例如,如果一个刻面的值超过 100 个,则所有计数都显示为 “-”,这表示值未知。

保存基于分面的查询

  1. 使用一个或多个 facet 值创建查询。

  2. 其余步骤与保存日志见解查询相同。参见 正在保存 CloudWatch 日志见解查询。

  3. 您保存的查询可在 “已保存的查询” 部分找到。当您检索已保存的查询时,它将自动包含用于查询的方面和值,从而可以轻松分析日志。

创建账户级别的分面

  1. 要创建构面,您需要先将字段创建为索引并将其配置为分面。在导航窗格中,选择 设置, 日志, 账户级别指数政策。或者,你可以选择 管理方面 在刻面面板上。

  2. 选择 创建新的索引策略。有关创建索引策略的详细信息,请参阅 创建账户级字段索引策略。

  3. 要创建构面,请选中 设置为刻面 用于索引策略创建页面中的选定字段。

使用 API 进行分面管理

可以使用字段索引策略来完成分面管理。参见 field index 有关详细信息的 API。

字段索引 API
否。 Name 说明
1 PutIndexPolicy 为特定日志组创建或更新字段索引策略
2 PutAccountPolicy 创建适用于账户中所有日志组或日志组子集的账户级数据保护策略、订阅筛选策略、字段索引策略、转换器策略、指标提取策略或保留策略
3 DeleteIndexPolicy 删除应用于单个日志组的日志组级别字段索引策略
4 DeleteAccountPolicy 删除 CloudWatch 日志账户政策