← Cloudflare Workers / workers / observability / logs
Logy v reálném čase
S Real-time logs máte přístup ke všem log events téměř v reálném čase, ať k nim dochází kdekoli na světě. Real-time logs se hodí pro okamžitou zpětnou vazbu, například o stavu nového nasazení.
Logy v reálném čase zachycují logy volání, vlastní protokoly, chyby a nezachycené výjimky. U aplikací s vysokým provozem mohou logy v reálném čase přejít do režimu vzorkování, což znamená, že některé zprávy budou zahozeny a v logu se zobrazí upozornění.
Zobrazit protokoly z dashboardu
Chcete-li v Cloudflare dashboardu zobrazit protokoly v reálném čase pro libovolný nasazený Worker:
-
V dashboardu Cloudflare přejděte na Workers & Pages stránce.
Přejděte na Workers & Pages ↗ -
V Přehled, vyberte svůj Worker.
-
Vyberte Protokoly.
-
V pravém navigačním panelu vyberte Naživo.
Zobrazit protokoly pomocí wrangler tail
Chcete-li pomocí Wrangler zobrazit protokoly v reálném čase pro libovolný nasazený Worker:
- Přejděte do adresáře projektu svého Workeru.
- Spustit
npx wrangler tail.
Tímto se v lokálním terminálu budou zaznamenávat všechny příchozí požadavky na vaši aplikaci.
Výstup každého wrangler tail log je strukturovaný objekt JSON:
{
"outcome": "ok",
"scriptName": null,
"exceptions": [],
"logs": [],
"eventTimestamp": 1590680082349,
"event": {
"request": {
"url": "https://www.bytesized.xyz/",
"method": "GET",
"headers": {},
"cf": {}
}
}
}Přesměrováním výstupu do nástrojů jako jq ↗, můžete požadavky prohledávat a upravovat a hledat v nich konkrétní informace:
npx wrangler tail | jq .event.request.url"https://www.bytesized.xyz/"
"https://www.bytesized.xyz/component---src-pages-index-js-a77e385e3bde5b78dbf6.js"
"https://www.bytesized.xyz/page-data/app-data.json"Můžete přizpůsobit, jak wrangler tail funguje tak, aby vyhovoval vašim potřebám. Viz wrangler tail dokumentace pro dostupné možnosti konfigurace.
Limity
- Logy v reálném čase neukládají Workers Logs. Pro ukládání logů použijte Workers Logs.
- Pokud má váš Worker vysoký objem provozu, logy v reálném čase mohou přejít do režimu vzorkování. To způsobí, že se některé zprávy zahodí a v logách se zobrazí varování.
- Protokoly z libovolného Durable Objects váš Worker používá, se zobrazí na dashboardu.
- Logy Workeru může sledovat najednou nejvýše 10 klientů, ať už jde o kombinaci relací dashboardu, nebo
wrangler tailvolání. - Při použití
wrangler tailhodnotou Obslužné rutiny událostí WebSocket, jakýkoliconsole.logpříkazy uvnitř těchto handlerů jsou skryté, dokud klient WebSocket spojení neuzavře. Jakmilecloseje přijato, všechny zprávy se vypíší najednou do terminálu.
Trvalé ukládání protokolů
Protokoly lze ukládat, filtrovat a analyzovat pomocí Workers Logs. Chcete-li odesílat logy třetí straně, použijte Workers Logpush nebo Tail Workers.
Související zdroje
- Chyby a výjimky - Projděte si běžné chyby Workers.
- Lokální vývoj - Vyvíjejte a testujte své Workers lokálně.
- Workers Logs : shromažďujte, ukládejte, filtrujte a analyzujte data logování odesílaná z Cloudflare Workers.
- Logpush - Zjistěte, jak odesílat Workers Trace Event Logs na podporovaná umístění.
- Tail Workers - Zjistěte, jak připojit Tail Workers k transformaci logů a jejich odesílání na HTTP endpointy.
- Zdrojové mapy a stack trace - Zjistěte, jak povolit source maps a generovat stack traces pro Workers.