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

Povolení New Relic

Cloudflare Logpush umožňuje odesílat protokoly přímo do New Relic prostřednictvím Cloudflare dashboardu nebo přes 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 New Relic.

5. Zadejte New Relic Logs Endpoint:

Použijte oblast, která odpovídá oblasti nastavené ve vašem účtu New Relic. Licenční klíč najdete v dashboardu New Relic. Získáte ho podle tyto kroky ↗.

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.

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.

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é) - Chcete-li nakonfigurovat pole, sample rate a formát časového razítka, viz Možnosti výstupu protokolu.

• destination_conf - Cíl protokolů složený z URL endpointu, licenčního klíče a formátu ve formátu řetězce níže.

  • <NR_ENDPOINT_URL>: Koncový bod pro příjem HTTP logů služby New Relic, kterým je https://log-api.newrelic.com/log/v1 pro US nebo https://log-api.eu.newrelic.com/log/v1 pro EU, v závislosti na regionu nastaveném u vašeho účtu New Relic.

  • <NR_LICENSE_KEY>: Tento klíč najdete v dashboardu New Relic a získáte ho podle tyto kroky ↗.

  • format: Formát je cloudflare.

    US: "https://log-api.newrelic.com/log/v1?Api-Key=<NR_LICENSE_KEY>&format=cloudflare"

    EU: "https://log-api.eu.newrelic.com/log/v1?Api-Key=<NR_LICENSE_KEY>&format=cloudflare"

• 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 dávky protokolů. Musí jít alespoň o 5 MB. Minimální velikost souboru nastavit nelze, takže soubory protokolu mohou být výrazně menší než tato velikost dávky. Přesto doporučujeme nastavit tento parametr na hodnotu 5 000 000.

• 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": {
				"field_names": [
						"ClientIP",
						"ClientRequestHost",
						"ClientRequestMethod",
						"ClientRequestURI",
						"EdgeEndTimestamp",
						"EdgeResponseBytes",
						"EdgeResponseStatus",
						"EdgeStartTimestamp",
						"RayID"
				],
				"timestamp_format": "unix"
		},
		"destination_conf": "https://log-api.newrelic.com/log/v1?Api-Key=<NR_LICENSE_KEY>&format=cloudflare",
		"max_upload_bytes": 5000000,
		"dataset": "http_requests",
		"enabled": true
	}'

Odpověď:

{
  "errors": [],
  "messages": [],
  "result": {
    "id": <JOB_ID>,
    "dataset": "http_requests",
    "kind": "",
    "max_upload_bytes": 5000000,
    "enabled": true,
    "name": "<DOMAIN_NAME>",
    "output_options": {
      "field_names": ["ClientIP", "ClientRequestHost", "ClientRequestMethod", "ClientRequestURI", "EdgeEndTimestamp","EdgeResponseBytes", "EdgeResponseStatus", "EdgeStartTimestamp", "RayID"],
      "timestamp_format": "unix"
    },
    "destination_conf": "https://log-api.newrelic.com/log/v1?Api-Key=<NR_LICENSE_KEY>&format=cloudflare",
    "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í).