← Cloudflare Workers / workers / observability / logs

Логи в реальном времени

С помощью Real-time logs вы получаете доступ ко всем событиям логов практически в реальном времени, где бы они ни происходили. Real-time logs полезны для мгновенной обратной связи, например для отслеживания статуса нового deployment.

Логи в реальном времени фиксируют журналы вызовов, пользовательские логи, ошибках и необработанных исключениях. Для приложений с высокой нагрузкой логи в реальном времени могут переключаться в режим выборки: часть сообщений будет отбрасываться, а в логах появится предупреждение.

Чтобы просматривать логи в реальном времени для любого развёрнутого Worker через дашборд Cloudflare:

1. На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.

   Перейдите в Workers & Pages ↗

2. В Обзор, выберите свой Worker.

3. Выберите Журналы.

4. В правой панели навигации выберите Live.

Чтобы просматривать логи в реальном времени для любого развёрнутого Worker с помощью Wrangler:

1. Перейдите в каталог проекта Worker.
2. Запустите npx wrangler tail.

Это будет выводить все входящие запросы к вашему приложению в локальном терминале.

Вывод каждого wrangler tail лог представляет собой структурированный объект JSON:

{
	"outcome": "ok",
	"scriptName": null,
	"exceptions": [],
	"logs": [],
	"eventTimestamp": 1590680082349,
	"event": {
		"request": {
			"url": "https://www.bytesized.xyz/",
			"method": "GET",
			"headers": {},
			"cf": {}
		}
	}
}

Перенаправив вывод в такие инструменты, как jq ↗, вы можете запрашивать и изменять запросы, чтобы найти нужную информацию:

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"

Можно настроить, как wrangler tail настраивается под ваши потребности. См. wrangler tail документация о доступных параметрах конфигурации.

• Логи в реальном времени не сохраняют Workers Logs. Чтобы сохранить логи, используйте Workers Logs.
• Если у вашего Worker высокая нагрузка трафика, логи в реальном времени могут перейти в режим сэмплирования. Из-за этого часть сообщений будет отброшена, а в логах появится предупреждение.
• Логи из любого Durable Objects использует ваш Worker, будут отображаться в дашборде.
• Логи Worker могут одновременно просматривать не более 10 клиентов: это могут быть сессии Dashboard или wrangler tail вызовы.
• При использовании wrangler tail с Обработчики событий WebSocket, любой console.log инструкции внутри этих обработчиков скрыты, пока клиент WebSocket не закроет соединение. После того как close получен, все сообщения сбрасываются и сразу выводятся в терминал.

Логи можно сохранять, фильтровать и анализировать с помощью Workers Logs. Чтобы отправлять логи стороннему сервису, используйте Workers Logpush или Tail Workers.

• Ошибки и исключения - Ознакомьтесь с распространёнными ошибками Workers.
• Локальная разработка - Разрабатывайте и тестируйте Workers локально.
• Workers Logs - собирайте, храните, фильтруйте и анализируйте данные логирования, поступающие от Cloudflare Workers.
• Logpush - Узнайте, как отправлять Workers Trace Event Logs в поддерживаемые получатели.
• Tail Workers - Узнайте, как подключить Tail Workers для преобразования логов и отправки их на HTTP-эндпоинты.
• Source maps и трассировки стека - Узнайте, как включить source maps и генерировать трассировки стека для Workers.