基于日志的指标概览

本页面从概念上简要介绍了基于日志的指标。

基于日志的指标指的是基于日志条目内容的 cloud Monitoring 指标。例如,这类指标可以记录包含特定消息的日志条目的数量,也可以提取日志条目中报告的延迟信息。您可以在 Cloud Monitoring 图表和提醒政策中使用基于日志的指标。

系统(基于日志的)指标由 Logging 预定义。 这些指标用于记录特定时间段内发生的日志记录事件的数量。

用户定义的(基于日志的)指标由项目中的用户创建。这些指标用于计算与给定查询匹配的日志条目数,或跟踪匹配日志条目中的特定值。

每当收到匹配的日志条目时,Logging 都会累积基于日志的指标信息。Logging 会以每分钟 1 个数据点的速率将新数据点写入指标的时间序列,以便向 Cloud Monitoring 提供数据。

基于日志的指标的数据来自创建指标后收到的日志条目。指标不会填充 Logging 中已有日志条目的数据。

开始

  1. 转到 Cloud Console 的Google Cloud 操作套件 Logging> 基于日志的指标页面:

    转到“基于日志的指标”页面

  2. 在页面顶部选择一个现有 Google Cloud 项目。Google Cloud 项目中基于日志的指标列表如下所示:

显示基于日志的指标列表的界面。

访问控制

Cloud Identity and Access Management 角色和权限管控着对 Google Cloud 数据的访问权限。 以下简要介绍了 Google Cloud 项目成员访问基于日志的指标所需的常见角色和权限:

  • Logging/Logs Configuration Writer (roles/logging.configWriter):用于列出、创建、获取、更新和删除基于日志的指标。

  • Logging/Logs Viewer (roles/logging.viewer):用于查看现有指标。您还可以为自定义角色添加 logging.logMetrics.getlogging.logMetrics.list 权限。

  • Monitoring Viewer (roles/monitoring.viewer):用于读取基于日志的指标所包含的时间序列。您还可以为自定义角色添加 monitoring.timeSeries.list 权限。

  • Logging Admin (roles/logging.admin)、Editor (roles/editor) 和 Owner (roles/owner):这些角色适合多种级层,包含用于创建基于日志的指标的权限 (logging.logMetrics.create)。

如需了解详情,请参阅 Logging:访问权限控制

基于日志的指标界面

基于日志的指标界面分为两个指标类型区域:系统指标用户定义的指标

这两个区域都分别包含一个指标表摘要。每行表格都有一个菜单 ,其中具有以下选项:

显示菜单的基于日志的指标列表。

  • 在 Metrics Explorer 中查看:借助此选项,您可以打开 Cloud Monitoring Metrics Explorer,以查看基于系统日志的指标的数据。

    您可以使用 Metrics Explorer 为提醒政策指定目标指标。目标区域旁的图表可向您直观地反馈相应目标指标所采集到的数据。

  • 根据指标创建提醒:借助此选项,您可以根据基于日志的指标创建提醒政策。

    选择此选项将打开 Cloud Monitoring 控制台,您可以在其中创建、修改和管理提醒政策。如需了解详情,请参阅创建提醒政策

用户定义的指标界面

基于日志的指标界面中的用户定义的指标区域有几个额外的功能,可帮助您管理项目中用户定义的指标:

  • “用户定义的指标”表包括名称说明类型过滤条件列。这些列是在创建指标时指定的。

  • 借助过滤器指标框,您可以通过文本搜索或指标名称说明过滤条件来过滤您的指标列表:

显示过滤选项的基于日志的指标列表。

  • “用户定义的指标”表包括上月使用量列和本月使用量(截至目前)列。例如,如果您想查看哪些指标提取了最多的数据或估算帐单,这些使用量指标会非常实用。

  • 您可以使用表格行末的菜单 修改指标删除指标

此外,点击任何列名称即可按升序或降序对数据进行排序。在表格的底部,您还可以选择要显示的行数。

如需详细了解如何使用 Cloud Console 管理用户定义的指标,请阅读创建计数器指标创建分布指标

基于日志的指标类型概览

Logging 基于日志的指标可以为以下两种指标类型之一:计数器分布。所有系统(基于日志的)指标都是计数器类型。用户定义的基于日志的指标既可以是计数器类型,也可以是分布类型。

基于日志的指标时间序列中的每个数据点仅表示自上一个数据点以来收到的额外信息 (delta)。

以下各部分介绍计数器类型和分布类型指标的特征。

计数器指标

计数器指标用于计算与高级日志查询匹配的日志条目的数量。例如,您可以执行以下操作:

  • 创建一个指标,用于计算包含某些特定错误消息的日志条目的数量。
  • 通过查找如下日志消息来计算每个用户调用操作的次数:

    ... user [USERNAME] called  [OPERATION] ...
        

    通过提取 [USERNAME] 和 [OPERATION] 并将其用作两个标签的值,您可以在稍后询问“sally 调用了多少次 UPDATE 操作?”、“有多少人调用了 READ 操作?”、“george 调用了多少次操作?”等问题。

如需了解详情,请参阅创建计数器指标

分布指标

分布指标会累积与查询匹配的日志条目的数字数据。此类指标包含 Distribution 对象的时间序列,每个对象包含以下内容:

  • 分布中值的数量。
  • 值的平均值。
  • 方差和:Sumi=1..n(xi–mean)2
  • 一组直方图分区,其中包含每个分区中的值的数量。您可以使用默认分区布局,也可以自行选择分区布局。

分布指标的一个常见用途是跟踪延迟。收到每个日志条目后,系统将从日志条目中的某个位置提取延迟值,并将其添加到分布中。系统会按固定间隔将累积的分布写入 Cloud Monitoring。

如需了解详情,请参阅创建分布指标

标签

基于日志的指标可以选择性地设置标签,这会使单个指标获得多个时间序列。系统会从匹配的日志条目中的字段提取标签值。Logging 会为每个标签的不同值记录单独的时间序列。

系统(基于日志的)指标具有预定义标签。您可以为用户定义的指标定义自己的标签。如需了解详情,请参阅基于日志的指标标签

系统(基于日志的)指标

Logging 可提供一些预定义的计数器指标,用于跟踪收到的日志条目的数量和容量。此类指标具有按日志名称和严重级别记录数量的标签。下表列出了这些指标:

指标名称和说明 类型 标签
logging.googleapis.com/log_entry_count

收到的日志条目总数。

delta int64 log:日志的名称。示例:"appengine.googleapis.com/request_log"

severity:日志条目的严重性。示例:"ERROR"

logging.googleapis.com/byte_count

收到的日志条目字节总数。

delta int64 log:日志的名称。示例:"appengine.googleapis.com/request_log"
logging.googleapis.com/excluded_log_entry_count

排除的日志条目总数。

delta int64
logging.googleapis.com/excluded_byte_count

排除的日志条目中的总字节数。

delta int64
logging.googleapis.com/exports/log_entry_count

使用接收器导出的日志条目总数。

delta int64
logging.googleapis.com/exports/byte_count

使用接收器导出的日志条目总字节数。

delta int64
logging.googleapis.com/exports/error_count

因导出配置错误而未导出的日志条目总数。

delta int64
logging.googleapis.com/logs_based_metrics_error_count

延迟的日志条目数量。1

delta int64 log:日志的名称。示例:"appengine.googleapis.com/request_log"

1 延迟的日志条目不包括在 log_entry_countbyte_count 指标中。

如需查看系统(基于日志的)指标的完整列表,请参阅日志记录指标

Cloud Monitoring

您可以在 Cloud Monitoring 中同时使用系统和用户定义的基于日志的指标来创建图表和提醒策略。用户定义的基于日志的指标名称以 user/ 为前缀,但系统(基于日志的)指标不是。

如果您使用 Cloud Monitoring API,则基于日志的指标名称如下所示:

logging.googleapis.com/user/[USER_METRIC_NAME]
    logging.googleapis.com/[SYSTEM_METRIC_NAME]
    

如需了解详情,请参阅创建图表和提醒

问题排查

如果您在使用基于日志的指标时遇到问题,请参阅问题排查