INTEGRITY Dokumentace

Metriky a analytika

R2 poskytuje analytické přehledy, díky nimž můžete zkontrolovat požadavky a úložiště bucketů ve vašem účtu.

Metriky zobrazené pro bucket v Cloudflare dashboard jsou dotazovány z Cloudflare GraphQL Analytics API. K metrikám máte přístup přes programově přes GraphQL nebo HTTP klienta.

Metriky

R2 v současnosti nabízí dvě datové sady:

Dataset GraphQL Dataset Name Popis
Operace r2OperationsAdaptiveGroups Tato datová sada obsahuje operace provedené na bucketu v rámci účtu.
Úložiště r2StorageAdaptiveGroups Tato datová sada obsahuje údaje o úložišti bucketu v rámci účtu.

Operations Dataset

Pole Popis
actionType Název provedené operace.
actionStatus Stav operace. Může být success, userError, nebo internalError.
bucketName Bucket, na kterém byla operace provedena, pokud je to relevantní. U bucketů se zadanou jurisdikcí musíte před název bucketu uvést jurisdikci následovanou podtržítkem. Například: eu_your-bucket-name
objectName Objekt, na kterém byla tato operace provedena, pokud je to relevantní.
responseStatusCode Stavový kód HTTP vrácený touto operací.
datetime Čas požadavku.

Storage Dataset

Pole Popis
bucketName Bucket, ke kterému se tato hodnota úložiště vztahuje. U bucketů se zadanou jurisdikcí musíte uvést jurisdikce následovaný podtržítkem před názvem bucketu. Například: eu_your-bucket-name
payloadSize Velikost objektů v bucketu.
metadataSize Velikost metadat objektů v bucketu.
objectCount Počet objektů v bucketu.
uploadCount Počet čekajících vícedílných nahrávání v bucketu.
datetime Čas, který tato hodnota úložiště představuje.

Metriky lze dotazovat (a jsou uchovávány) za posledních 31 dní. Tyto datové sady vyžadují accountTag filtr s ID vašeho účtu Cloudflare.

Zobrazit v dashboardu

Analytika pro jednotlivé buckety R2 je dostupná na Cloudflare dashboardu. Zobrazení aktuálních a historických metrik pro bucket:

  1. V dashboardu Cloudflare přejděte na Objektové úložiště R2 stránce.

    Přejděte na Přehled ↗
  2. Vyberte svůj bucket.

  3. Vyberte Metriky kartě.

Volitelně můžete vybrat časové okno pro dotaz. Výchozí hodnota je posledních 24 hodin.

Dotazování přes GraphQL API

Analytiku svých bucketů R2 můžete programově dotazovat přes GraphQL Analytics API. Toto API se dotazuje na stejnou datovou sadu jako Cloudflare dashboard a podporuje GraphQL introspekce.

Příklady

Operace

Chcete-li dotázat objem jednotlivých typů operací na bucketu za dané časové období, můžete spustit dotaz jako tento

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 pole lze odebrat, čímž získáte přehled operací na úrovni účtu. Objem operací lze dále rozčlenit přidáním dalších dimenzí do dotazu.

Úložiště

Chcete-li dotázat úložiště bucketu za dané časové období, můžete spustit dotaz jako tento.

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
				}
			}
		}
	}
}