← Cloudflare Workers / workers / observability

Экспорт данных OpenTelemetry

Cloudflare Workers поддерживает экспорт данных телеметрии, совместимых с OpenTelemetry (OTel), в любое место назначения с доступной конечной точкой OTel, что позволяет интегрироваться с уже используемым стеком мониторинга и наблюдаемости.

Можно экспортировать следующие типы телеметрических данных:

• Трассировки - Трассировки, показывающие прохождение запросов через ваш Worker и подключённые сервисы
• Журналы - логи приложения, включая console.log() вывод и системные логи

Примечание: экспорт метрик Worker и пользовательских метрик пока не поддерживается.

Ниже приведены распространённые форматы конечных точек OTLP для популярных провайдеров observability. За подробностями и требованиями к аутентификации обращайтесь к документации своего провайдера.

Чтобы начать отправлять данные в назначение, сначала создайте его в дашборде Cloudflare.

1. Перейдите в раздел вашего аккаунта Workers Observability ↗ раздел панели управления
2. Нажмите «Добавить назначение».
3. Настройте назначение:
   • Имя назначения - описательное имя (например, «Grafana-tracing», «Honeycomb-Logs»)
   • Тип назначения - выберите между «Traces» и «Logs»
   • OTLP Endpoint - URL, по которому ваша платформа наблюдаемости принимает данные OTLP.
   • Пользовательские заголовки (необязательно): любые заголовки аутентификации или другие заголовки, требуемые провайдером
4. Сохраните пункт назначения

После настройки назначений в панели управления настройте Worker для экспорта данных телеметрии, обновив конфигурацию Wrangler. Имя назначения в файле конфигурации должно совпадать с именем назначения, настроенным в панели управления.

{
	"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

После настройки конфигурационного файла Wrangler повторно разверните Worker, чтобы новые настройки вступили в силу. Обратите внимание, что событиям может потребоваться несколько минут, чтобы достичь места назначения.

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

Экспорт данных OTel в настоящее время бесплатно пользователям с подпиской Workers Paid или выше на раннем этапе бета-периода. Однако начиная с October 1, 2026, трассировка будет тарифицироваться как часть использования по плану Workers Paid или по контракту.

Сюда входят следующие лимиты и цены:

Экспорт данных OpenTelemetry сейчас находится в бета-версии. Обратите внимание на следующие ограничения:

• Экспорт метрик пока не поддерживается: Экспорт инфраструктурных и пользовательских метрик Worker через OpenTelemetry пока недоступен. Мы активно работаем над поддержкой метрик в будущем.
• Ограниченная поддержка OTLP у некоторых провайдеров: Некоторые провайдеры observability пока постепенно внедряют поддержку OTLP endpoint. Проверьте Доступные назначения OpenTelemetry таблицу выше, чтобы узнать текущую доступность.