使用自定义指标

本指南介绍如何创建和使用自定义指标。这些信息分为以下部分:

  • 利用 OpenCensus 获取自定义指标介绍了如何使用 OpenCensus(一个开源监控和跟踪库)创建自定义指标、向其添加指标数据并将它们导出到 Cloud Monitoring。

    当 OpenCensus 的指标导出到 Cloud Monitoring 时,Monitoring 会像处理任何其他自定义指标一样处理它们。

  • 创建自定义指标介绍如何使用 Cloud Monitoring API 创建自定义指标以及向其添加时间序列数据。

    Monitoring API 以示例进行了说明,这些示例分别使用 API Explorer、C#、Go、Java、Node.js、PHP、Python 和 Ruby 编程语言。

以下信息适用于自定义指标和 Cloud Monitoring 提供的指标:

  • 浏览指标说明如何列出和检查自定义指标以及 900 多个内置指标。
  • 阅读指标介绍了如何使用 Monitoring API 从自定义指标和内置指标中检索时间序列数据。您还可以在图表和提醒中使用指标数据。

所有这些在指标上运行的操作都需要 Cloud Monitoring API v3。 如需了解参考文档,请参阅 Cloud Monitoring API 简介

如需了解 Cloud Monitoring 中指标概念的讨论,请参阅指标、时间序列和资源

准备工作

自定义指标属于工作区成员的 Google Cloud 项目。即使您只浏览内置指标,也需要一个项目来进行操作:

  1. 创建或选择您要访问其监控数据的 Google Cloud Console 项目。在本指南中,项目 ID 被称为 {your-project-id}
  2. 为您的项目启用 Monitoring

如果要根据 Google Cloud 项目中的日志设置指标,请使用基于日志的指标

关于自定义指标

自定义指标与 Monitoring 的内置指标相同,但下列方面除外:

  • 您可以在 Google Cloud 项目中创建自定义指标。
  • 自定义指标名称通常以 custom.googleapis.com/ 开头,这与内置指标不同。
  • 您可以在自定义指标中写入时间序列数据。
  • 您可以删除自定义指标。

如需详细了解内置指标,请参阅指标列表

下表显示了 Monitoring API 中可以与自定义指标和内置指标搭配使用的方法:

Monitoring API 方法
自定义指标搭配使用

内置指标搭配使用
monitoredResourceDescriptors.get
monitoredResourceDescriptors.list
metricDescriptors.get
metricDescriptors.list
timeSeries.list
timeSeries.create
metricDescriptors.create
metricDescriptors.delete

限制和延迟时间

如需了解与自定义指标和数据保留相关的限制,请参阅配额和限制。如果您希望在超过指标数据的保留期限之后继续保留,则必须手动将数据复制到其他位置,例如 Cloud Storage 或 BigQuery。

如需了解关于将数据写入自定义指标的延迟时间的信息,请参阅指标数据的延迟时间