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

Povolení cíle HTTP

Cloudflare Logpush nyní umožňuje odesílat protokoly na konfigurovatelné HTTP endpointy.

Upozorňujeme, že při použití Logpush na koncové body HTTP se od zákazníků Cloudflare očekává, že si ověřování odesílaných protokolů zajistí sami. Zákazníci mohou například zadat tajný token v URL adrese nebo v hlavičce HTTP cílového umístění Logpush.

1. 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 ↗

2. 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í.

3. Vyberte Vytvoření úlohy Logpush.

4. V Vyberte cíl, vyberte Cíl HTTP.

5. Zadejte koncový bod HTTP kam chcete protokoly odesílat, a vyberte Pokračovat. - Můžete použít "header_*" parametry URL pro nastavení hlaviček požadavku, například pro předání autentizačního tokenu na váš koncový bod HTTP.

6. Vyberte datovou sadu, kterou chcete odesílat do úložné služby.

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

8. 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{.

9. Vyberte Odeslat jakmile dokončíte konfiguraci úlohy Logpush.

Chcete-li vytvořit úlohu Logpush, proveďte POST požadavek na URL koncového bodu pro vytvoření úlohy Logpush s příslušnými parametry.

Podporované parametry jsou následující:

• Pole, která se nemění oproti jiným zdrojům:
  • dataset (povinné): Například http_requests.
  • název (volitelné): Doporučujeme jako název úlohy použít název své domény.
  • output_options (volitelné): Viz Možnosti výstupu protokolu ke konfiguraci polí, vzorkovací frekvence a formátu časového razítka.
• Jedinečná pole:
  • destination_conf: Kam odesílat logy. Skládá se z URL adresy koncového bodu a použitých HTTP hlaviček.
    • Jakýkoli "header_*" parametry URL se použijí k nastavení hlaviček požadavku.
      • Endpoint HTTPS nemůže mít vlastní parametry URL, které jsou v konfliktu s žádnými "header_*" parametry URL, které jste nastavili.
      • Tyto parametry musí být správně zakódované do URL (to znamená použijte "%20" pro mezeru), jinak mohou být některé speciální znaky dekódovány nesprávně.
    • destination_conf může mít další parametry URL kromě speciálních "header_*" parametry.
      • Speciální znaky, které nejsou URL kódované, budou při nahrávání zakódovány.
    • Příklad: https://logs.example.com?header_Authorization=Basic%20REDACTED&tags=host:theburritobot.com,dataset:http_requests
  • max_upload_bytes (volitelné): Maximální nekomprimovaná velikost souboru dávky protokolů. Hodnota tohoto nastavení musí být mezi 5 MB a 1 GB. Minimální velikost souboru nastavit nelze, takže soubory protokolu mohou být výrazně menší než tato velikost dávky.
  • max_upload_records (volitelné): Maximální počet řádků protokolu na dávku. Toto nastavení musí být mezi 1 000 a 1 000 000 řádky. Minimální počet řádků na dávku nastavit nelze, takže soubory protokolu mohou obsahovat výrazně méně řádků, než je tato hodnota.

Příklad požadavku pomocí cURL:

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": "https://logs.example.com?header_Authorization=Basic%20REDACTED&tags=host:theburritobot.com,dataset:http_requests",
		"output_options": {
				"field_names": [
						"ClientIP",
						"ClientRequestHost",
						"ClientRequestMethod",
						"ClientRequestURI",
						"EdgeEndTimestamp",
						"EdgeResponseBytes",
						"EdgeResponseStatus",
						"EdgeStartTimestamp",
						"RayID"
				],
				"timestamp_format": "rfc3339"
		},
		"max_upload_bytes": 5000000,
		"max_upload_records": 1000,
		"dataset": "http_requests",
		"enabled": true
	}'

Odpověď:

{
  "errors": [],
  "messages": [],
  "result": {
    "id": <JOB_ID>,
    "dataset": "http_requests",
    "kind": "",
    "max_upload_bytes": 5000000,
    "max_upload_records": 1000,
    "enabled": true,
    "name": "<DOMAIN_NAME>",
    "output_options": {
      "field_names": ["ClientIP", "ClientRequestHost", "ClientRequestMethod", "ClientRequestURI", "EdgeEndTimestamp", "EdgeResponseBytes", "EdgeResponseStatus" ,"EdgeStartTimestamp", "RayID"],
      "timestamp_format": "rfc3339"
    },
    "destination_conf": "https://logs.example.com?header_Authorization=Basic%20REDACTED&tags=host:theburritobot.com,dataset:http_requests",
    "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í).