Compute Engine 可让您利用使用情况导出功能将 Compute Engine 使用情况的详细报告导出到 Cloud Storage 存储桶。使用情况报告会提供有关资源生命周期的信息。例如,您可以查看项目中运行 n2-standard-4
机器类型的虚拟机实例数量以及每个实例的运行时长。您还可以查看永久性磁盘的存储空间以及有关其他 Compute Engine 功能的信息。
不过,用量报告并不会提供账单或活动信息(例如有关 API 请求的信息)。如需了解账单信息,请参阅账单导出功能。如需了解活动日志,请参阅活动日志。
准备工作
-
设置身份验证(如果尚未设置)。身份验证是通过其进行身份验证以访问 Google Cloud 服务和 API 的过程。如需从本地开发环境运行代码或示例,您可以按如下方式向 Compute Engine 进行身份验证。
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
每日使用情况报告
这些报告每日传送,其中包含前一天的使用情况数据。每份报告都是一个单独的文件,包含上一时间范围的数据。这些报告中的数据都是不可变的,这意味着如果数据不准确,Compute Engine 不会更新或重写日志文件。不过,系统会在传送到存储桶的下一份新报告中更正这些数据。
每日使用情况报告的名称格式如下:
<bucket>/<report_prefix>_<numeric_project_id>_<YYYYMMDD>.csv
每月汇总报告
每月汇总报告每日都会传送一份,这些报告包含截至当日(但不包括当日)为止该项目的每月使用情况数据。每月使用情况报告每天都会被新数据覆盖,这些新数据反映了截至此日期为止资源的每月使用情况。每个项目每个月只有一个每月使用情况数据文件。
每月汇总报告的名称格式如下:
<bucket>/<report_prefix>_<numeric_project_id>_<YYYYMM>.csv
每日报告文件与每月报告文件非常相似,差别仅在于日期格式。每月汇总报告的日期采用年月格式 (
YYYYMM
),而每日使用情况报告的日期采用年月日格式 (YYYYMMDD
)。- 您必须已创建存储桶才能存储使用情况日志。
将接收报告的 Cloud Storage 存储桶。
您可以选择自己拥有的任何 Cloud Storage 存储桶(包括不同项目中的存储桶)。在开始导出报告之前,此存储桶必须已存在,并且您必须拥有对此存储桶的所有者权限。Cloud Storage 会针对使用情况收费,因此,您应查看 Cloud Storage 价格,以了解使用该服务可能产生的费用。
对 Cloud Storage 存储桶有读取权限的用户可以查看存储桶中的使用情况报告。对 Cloud Storage 存储桶有写入权限的用户可以创建、查看和修改存储桶中的现有文件。如需了解详情,请参阅访问权限控制部分。
您的文件的报告前缀。
您可以指定要用于使用情况报告的报告前缀。您的使用情况报告的文件名将会包含此前缀。例如,如果将“my-cool-project-report”指定为报告前缀,则系统会生成类似于
my-cool-project-report_1234567890_20131230.csv
格式的文件名。如果您没有指定报告前缀,则系统会默认使用usage_gce
前缀。转到 Compute Engine“设置”页面。
选中启用使用情况导出功能复选框。
填写要求输入存储桶名称的字段。(可选)根据需要提供报告前缀。如果您将报告前缀留空,则系统会默认使用
usage_gce
前缀。传送到该存储桶的所有使用情况报告都会使用此前缀命名。点击保存。
[BUCKET_NAME]
是接收使用情况报告的现有存储桶的名称。必须采用gs://<bucket-name>
或https://storage.googleapis.com/<bucket-name>
格式。运行此命令的用户必须是该存储桶的所有者。[PREFIX]
是使用情况报告名称的可选前缀。如果未指定,则使用默认前缀usage_gce
。- 虚拟机
- 永久性磁盘
- 映像
- 快照
- 静态 IP 地址
- 负载均衡器
- 预留
- 指标类型:字符串
- 说明:使用情况的日期。
- 示例:2019-08-15
- 指标类型:字符串
-
说明:受测资源的类型 ID。
例如,VmimageN2StandardCore_Uswest2
表示us-west2
机器类型中的n2-standard
。 -
示例:
com.google.cloud/services/compute‑engine/VmimageN2StandardCore_Uswest2
-
示例:
com.google.cloud/services/compute‑engine/VmimageN2StandardRam_Uswest2
- 指标类型:整数
- 说明:指定日期的使用量。
- 示例:86400
- 指标类型:字符串
- 说明:单位类型,如计数、秒、小时等。
- 示例:秒
- 指标类型:字符串
- 说明:指定资源的 URI。
-
示例:
https://compute.googleapis.com/compute/v1/projects/<project‑id>/zones/<zone>/instances/<instance>
- 指标类型:整数
- 说明:标识特定资源的数字 ID。
- 示例:16557630484925648021
- 指标类型:字符串
-
说明:资源的位置。通常为地区或区域名称;如果是全球性资源,则为
GLOBAL
。 -
示例:
us-central1-a
转到 Compute Engine“设置”页面。
取消选中启用使用情况导出功能复选框即可停用使用情况导出功能。
- 启用账单导出功能以查看结算日志。
- 使用活动日志跟踪项目中的活动。
- 详细了解 Cloud Storage 存储桶。
- 详细了解 Compute Engine 价格。
- 使用价格计算器获取估价。
Python
如需在本地开发环境中使用本页面上的 Python 示例,请安装并初始化 gcloud CLI,然后使用您的用户凭据设置应用默认凭据。
如需了解详情,请参阅 Set up authentication for a local development environment。
概览
当您启用使用情况报告时,Compute Engine 会向您指定的 Cloud Storage 存储桶传送两种类型的报告:
所有用量报告均以英文逗号分隔值 (CSV) 格式传送,并使用
<report_prefix>
作为前缀。用户可以自定义<report_prefix>
的值。如果您未指定报告前缀,系统会默认使用前缀usage_gce
。所有时间均采用太平洋时间 (PST)。前提条件
在开始使用 Compute Engine 使用情况导出功能之前,请先完成以下步骤:
设置使用情况导出功能
当您首次启用使用情况导出功能时,第一份报告会在第二天发出,其中详细说明了前一天的使用情况。此后,您每隔 24 小时就会收到一份报告。
如需设置使用情况导出功能,请使用
gcloud compute
工具启用该功能。启用该功能时,您必须定义以下两个属性:确定这两个属性后,您可以通过以下方法启用使用情况导出功能:
控制台
gcloud
在
gcloud compute
中,使用gcloud compute project-info set-usage-bucket
命令启用此功能。gcloud compute project-info set-usage-bucket --bucket [BUCKET_NAME] [--prefix [PREFIX]]
其中:
Python
如需启用使用情况导出功能,请使用
Projects
集合中的set_usage_export_bucket()
方法。以下示例使用 Python 版 Cloud 客户端库:如需了解详情,请参阅
projects.setUsageExportBucket
的 API 参考文档。下载使用情况导出报告
开始在您的存储桶中接收使用情况报告后,请像从 Cloud Storage 中下载其他对象一样下载报告。如需了解详情,请参阅下载对象。
支持的指标
每日使用情况报告提供以下资源的使用情况信息:
系统使用以下指标描述每个资源:
指标名称 指标属性 Report Date MeasurementId 数量 Unit Resource URI ResourceId 位置 报告中条目的示例如下:
Report Date MeasurementId 数量 Unit Resource URI Resource ID 位置 02/13/2019 com.google.cloud/services/compute-engine/VmimageE2Standard_2
86400 seconds https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/my-instance
16557630484 us-central1-a 访问权限控制
当您为 Cloud Storage 存储桶启用使用情况导出功能后,Compute Engine 会自动将自身添加到其拥有写入权限的存储桶,以便传送使用情况报告。只要 Compute Engine 有权访问存储桶,并且使用情况导出功能已启用,Compute Engine 就会继续将使用情况报告导出到指定的 Cloud Storage 存储桶。
如果您看到存储桶 IAM 政策中添加了以下身份,则可以确定 Compute Engine 有权访问该存储桶:
cloud-cluster-analytics-export@google.com
身为项目所有者的所有用户均拥有对 Cloud Storage 存储桶的完整访问权限。其他用户(如写入者和读取者)对存储桶有不同程度的访问权限。如需了解存储桶的 IAM,请参阅 Cloud Storage 的 IAM。
如果您停用使用情况导出功能,Compute Engine 会自动将其对存储桶的写入权限移除。如果您修改 cloud-cluster-analytics-export@google.com 账号的权限,然后停用使用情况导出功能,则 Compute Engine 会停用使用情况导出功能,但不会从项目访问权限列表中移除该账号。如果需要,您可以选择手动移除账号。
检查使用情况报告是否已启用
您可以通过获取项目相关信息来检查项目的使用情况导出功能设置:
gcloud compute project-info describe
查找
usageExportLocation
字段:+-------------------------+----------------------------------------------------+ | name | myproject | | description | | | creation-time | 2019-10-18T16:31:52.308-07:00 | | usage | | | snapshots | 1.0/1000.0 | | networks | 2.0/2.0 | | firewalls | 3.0/10.0 | |... | | | usageExportLocation | | | bucketName | https://storage.googleapis.com/usage-export-sample | | reportNamePrefix | | +-------------------------+----------------------------------------------------+
停用使用情况报告
当您停用使用情况报告时,Compute Engine 会自动移除其对 Cloud Storage 存储桶的写入权限,并停止发送新报告。
控制台
gcloud
在
gcloud compute
中,通过运行带有--no-bucket
标志的gcloud compute project-info set-usage-bucket
命令来停用使用情况导出功能:gcloud compute project-info set-usage-bucket --no-bucket
Python
如需停用使用情况导出功能,请使用
Projects
集合中的set_usage_export_bucket()
方法并将usage_export_location_resource
设置为None
。以下示例使用 Python 版 Cloud 客户端库:后续步骤
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-10-04。
-