INTEGRITY Dokumentace

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

Povolení Datadog

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

Správa přes dashboard Cloudflare

  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.

  1. V Vyberte cíl, vyberte Datadog.

  2. Zadejte nebo vyberte následující informace o cíli:

  • http-intake.logs.datadoghq.com/v1/input
  • http-intake.logs.datadoghq.com/api/v2/logs

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

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

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

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

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

Správa přes API

Chcete-li nastavit úlohu Logpush pro Datadog:

  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.

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:

"datadog://<DATADOG_ENDPOINT_URL>?header_DD-API-KEY=<DATADOG_API_KEY>&ddsource=cloudflare&service=<SERVICE>&host=<HOST>&ddtags=<TAGS>"

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é:
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": "datadog://<DATADOG_ENDPOINT_URL>?header_DD-API-KEY=<DATADOG_API_KEY>&ddsource=cloudflare&service=<SERVICE>&host=<HOST>&ddtags=<TAGS>",
		"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": "datadog://<DATADOG_ENDPOINT_URL>?header_DD-API-KEY=<DATADOG_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í).

Omezení

Vezměte na vědomí následující omezení odesílání Logpush, jak je popsáno v Dokumentace Datadog ↗.

Odesílejte protokoly do platformy Datadog přes HTTP. Limity na jeden požadavek HTTP jsou následující: