本页面从概念上简要介绍了基于日志的指标。
基于日志的指标基于日志条目的内容。例如,这类指标可以记录包含特定消息的日志条目的数量,也可以提取日志条目中报告的延迟信息。您可以在 Cloud Monitoring 图表和提醒政策中使用基于日志的指标。
基于日志的指标有两种类型:
系统定义的基于日志的指标,由 Cloud Logging 提供,可供所有 Google Cloud 项目使用。
系统定义的基于日志的指标仅根据 Logging 提取的日志进行计算。如果某日志已明确排除在 Logging 提取之外,则它不包含在这些指标中。
用户定义的基于日志的指标,由用户创建,旨在跟踪 Google Cloud 项目中您感兴趣的特定内容。例如,您可以创建基于日志的指标来计算与给定过滤条件匹配的日志条目的数量。
用户定义的基于日志的指标是根据 Logging API 接收的 Cloud 项目日志计算得出的,不考虑可能应用于 Cloud 项目的任何包含过滤器或排除过滤器。
基于日志的指标仅适用于单个 Google Cloud 项目。不能为 Logging 存储桶或其他 Google Cloud 资源(例如 Cloud Billing 帐号或组织)创建这些资源。
准备工作
如需使用基于日志的指标,您必须有启用了结算功能的 Cloud 项目:
-
在 Google Cloud Console 中,转到项目选择器页面。
-
要开始创建 Google Cloud 项目,请点击创建项目。
-
为您的项目命名。记下生成的项目 ID。
-
根据需要修改其他字段。
-
如需创建项目,请点击创建。
确保您的 Cloud 项目已启用结算功能。了解如何检查项目是否已启用结算功能。
如需验证您是否拥有适当的权限来对 Cloud 项目使用基于日志的指标,请参阅使用 IAM 进行访问权限控制:基于日志的指标。
查看基于日志的指标
借助 Google Cloud Console 中的基于日志的指标页面,您可以创建基于日志的指标,其中包含 Cloud 项目的所有基于日志的指标的列表。
如需查看 Google Cloud 项目的基于日志的指标列表,请执行以下操作:
转到控制台中的基于日志的指标页面:
选择现有的 Cloud 项目。此时会显示 Cloud 项目中基于日志的指标列表。
基于日志的指标界面分为两个指标类型窗格:系统指标和用户定义的指标。
每个窗格都包含一个指标表摘要。每个指标的行都有一个菜单 more_vert,其中具有以下选项:
在 Metrics Explorer 中查看:借助此选项,您可以打开 Cloud Monitoring Metrics Explorer,以查看基于系统日志的指标的数据。
您可以使用 Metrics Explorer 为提醒政策指定目标指标。目标地区旁的图表可向您直观地反馈相应目标指标所采集到的数据。
根据指标创建提醒:借助此选项,您可以根据基于日志的指标创建提醒政策。
选择此选项将打开 Cloud Monitoring 控制台,您可以在其中创建、修改和管理提醒政策。如需详细了解如何为基于日志的指标创建提醒政策,请参阅创建提醒政策。
用户定义的指标窗格
基于日志的指标界面的用户定义的指标窗格有几个功能,可帮助您管理 Cloud 项目中用户定义的指标:
“用户定义的指标”表包括名称、说明、类型和过滤条件列。这些内容在您创建指标时指定。
借助过滤用户定义的指标窗格,您可以通过文本搜索或指标名称、说明和过滤条件来过滤您的指标列表:
“用户定义的指标”表包括上月使用量列和月初至今的用量 (MTD) 列。例如,如果您想药确定哪些指标提取了最多的数据量或是想要估算帐单,这种使用情况数据会非常实用。
点击任意列名称可按升序或降序对数据进行排序。
在您的用户定义的指标窗格中,每个指标的菜单 more_vert 都包含用于管理指标的附加功能:
- 查看指标详情:显示指标的名称、类型、描述、过滤条件、单位和标签。
- 修改指标:允许您修改该指标的某些字段。
- 停用指标:允许您停止计算该指标。您可以通过同一菜单中重新启用已停用的指标。
- 删除指标:允许您删除指标。
- 查看指标的日志:将您转到日志浏览器,并在查询构建器中填充该指标的过滤条件,然后运行查询。
基于日志的指标类型概览
基于日志的系统指标仅通过包含的日志计算得出。用户定义的基于日志的指标通过包含和排除的日志计算得出。
基于日志的指标的数据来自创建指标后收到的日志条目。指标不会追溯填充 Logging 中已有日志条目的数据。
每当收到匹配的日志条目时,Logging 都会累积基于日志的指标信息。Logging 会以每分钟 1 个数据点的速率将新数据点写入指标的时间序列,以便向 Cloud Monitoring 提供数据。
基于日志的指标时间序列中的每个数据点仅表示自上一个数据点以来收到的额外信息 (delta)。
用户定义的基于日志的指标既可以是计数器指标类型,也可以是分布指标类型。大多数系统定义的基于日志的指标都是计数器指标,但有些是布尔值类型。
以下各部分介绍计数器类型和分布类型指标的特征。
计数器指标
计数器指标用于计算与给定过滤条件匹配的日志条目的数量。例如,您可以执行以下操作:
- 计算包含特定特定错误消息的日志条目的数量。
通过查找与如下模式匹配的日志消息来计算每个用户调用操作的次数:
... user USERNAME called OPERATION ...
通过提取 USERNAME 和 OPERATION 并将其用作两个标签的值,您可以在稍后询问“
sally
调用了多少次update
操作?”、“有多少人调用了read
操作?”、“george
调用了多少次操作?”等问题。
如需了解详情,请参阅配置计数器指标。
分布指标
分布指标会累积与过滤条件匹配的日志条目的数字数据。此类指标包含分布对象的时间序列,每个对象包含以下内容:
- 分布中值的数量。
- 值的平均值。
- 方差和:Sumi=1..n(xi–mean)2
- 一组直方图分区,其中包含每个分区中的值的数量。您可以使用默认分区布局,也可以自行选择分区布局。
分布指标的一个常见用途是跟踪延迟。收到每个日志条目后,系统将从日志条目中的某个位置提取延迟值,并将其添加到分布中。系统会按固定间隔将累积的分布写入 Cloud Monitoring。
如需了解分布(包括其时间序列中的格式及其可视化方式),请参阅绘制分布指标图表。
如需了解如何创建基于日志的分布指标,请参阅配置分布指标。
标签
基于日志的指标可以包含标签,以便为指标收集多个时间序列。系统会从匹配的日志条目中的字段提取标签值。Logging 会为标签值的每个组合记录单独的时间序列。
基于日志的系统指标具有预定义标签。可为用户定义的指标定义标签。如需了解详情,请参阅基于日志的指标标签。
用户定义的基于日志的指标
用户定义的基于日志的指标由 Google Cloud 项目的用户创建。这些指标计算与给定过滤条件匹配的日志条目的数量,或记录匹配的日志条目中的特定值。
如需了解如何使用控制台创建和管理用户定义的指标,请参阅配置计数器指标和配置分布指标。
基于日志的系统指标
Logging 提供了一组指标,其中包含计数器指标。计数器指标用于记录特定时间段内发生的日志记录事件的数量。此类指标具有按日志名称和严重级别记录数量的标签。
如需查看这些指标的列表,请参阅 Google Cloud 指标:日志记录。
Cloud Monitoring
您可以在 Cloud Monitoring 中使用系统定义的和用户定义的基于日志的指标来创建图表和提醒政策。如需了解详情,请参阅配置图表和提醒。
在 Cloud Monitoring 中,基于日志的指标使用以下命名模式:
- 系统:
logging.googleapis.com/SYSTEM_METRIC_NAME
- 用户定义:
logging.googleapis.com/user/USER_METRIC_NAME
请注意,用户定义的指标包含字符串 user
。
价格
用户定义的基于日志的指标是 Cloud Monitoring 自定义指标的一种类别,需要付费。
如需了解价格信息,请参阅 Cloud Logging 价格:基于日志的指标。
问题排查
如果您在使用基于日志的指标时遇到问题,请参阅排查基于日志的指标的问题。