基于日志的指标概览

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

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

基于日志的指标有两种类型:

基于日志的指标仅适用于单个 Google Cloud 项目。不能为日志存储分区或其他 Google Cloud 资源(例如 Cloud Billing 帐号或组织)创建这些资源。

使用入门

如需验证您是否拥有在 Cloud 项目中使用基于日志的指标的正确权限,请参阅本页面上的访问权限控制

如果您是第一次使用 Cloud Monitoring,请参阅本页面上的 Cloud Monitoring 部分。

查看基于日志的指标

您可以通过 Google Cloud Console 中的基于日志的指标页面创建基于日志的指标,其包含您的 Cloud 项目的所有基于日志的指标列表。

如需查看 Google Cloud 项目的基于日志的指标列表,请执行以下操作:

  1. 在 Cloud Console 中,转到基于日志的指标页面:

    转到“基于日志的指标”

  2. 选择现有的 Cloud 项目。 此时会显示 Cloud 项目中基于日志的指标列表。

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

每个窗格都包含一个指标表摘要。每个指标的行都有一个菜单 ,其中具有以下选项:

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

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

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

    选择此选项将打开 Cloud Monitoring 控制台,您可以在其中创建、修改和管理提醒政策。如需详细了解如何为基于日志的指标创建提醒政策,请参阅创建提醒政策

用户定义的指标窗格

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

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

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

  • “用户定义的指标”表包括上月使用量列和月初至今的用量 (MTD) 列。例如,如果您想药确定哪些指标提取了最多的数据量或是想要估算帐单,这种使用情况数据会非常实用。

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

在您的用户定义的指标窗格中,每个指标的菜单 都包含用于管理指标的附加功能:

用户定义的基于日志的指标窗格溢出菜单选项。

  • 查看指标详情:显示指标的名称类型描述过滤条件单位标签
  • 修改指标:允许您修改该指标的某些字段。
  • 停用指标:允许您停止计算该指标。您可以通过同一菜单中重新启用已停用的指标。
  • 删除指标:允许您删除指标。
  • 查看指标的日志:将您转到日志浏览器,并在查询构建器中填充该指标的过滤条件,然后运行查询。

基于日志的指标类型概览

系统(基于日志的)指标仅通过包含的日志计算得出。用户定义的基于日志的指标同时通过包含和排除的日志计算得出。

基于日志的指标的数据来自创建指标后收到的日志条目。指标不会追溯填充 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 项目的用户创建。这些指标计算与给定过滤条件匹配的日志条目的数量,或记录匹配的日志条目中的特定值。

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

系统(基于日志的)指标

Logging 提供了一组指标,其中包含计数器指标。计数器指标用于记录特定时间段内发生的日志记录事件的数量。此类指标具有按日志名称和严重级别记录数量的标签。

如需查看这些指标的列表,请参阅 Google Cloud 指标:日志记录

Cloud Monitoring

您可以在 Cloud Monitoring 中使用系统(基于日志的)指标和用户定义的基于日志的指标来创建图表和提醒政策。如需了解详情,请参阅创建图表和提醒

在 Cloud Monitoring 中,基于日志的指标使用以下命名模式:

  • 系统:logging.googleapis.com/<var>SYSTEM_METRIC_NAME</var>
  • 用户定义:logging.googleapis.com/user/<var>...</var>

请注意,用户定义的指标包含字符串 user

配置

如需为您的项目配置 Cloud Monitoring 工作区,请执行以下操作:
  1. 在 Cloud Console 中,选择您的 Google Cloud 项目。
    转到 Cloud Console
  2. 在导航窗格中,选择 Monitoring

    如果您从未使用过 Cloud Monitoring,那么您在 Google Cloud Console 中首次访问 Monitoring 时,系统会自动创建一个工作区,并将您的项目与该工作区相关联。否则,如果您的项目未与工作区关联,则系统会显示一个对话框,您可以创建一个工作区,也可以将您的项目添加到现有工作区。我们建议您创建一个工作区。完成选择后,请点击添加

访问权限控制机制

如需查看 Cloud 项目的基于日志的指标,请验证您是否具有正确的角色和权限。

Identity and Access Management 角色和权限管理对 Google Cloud 数据的访问权限。以下简要介绍了 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)、Project Editor (roles/editor) 和 Project Owner (roles/owner):这些角色适合多种级层,包含用于创建基于日志的指标的权限 (logging.logMetrics.create)。

如需详细了解权限和角色,请参阅访问权限控制指南

价格

用户定义的基于日志的指标是 Cloud Monitoring 自定义指标的一种类别,需要付费。

如需了解价格信息,请参阅 Cloud Logging 价格:基于日志的指标

问题排查

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