跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

指标和分析

最后更新 查看 MarkdownAgent 设置

R2 提供跨存储桶的请求、存储和带宽用量分析。

在 Cloudflare 仪表板 ↗ 中显示的存储桶指标从 Cloudflare 的 GraphQL Analytics API 查询。您可以通过 GraphQL 或 HTTP 客户端以编程方式访问这些指标。

指标

R2 有三个数据集:

Dataset GraphQL Dataset Name Description
Operations r2OperationsAdaptiveGroups 此数据集包含账户内存储桶上执行的操作。
Storage r2StorageAdaptiveGroups 此数据集包含账户内存储桶的存储情况。
Bandwidth r2BandwidthUsageAdaptiveGroups 此数据集包含账户内存储桶的上传和下载字节数。

指标最多可查询 31 天范围。这些数据集需要带有 Cloudflare 账户 ID 的 accountTag 过滤器。

Operations dataset

Field Description
actionType 执行的操作名称。
actionStatus 操作的状态。可以是 success、userError 或 internalError。
bucketName 执行此操作的存储桶(如适用)。对于指定了管辖区域的存储桶,必须在存储桶名称前加上管辖区域和下划线。例如:eu_your-bucket-name
objectName 执行此操作的对象(如适用)。
responseStatusCode 此操作返回的 HTTP 状态码。
datetime 请求的时间。

Storage dataset

Field Description
bucketName 此存储值对应的存储桶。对于指定了管辖区域的存储桶,必须在存储桶名称前加上管辖区域和下划线。例如:eu_your-bucket-name
payloadSize 存储桶中对象的大小。
metadataSize 存储桶中对象元数据的大小。
objectCount 存储桶中的对象数量。
uploadCount 存储桶中待完成的分片上传数量。
datetime 此存储值所代表的时间。

Bandwidth dataset

该数据集排除小于 100 KiB 的带宽传输。此阈值适用于传输大小,而非对象大小。

您可以按以下字段筛选:

字段 描述
bucketName R2 存储桶标识符,如适用则包含管辖区域前缀。
date 截断到当天开始的传输时间戳。
datetimeHour 截断到该小时开始的传输时间戳。
datetimeFifteenMinutes 向下取整到最近一刻钟的传输时间戳。
datetimeFiveMinutes 截断到五分钟区间开始的传输时间戳。
datetimeMinute 截断到该分钟开始的传输时间戳。
datetime 原始传输时间戳。

以下字段可以求和:

字段 描述
bytesDownload 下载字节数。
bytesUpload 上传字节数。

通过仪表板查看

R2 的按存储桶分析可在 Cloudflare 仪表板中查看。要查看存储桶的当前和历史指标:

  1. 在 Cloudflare 仪表板中,前往 R2 object storage(R2 对象存储) 页面。

    前往 Overview(概览) ↗
  2. 选择您的存储桶。

  3. 选择 Metrics(指标) 选项卡。

您可以选择时间窗口进行查询。默认值为过去 24 小时。

通过 GraphQL API 查询

您可以通过 GraphQL Analytics API 以编程方式查询 R2 存储桶的分析数据。此 API 查询与 Cloudflare 仪表板相同的数据集,并支持 GraphQL 内省。

示例

Operations

要查询给定时间段内存储桶上每种操作类型的数量,可以运行如下查询

query R2VolumeExample(
	$accountTag: string!
	$startDate: Time
	$endDate: Time
	$bucketName: string
) {
	viewer {
		accounts(filter: { accountTag: $accountTag }) {
			r2OperationsAdaptiveGroups(
				limit: 10000
				filter: {
					datetime_geq: $startDate
					datetime_leq: $endDate
					bucketName: $bucketName
				}
			) {
				sum {
					requests
				}
				dimensions {
					actionType
				}
			}
		}
	}
}

移除 bucketName 字段可获取账户级别的操作概览。通过向查询添加更多维度,可以进一步细分操作量。

Storage

要查询给定时间段内存储桶的存储情况,可以运行如下查询。

query R2StorageExample(
	$accountTag: string!
	$startDate: Time
	$endDate: Time
	$bucketName: string
) {
	viewer {
		accounts(filter: { accountTag: $accountTag }) {
			r2StorageAdaptiveGroups(
				limit: 10000
				filter: {
					datetime_geq: $startDate
					datetime_leq: $endDate
					bucketName: $bucketName
				}
				orderBy: [datetime_DESC]
			) {
				max {
					objectCount
					uploadCount
					payloadSize
					metadataSize
				}
				dimensions {
					datetime
				}
			}
		}
	}
}

Bandwidth

查询存储桶的每小时上传和下载。结果包含字节总量而非传输速率,并排除小于 100 KiB 的传输。

query R2BandwidthExample(
	$accountTag: string!
	$startDate: Time!
	$endDate: Time!
	$bucketName: string!
) {
	viewer {
		accounts(filter: { accountTag: $accountTag }) {
			r2BandwidthUsageAdaptiveGroups(
				limit: 1000
				filter: {
					datetime_geq: $startDate
					datetime_lt: $endDate
					bucketName: $bucketName
				}
				orderBy: [datetimeHour_ASC]
			) {
				sum {
					bytesUpload
					bytesDownload
				}
				dimensions {
					datetimeHour
				}
			}
		}
	}
}

这篇文档对您有帮助吗?