R2 提供跨存储桶的请求、存储和带宽用量分析。
在 Cloudflare 仪表板 ↗ 中显示的存储桶指标从 Cloudflare 的 GraphQL Analytics API 查询。您可以通过 GraphQL 或 HTTP 客户端以编程方式访问这些指标。
R2 有三个数据集:
| Dataset | GraphQL Dataset Name | Description |
|---|---|---|
| Operations | r2OperationsAdaptiveGroups |
此数据集包含账户内存储桶上执行的操作。 |
| Storage | r2StorageAdaptiveGroups |
此数据集包含账户内存储桶的存储情况。 |
| Bandwidth | r2BandwidthUsageAdaptiveGroups |
此数据集包含账户内存储桶的上传和下载字节数。 |
指标最多可查询 31 天范围。这些数据集需要带有 Cloudflare 账户 ID 的 accountTag 过滤器。
| Field | Description |
|---|---|
| actionType | 执行的操作名称。 |
| actionStatus | 操作的状态。可以是 success、userError 或 internalError。 |
| bucketName | 执行此操作的存储桶(如适用)。对于指定了管辖区域的存储桶,必须在存储桶名称前加上管辖区域和下划线。例如:eu_your-bucket-name |
| objectName | 执行此操作的对象(如适用)。 |
| responseStatusCode | 此操作返回的 HTTP 状态码。 |
| datetime | 请求的时间。 |
| Field | Description |
|---|---|
| bucketName | 此存储值对应的存储桶。对于指定了管辖区域的存储桶,必须在存储桶名称前加上管辖区域和下划线。例如:eu_your-bucket-name |
| payloadSize | 存储桶中对象的大小。 |
| metadataSize | 存储桶中对象元数据的大小。 |
| objectCount | 存储桶中的对象数量。 |
| uploadCount | 存储桶中待完成的分片上传数量。 |
| datetime | 此存储值所代表的时间。 |
该数据集排除小于 100 KiB 的带宽传输。此阈值适用于传输大小,而非对象大小。
您可以按以下字段筛选:
| 字段 | 描述 |
|---|---|
bucketName |
R2 存储桶标识符,如适用则包含管辖区域前缀。 |
date |
截断到当天开始的传输时间戳。 |
datetimeHour |
截断到该小时开始的传输时间戳。 |
datetimeFifteenMinutes |
向下取整到最近一刻钟的传输时间戳。 |
datetimeFiveMinutes |
截断到五分钟区间开始的传输时间戳。 |
datetimeMinute |
截断到该分钟开始的传输时间戳。 |
datetime |
原始传输时间戳。 |
以下字段可以求和:
| 字段 | 描述 |
|---|---|
bytesDownload |
下载字节数。 |
bytesUpload |
上传字节数。 |
R2 的按存储桶分析可在 Cloudflare 仪表板中查看。要查看存储桶的当前和历史指标:
-
在 Cloudflare 仪表板中,前往 R2 object storage(R2 对象存储) 页面。
前往 Overview(概览) ↗ -
选择您的存储桶。
-
选择 Metrics(指标) 选项卡。
您可以选择时间窗口进行查询。默认值为过去 24 小时。
您可以通过 GraphQL Analytics API 以编程方式查询 R2 存储桶的分析数据。此 API 查询与 Cloudflare 仪表板相同的数据集,并支持 GraphQL 内省。
要查询给定时间段内存储桶上每种操作类型的数量,可以运行如下查询
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 字段可获取账户级别的操作概览。通过向查询添加更多维度,可以进一步细分操作量。
要查询给定时间段内存储桶的存储情况,可以运行如下查询。
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
}
}
}
}
}查询存储桶的每小时上传和下载。结果包含字节总量而非传输速率,并排除小于 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
}
}
}
}
}