diff --git a/src/content/docs/r2/platform/metrics-analytics.mdx b/src/content/docs/r2/platform/metrics-analytics.mdx index f8ae2641bee9d19..babada28064c9ef 100644 --- a/src/content/docs/r2/platform/metrics-analytics.mdx +++ b/src/content/docs/r2/platform/metrics-analytics.mdx @@ -18,14 +18,14 @@ R2 currently has two datasets: ### Operations Dataset -|
Field
| Description | -| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| actionType | The name of the operation performed. | -| actionStatus | The status of the operation. Can be `success`, `userError`, or `internalError`. | -| 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 | -| objectName | The object this operation was performed on if applicable. | -| responseStatusCode | The http status code returned by this operation. | -| datetime | The time of the request. | +|
Field
| Description | +| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| actionType | The name of the operation performed. | +| actionStatus | The status of the operation. Can be `success`, `userError`, or `internalError`. | +| 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` | +| objectName | The object this operation was performed on if applicable. | +| responseStatusCode | The http status code returned by this operation. | +| datetime | The time of the request. | ### Storage Dataset @@ -40,6 +40,12 @@ R2 currently has two datasets: Metrics can be queried (and are retained) for the past 31 days. These datasets require an `accountTag` filter with your Cloudflare account ID. +:::caution[Querying buckets with jurisdiction restriction] +In you account, you may have two buckets of the same name, one with a specified jurisdiction, and one without. + +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. +::: + ## View via the dashboard Per-bucket analytics for R2 are available in the Cloudflare dashboard. To view current and historical metrics for a bucket: