本页面从概念上简要介绍了基于日志的指标。
基于日志的指标指的是基于日志条目内容的 Cloud Monitoring 指标。例如，这类指标可以记录包含特定消息的日志条目的数量，也可以提取日志条目中报告的延迟信息。您可以在 Cloud Monitoring 图表和提醒政策中使用基于日志的指标。 基于日志的指标通过包含的日志和排除的日志计算得出。
基于日志的指标仅适用于单个 Google Cloud 项目。您不能为日志存储分区或其他 Google Cloud 资源（例如 Cloud Billing 帐号或组织）创建基于日志的指标。
如需使用基于日志的指标，您必须有启用了结算功能的 Cloud 项目。
系统（基于日志的）指标由 Logging 预定义。这些指标用于记录特定时间段内发生的日志记录事件的数量。 这些指标是免费的，并且可供所有 Google Cloud 项目使用。如需查看这些指标的列表，请参阅“Google Cloud 指标：日志记录”。
用户定义的（基于日志的）指标由 Google Cloud 项目的用户创建。这些指标用于计算与给定查询匹配的日志条目数，或跟踪匹配日志条目中的特定值。在过滤要计入指标的日志条目时，您可以使用正则表达式。
每当收到匹配的日志条目时，Logging 都会累积基于日志的指标的信息。基于日志的指标通过包含的日志和排除的日志计算得出。Logging 会以每分钟 1 个数据点的速率将新数据点写入指标的时间序列，以便向 Cloud Monitoring 提供数据。
基于日志的指标的数据来自创建指标后收到的日志条目。指标不会填充 Logging 中已有日志条目的数据。
使用入门
转到 Cloud Console 中的 Google Cloud 的运维套件 Logging (Google Cloud's operations suite Logging) > 基于日志的指标页面：
在页面顶部选择一个现有 Cloud 项目。Cloud 项目中基于日志的指标列表如下所示：
访问权限控制
Identity and Access Management 角色和权限管理对 Google Cloud 数据的访问权限。以下简要介绍了 Cloud 项目成员访问基于日志的指标所需的常见角色和权限：
Logging/Logs Configuration Writer (
roles/logging.configWriter)：用于列出、创建、获取、更新和删除基于日志的指标。Logging/Logs Viewer (
roles/logging.viewer)：用于查看现有指标。您还可以为自定义角色添加logging.logMetrics.get和logging.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：访问权限控制”。
基于日志的指标界面
基于日志的指标界面分为两个指标类型区域：系统指标和用户定义的指标。
这两个区域都分别包含一个指标表摘要。表中每一行都有一个菜单 more_vert，其中具有以下选项：
在 Metrics Explorer 中查看：借助此选项，您可以打开 Cloud Monitoring Metrics Explorer，以查看系统（基于日志的）指标的数据。
您可以使用 Metrics Explorer 为提醒政策指定目标指标。目标区域旁的图表可向您直观地反馈相应目标指标所采集到的数据。
根据指标创建提醒：借助此选项，您可以根据基于日志的指标创建提醒政策。
选择此选项将打开 Cloud Monitoring 控制台，您可以在其中创建、修改和管理提醒政策。如需了解详情，请参阅创建提醒政策。
用户定义的指标界面
“基于日志的指标”界面中的用户定义的指标区域有几个额外的功能，可帮助您管理项目中用户定义的指标：
“用户定义的指标”表包括名称、说明、类型和过滤条件列。这些列是在创建指标时指定的。
借助过滤器指标框，您可以通过文本搜索或指标名称、说明和过滤条件来过滤您的指标列表：
“用户定义的指标”表包括上月使用量列和使用量（本月截至目前）列。例如，如果您想查看哪些指标提取了最多的数据或估算帐单，这些使用量指标会非常实用。
您可以使用表格行末尾的菜单 more_vert 来修改指标和删除指标。
此外，点击任何列名称即可按升序或降序对数据进行排序。在表格的底部，您还可以选择要显示的行数。
如需详细了解如何使用 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
收到的日志条目总数。 |
增量 | int64 |
log：日志的名称。
示例："appengine.googleapis.com/request_log"。
|
logging.googleapis.com/byte_count
收到的日志条目字节总数。 |
增量 | int64 |
log：日志的名称。示例："appengine.googleapis.com/request_log"。 |
logging.googleapis.com/excluded_log_entry_count
排除的日志条目总数。 |
增量 | int64 | |
logging.googleapis.com/excluded_byte_count
排除的日志条目中的总字节数。 |
增量 | int64 | |
logging.googleapis.com/exports/log_entry_count
使用接收器导出的日志条目总数。 |
delta | int64 | |
logging.googleapis.com/exports/byte_count
使用接收器导出的日志条目总字节数。 |
delta | int64 | |
logging.googleapis.com/exports/error_count
因导出配置错误而未导出的日志条目总数。 |
增量 | int64 | |
logging.googleapis.com/logs_based_metrics_error_count
延迟的日志条目数量。1 |
增量 | int64 |
log：日志的名称。示例："appengine.googleapis.com/request_log"。 |
1 到达时间晚于 24 小时或早于 10 分钟的日志条目不会包括在 log_entry_count 或 byte_count 指标中。
如需查看系统（基于日志的）指标的完整列表，请参阅日志记录指标。
Cloud Monitoring
您可以在 Cloud Monitoring 中使用系统（基于日志的）指标和用户定义的基于日志的指标来创建图表和提醒政策。用户定义的基于日志的指标名称以 user/ 为前缀，但系统（基于日志的）指标不是。
如果您使用的是 Cloud Monitoring API，则基于日志的指标名称如下所示：
logging.googleapis.com/user/[USER_METRIC_NAME]
logging.googleapis.com/[SYSTEM_METRIC_NAME]
如需了解详情，请参阅创建图表和提醒。
问题排查
如果您在使用基于日志的指标时遇到问题，请参阅问题排查。