← Cloudflare Workers / workers / observability

Export dat OpenTelemetry

Cloudflare Workers umožňuje exportovat telemetrická data kompatibilní s OpenTelemetry (OTel) do libovolného cíle s dostupným OTel endpointem, což vám umožní integraci se stávajícím monitorovacím a observabilitním nástrojem.

Můžete exportovat tyto typy telemetrických dat:

• Trasování - Trasy zobrazující průběh požadavků přes váš Worker a připojené služby
• Protokoly : logy aplikace včetně console.log() výstup a logy generované systémem

Poznámka: export metrik Workeru a vlastních metrik zatím není podporován.

Níže jsou uvedeny běžné formáty koncových bodů OTLP pro oblíbené poskytovatele observability. Konkrétní podrobnosti a požadavky na autentizaci najdete v dokumentaci svého poskytovatele.

Chcete-li začít odesílat data do cíle, musíte nejprve v Cloudflare dashboardu vytvořit cíl.

1. Přejděte do sekce svého účtu Workers Observability ↗ sekci dashboardu
2. Klikněte na tlačítko add destination.
3. Nakonfigurujte svůj cíl:
   • Název cíle : popisný název (např. „Grafana-tracing“, „Honeycomb-Logs“)
   • Typ cíle : vyberte mezi možnostmi „Traces“ nebo „Logs“
   • OTLP Endpoint - URL, na které vaše platforma pro observabilitu přijímá data OTLP.
   • Vlastní hlavičky (Volitelné) - Veškeré autentizační hlavičky nebo jiné hlavičky vyžadované poskytovatelem
4. Uložte cíl

Po nastavení cílů v dashboardu nakonfigurujte Worker tak, aby exportoval telemetrická data, a to úpravou konfigurace Wrangler. Název cíle nastavený v konfiguračním souboru by měl odpovídat názvu cíle nastavenému v dashboardu.

{
	"observability": {
		"traces": {
			"enabled": true,
			"destinations": ["tracing-destination-name"],

			// traces sample rate of 5%
			"head_sampling_rate": 0.05,

			// (optional) set to false to only export traces to your
			// destination without persisting them in the Cloudflare dashboard
			"persist": false
		},
		"logs": {
			"enabled": true,
			"destinations": ["logs-destination-name"],
			// logs sample rate of 60%
			"head_sampling_rate": 0.6,

			// (optional) set to false to only export logs to your
			// destination without persisting them in the Cloudflare dashboard
			"persist": false
		}
	}
}

[observability.traces]
enabled = true
destinations = [ "tracing-destination-name" ]
head_sampling_rate = 0.05
persist = false

[observability.logs]
enabled = true
destinations = [ "logs-destination-name" ]
head_sampling_rate = 0.6
persist = false

Jakmile nakonfigurujete konfigurační soubor Wrangleru, znovu nasaďte Worker, aby se nové nastavení projevilo. Mějte na paměti, že doručení událostí do cíle může trvat několik minut.

Po vytvoření cíle můžete sledovat jeho stav a stav doručování v Cloudflare dashboardu. U každého cíle se zobrazuje indikátor stavu, který ukazuje, jak nedávno byla data úspěšně doručena.

Export dat OTel je aktuálně zdarma uživatelům, kteří mají momentálně předplatné Workers Paid nebo vyšší, a to v rámci raného beta období. Nicméně od October 1, 2026, trasování bude účtováno jako součást vašeho využití v rámci plánu Workers Paid nebo smlouvy.

Zahrnuje to následující limity a ceny:

Export dat OpenTelemetry je aktuálně ve verzi beta. Mějte na paměti následující omezení:

• Export metrik zatím není podporován: Export metrik infrastruktury Workeru a vlastních metrik přes OpenTelemetry zatím není k dispozici. Aktivně pracujeme na tom, abychom podporu metrik v budoucnu přidali.
• Omezená podpora OTLP u některých poskytovatelů: Někteří poskytovatelé observability stále postupně zavádějí podporu OTLP endpointu. Zkontrolujte Dostupné cíle OpenTelemetry tabulce výše, kde najdete aktuální dostupnost.