← Cloudflare Workers / workers / observability

Trasování

Trasování vám poskytuje ucelený přehled o průběhu požadavku od začátku do konce, jak prochází vaší aplikací Workers a navazujícími službami. Díky tomu můžete odhalit úzká místa výkonu, ladit chyby a porozumět složitým tokům požadavků. S trasováním můžete zodpovědět otázky jako:

• Co způsobuje dlouho běžící požadavek?
• Jak dlouho trvají subrequesty z mého Workeru?
• Jak dlouho trvají moje volání do KV Namespace nebo R2 bucket?

Cloudflare Workers poskytuje instrumentaci trasování bez nutnosti další konfigurace, no code changes or SDK are required. Simply enable tracing on your Worker and Cloudflare automatically captures telemetry data for:

• Volání fetch : všechny odchozí HTTP požadavky, včetně časování, stavových kódů a metadat požadavku. Díky tomu rychle zjistíte, jak externí závislosti ovlivňují výkon vaší aplikace.
• Volání přes binding : interakce s různými bindingy Workeru, jako jsou čtení a zápisy KV, operace s objektovým úložištěm R2 a volání Durable Object.
• Volání handleru : kompletní životní cyklus každého volání Workeru, včetně triggerů jako obslužné rutiny fetch, naplánované handlery, a queue handlers.

Úplný seznam instrumentovaných operací najdete v dokumentace ke spanům a atributům.

Pro trasování logiky specifické pro aplikaci si také můžete vytvořit vlastní spany. Vlastní spany se automaticky vnořují do vestavěné instrumentace, což vám poskytuje kompletní přehled jak nad operacemi platformy, tak nad vaším vlastním kódem.

Další informace najdete v tématu Vlastní spany.

Trasování můžete nakonfigurovat nastavením observability.traces.enabled = true ve vašem Konfigurační soubor Wrangler.

{
	"observability": {
		"traces": {
			"enabled": true,
			// optional sampling rate (recommended for high-traffic workloads)
			"head_sampling_rate": 0.05
		}
	}
}

[observability.traces]
enabled = true
head_sampling_rate = 0.05

Trasování Workers se řídí standardy OpenTelemetry (OTel) ↗. Díky tomu je kompatibilní s oblíbenými platformami pro observabilitu, jako je Honeycomb, Grafana Cloud, a Axiom, aniž byste museli vyvinout jakékoli úsilí. Pokud váš poskytovatel observability nabízí dostupný endpoint OpenTelemetry, můžete exportovat trasování (a protokoly)!

Můžete také nastavit persist: false abyste exportovali trasování do svého cíle, aniž by se ukládalo v Cloudflare dashboardu. Díky tomu můžete jako jediný cíl pro trasování použít observabilitu třetí strany.

Zjistěte více o exportu dat OpenTelemetry z Workers zde.

Se samplingem můžete trasovat procento příchozích požadavků ve vašem Cloudflare Workeru. Díky tomu můžete řídit objem a náklady a přitom stále získávat užitečné poznatky o vaší aplikaci.

Platný rozsah vzorkování je od 0 na 1, kde 0 znamená, že se nebude trasovat žádné z jednoho sta vyvolání, a 1 znamená, že se budou trasovat všechny požadavky, a číslo jako 0.05 znamená, že se bude trasovat pět ze sta požadavků.

Pokud jste nezadali sampling rate, výchozí hodnota je 1, což znamená, že bude trasováno 100 % požadavků.

{
	"observability": {
		"traces": {
			"enabled": true,
			// set tracing sampling rate to 5%
			"head_sampling_rate": 0.05
		},
		"logs": {
			"enabled": true,
			// set logging sampling rate to 60%
			"head_sampling_rate": 0.6
		}
	}
}

[observability.traces]
enabled = true
head_sampling_rate = 0.05

[observability.logs]
enabled = true
head_sampling_rate = 0.6

Pokud máte head_sampling_rate nakonfigurováno pro logy, můžete vytvořit samostatnou sazbu i pro trasování.

Vzorkování je založené na začátku ↗, což znamená, že u netrasovaných požadavků nevzniká žádná režie spojená s trasováním.

Trasování Workers je aktuálně zdarma během počáteční beta fáze. To zahrnuje veškerou funkcionalitu trasování, jako je shromažďování trasování, jejich ukládání a zobrazování na řídicím panelu Cloudflare.

Od 1. října 2026 bude trasování účtováno jako součást vašeho využití v plánech Workers Free, Paid a Enterprise. Každý span v trasování představuje jednu událost observability se stejnou měsíční kvótou a cenou jako protokoly Workers: