Skip to content

Commit ed15a7b

Browse files
authored
Adding warning note about querying bucket with jurisdictions (#23384)
1 parent 8f2aae1 commit ed15a7b

File tree

1 file changed

+14
-8
lines changed

1 file changed

+14
-8
lines changed

src/content/docs/r2/platform/metrics-analytics.mdx

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -18,14 +18,14 @@ R2 currently has two datasets:
1818

1919
### Operations Dataset
2020

21-
| <div style="width:175px"> Field </div> | Description |
22-
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
23-
| actionType | The name of the operation performed. |
24-
| actionStatus | The status of the operation. Can be `success`, `userError`, or `internalError`. |
25-
| bucketName | The bucket this operation was performed on if applicable. For buckets with a jurisdiction specified, you must include the jurisdiction followed by an underscore before the bucket name. For example: eu_your-bucket-name |
26-
| objectName | The object this operation was performed on if applicable. |
27-
| responseStatusCode | The http status code returned by this operation. |
28-
| datetime | The time of the request. |
21+
| <div style="width:175px"> Field </div> | Description |
22+
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
23+
| actionType | The name of the operation performed. |
24+
| actionStatus | The status of the operation. Can be `success`, `userError`, or `internalError`. |
25+
| bucketName | The bucket this operation was performed on if applicable. For buckets with a jurisdiction specified, you must include the jurisdiction followed by an underscore before the bucket name. For example: `eu_your-bucket-name` |
26+
| objectName | The object this operation was performed on if applicable. |
27+
| responseStatusCode | The http status code returned by this operation. |
28+
| datetime | The time of the request. |
2929

3030
### Storage Dataset
3131

@@ -40,6 +40,12 @@ R2 currently has two datasets:
4040

4141
Metrics can be queried (and are retained) for the past 31 days. These datasets require an `accountTag` filter with your Cloudflare account ID.
4242

43+
:::caution[Querying buckets with jurisdiction restriction]
44+
In you account, you may have two buckets of the same name, one with a specified jurisdiction, and one without.
45+
46+
Therefore, if you want to query metrics about a bucket which has a specified jurisdiction, you must include the [jurisdiction](https://developers.cloudflare.com/r2/reference/data-location/#jurisdictional-restrictions) followed by an underscore before the bucket name. For example: `eu_bucket-name`. This ensures you query the correct bucket.
47+
:::
48+
4349
## View via the dashboard
4450

4551
Per-bucket analytics for R2 are available in the Cloudflare dashboard. To view current and historical metrics for a bucket:

0 commit comments

Comments
 (0)