← Cloudflare Logs / logs / logpush / logpush-job / enable-destinations

Povolení koncových bodů kompatibilních s S3

Cloudflare Logpush umožňuje odesílat protokoly do cílů kompatibilních s S3 prostřednictvím Cloudflare dashboardu nebo přes API, mimo jiné:

Další informace o Logpush a aktuálních produkčních API najdete v Cloudflare Logpush dokumentace.

Správa přes dashboard Cloudflare

V dashboardu Cloudflare přejděte na Logpush stránku na úrovni účtu nebo domény (známé také jako zóna).

Pro účet: Přejděte na Logpush ↗

Pro doménu (známou také jako zóna): Přejděte na Logpush ↗
Podle vaší volby máte přístup k datové sady v rozsahu účtu a datové sady s rozsahem zóny, v uvedeném pořadí.
Vyberte Vytvoření úlohy Logpush.

V Vyberte cíl, vyberte Kompatibilní s S3.
Zadejte nebo vyberte následující informace o cíli:
- Bucket - Název bucketu kompatibilního s S3
- Cesta - umístění bucketu v rámci úložného kontejneru
- Uspořádejte protokoly do denních podsložek (doporučeno)
- URL endpointu - URL bez názvu bucketu nebo cesty. Příklad: sfo2.digitaloceanspaces.com.
- Region bucketu
- Access Key ID
- Secret Access Key

Jakmile zadáte podrobnosti cíle, vyberte Pokračovat.

Vyberte datovou sadu, kterou chcete odesílat do úložné služby.
V dalším kroku musíte nakonfigurovat úlohu Logpush:
- Zadejte Název úlohy.
- V části Pokud se protokoly shodují, můžete vybrat, které události chcete do protokolů zahrnout nebo z nich odstranit. Více informací najdete v Filtry s dalšími informacemi. Tato možnost není dostupná u všech datových sad.
- V Odešlete následující pole, můžete se rozhodnout, zda chcete do cílového úložiště odesílat všechny protokoly, nebo si vybrat, které protokoly chcete odesílat.
V Advanced Options, můžete:
- Zvolte formát polí s časovým razítkem ve svých protokolech (RFC3339 (výchozí), Unix, nebo UnixNano).
- Vyberte míra vzorkování pro vaše protokoly, nebo odesílejte náhodně vzorkované procento protokolů.
- Povolte maskování pro CVE-2021-44228. Tato možnost nahradí každý výskyt ${ hodnotou x{.
Vyberte Odeslat jakmile dokončíte konfiguraci úlohy Logpush.

Správa přes API

Chcete-li nastavit koncové body kompatibilní s S3:

Vytvořte úlohu s příslušnou URL adresou koncového bodu a autentizačními parametry.
Povolte úlohu, aby mohla začít odesílat protokoly.

Zajistěte, že Log Share oprávnění povolena, než se pokusíte přečíst nebo nakonfigurovat úlohu Logpush. Další informace najdete na Sekce Role.

1. Vytvořte úlohu

Chcete-li vytvořit úlohu, proveďte POST požadavek na koncový bod úloh Logpush s následujícími poli:

název (volitelné) - Jako název úlohy použijte název své domény.
destination_conf - Cíl protokolů složený z názvu endpointu, názvu bucketu, cesty bucketu, regionu, access-key-id a secret-access-key v následujícím formátu řetězce:

"s3://<BUCKET_NAME>/<BUCKET_PATH>?region=<REGION>&access-key-id=<ACCESS_KEY_ID>&secret-access-key=<SECRET_ACCESS_KEY>&endpoint=<ENDPOINT_URL>"

dataset - Kategorie protokolů, které chcete přijímat. Viz Datové sady pro úplný seznam podporovaných datových sad.
output_options (volitelné) - Chcete-li nakonfigurovat pole, sample rate a formát časového razítka, viz Možnosti výstupu protokolu.

Příklad požadavku pomocí cURL:

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:

Logs Write

Vytvořit úlohu Logpush

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/logpush/jobs" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "<DOMAIN_NAME>",
		"destination_conf": "s3://<BUCKET_NAME>/<BUCKET_PATH>?region=<REGION>&access-key-id=<ACCESS_KEY_ID>&secret-access-key=<SECRET_ACCESS_KEY>&endpoint=<ENDPOINT_URL>",
		"output_options": {
				"field_names": [
						"ClientIP",
						"ClientRequestHost",
						"ClientRequestMethod",
						"ClientRequestURI",
						"EdgeEndTimestamp",
						"EdgeResponseBytes",
						"EdgeResponseStatus",
						"EdgeStartTimestamp",
						"RayID"
				],
				"timestamp_format": "rfc3339"
		},
		"dataset": "http_requests",
		"enabled": true
	}'

Odpověď:

{
  "errors": [],
  "messages": [],
  "result": {
    "id": <JOB_ID>,
    "dataset": "http_requests",
    "kind": "",
    "enabled": true,
    "name": "<DOMAIN_NAME>",
    "output_options": {
      "field_names": ["ClientIP", "ClientRequestHost", "ClientRequestMethod", "ClientRequestURI", "EdgeEndTimestamp","EdgeResponseBytes", "EdgeResponseStatus", "EdgeStartTimestamp", "RayID"],
      "timestamp_format": "rfc3339"
    },
    "destination_conf": "s3://<BUCKET_NAME>/<BUCKET_PATH>?region=<REGION>&access-key-id=<ACCESS_KEY_ID>&secret-access-key=<SECRET_ACCESS_KEY>&endpoint=<ENDPOINT_URL>",
    "last_complete": null,
    "last_error": null,
    "error_message": null
  },
  "success": true
}

Viz Spravovat Logpush pomocí cURL k aktualizaci úlohy (včetně jejího zapnutí a vypnutí).