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

Povolení IBM Cloud Logs

Cloudflare Logpush umožňuje odesílat protokoly přímo do IBM Cloud Logs prostřednictvím dashboardu nebo API.

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 IBM Cloud Logs.

5. Zadejte následující informace o cíli:

• HTTP Source Address - Například ibmcl://<INSTANCE_ID>.ingress.<REGION>.logs.cloud.ibm.com/logs/v1/singles.
• Klíč API IBM - Další informace najdete v Dokumentace IBM Cloud Logs ↗.

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

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 nastavit úlohu IBM Cloud Logs:

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

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.
• output_options (volitelné) - Tento parametr slouží k definici požadovaného výstupního formátu a struktury. Konfigurovatelná pole najdete níže:
  • output_type
  • timestamp_format
  • batch_prefix a batch_suffix
  • record_prefix a record_suffix
  • record_delimiter
• destination_conf - Cíl protokolů složený z Instance ID, Region a Klíč API IBM ↗ ve formátu řetězce uvedeném níže.

ibmcl://<INSTANCE_ID>.ingress.<REGION>.logs.cloud.ibm.com/logs/v1/singles?ibm_api_key=<IBM_API_KEY>

• max_upload_records (volitelné) - Maximální počet řádků protokolu na dávku. Musí jít alespoň o 1 000 řádků. Minimální počet řádků na dávku nastavit nelze, takže soubory protokolu mohou obsahovat výrazně méně řádků, než je zadaná hodnota.
• max_upload_bytes (volitelné) - Maximální nekomprimovaná velikost souboru pro dávku protokolů. Doporučujeme výchozí hodnotu 2 MB na jedno nahrání, vycházející z limitů IBM, které náš systém pro tento cíl vynucuje. Minimální velikost souboru nastavit nelze, takže soubory protokolu mohou být menší než zadaná velikost dávky.
• dataset - Kategorie protokolů, které chcete přijímat. Viz Datové sady pro úplný seznam podporovaných datových sad.

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>",
		"output_options": {
				"output_type": "ndjson",
				"timestamp_format": "rfc3339",
				"batch_prefix": "[",
				"batch_suffix": "]",
				"record_prefix": "{\"applicationName\":\"ibm-platform-log\",\"subsystemName\":\"internet-svcs:logpush\",\"text\":{",
				"record_suffix": "}}",
				"record_delimiter": ","
		},
		"destination_conf": "ibmcl://<INSTANCE_ID>.ingress.<REGION>.logs.cloud.ibm.com/logs/v1/singles?ibm_api_key=<IBM_API_KEY>",
		"max_upload_bytes": 2000000,
		"dataset": "http_requests",
		"enabled": true
	}'

Odpověď:

{
  "errors": [],
  "messages": [],
  "result": {
    "id": <JOB_ID>,
    "dataset": "http_requests",
    "kind": "",
    "max_upload_bytes": 2000000,
    "enabled": true,
    "name": "<DOMAIN_NAME>",
    "output_options": {
      "output_type": "ndjson",
      "timestamp_format": "rfc3339",
      "batch_prefix": "[",
      "batch_suffix": "]",
      "record_prefix": "{\"applicationName\":\"ibm-platform-log\",\"subsystemName\":\"internet-svcs:logpush\",\"text\":{",
      "record_suffix": "}}",
      "record_delimiter": ","
    },
    "destination_conf": "ibmcl://<INSTANCE_ID>.ingress.<REGION>.logs.cloud.ibm.com/logs/v1/singles?ibm_api_key=<IBM_API_KEY>",
    "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í).