← Cloudflare Workers / workers / observability / traces

Известные ограничения

Трассировка Workers сейчас находится в открытой бета-версии. На этой странице описаны текущие ограничения и функции, запланированные в дорожной карте.

Чтобы оставить отзыв или предложить новую функцию, перейдите в Обсуждение трассировки Workers на GitHub ↗.

Операции, не связанные с вводом-выводом, могут показывать время 0 мс

Из-за меры безопасности, принятые для предотвращения атак Spectre, среда выполнения Workers не обновляет время до наступления событий ввода-вывода. Это значит, что у некоторых спанов длительность будет равна 0 ms даже если операция заняла больше времени.

Команда Cloudflare Workers изучает меры безопасности, которые позволили бы в этих случаях раскрывать длительность с точностью до миллисекунды.

Распространение контекста трассировки на внешние сервисы

При экспорте трасс на внешние платформы идентификаторы трасс (trace ID) не передаются в сервисы за пределами Cloudflare. Это означает, что трассы ваших Workers не будут связаны с трассами сторонних сервисов в инструментах observability.

Мы работаем над автоматическим распространением контекста трассировки с помощью Стандарты W3C Trace Context ↗, что обеспечит полную сквозную видимость по всем вашим существующим инструментам и сервисам.

Атрибуты незавершённых спанов

Мы планируем добавить более подробные атрибуты для каждого спана. Полный список уже инструментированных элементов можно найти здесь.

Ваши отзывы о недостающей информации помогут нам расставить приоритеты в дополнениях и изменениях. Оставьте комментарий в Обсуждение трассировки Workers на GitHub ↗ если для эффективного использования трассировки полезны определённые атрибуты.

Имена span и атрибутов могут измениться

Поскольку трассировка Workers сейчас находится в бета-версии, названия span и атрибутов ещё не окончательны. В течение бета-периода мы можем уточнять эти названия, чтобы повысить ясность и привести их в соответствие с семантическими соглашениями OpenTelemetry. Рекомендуем ознакомиться с документация по spans и attributes периодически для проверки обновлений.

Известные ошибки и другие важные замечания

На данный момент существует несколько атрибутов, которые применяются только к отдельным спанам (например,service.name, faas.name). При фильтрации или группировке по имени Worker в трассировках и журналах используйте $metadata.service вместо этого, так как он будет применяться единообразно ко всем типам событий.
Пока трассировка выполняется, событие будет показывать Trace in Progress для корневого спана. Подождите немного, пока полная трассировка станет доступна