2026-04 Storefront Cloudflare Observability export 要件¶

背景¶

Storefront は browser 側で @sentry/react を使い、error / Replay / feedback を Sentry へ送っている。
一方で Cloudflare Workers 上の runtime telemetry は、Cloudflare native spans / logs をそのまま使った方が運用上の相性が良い。
Cloudflare Workers Observability は OTel destination 経由で Sentry へ traces / logs を export できるため、Storefront Worker runtime の配送面はこちらを正本とする。

合意事項¶

browser と Worker runtime を分ける
Storefront browser の error / Replay / feedback は引き続き @sentry/react を使う。
Storefront Worker entrypoint は @sentry/cloudflare の withSentry(...) でラップし、Worker runtime の unhandled error / tracing を捕捉する。
Storefront Worker runtime の traces / logs は Cloudflare Workers Observability OTLP export を使う。
repo 管理の正本
repo 内の正本は apps/storefront/wrangler.toml の observability.logs.destinations / observability.traces.destinations とする。
destination 自体の OTLP endpoint / auth header は Cloudflare dashboard で管理し、repo には保存しない。
destination 名
production:
- ritsubi-storefront-sentry-logs
- ritsubi-storefront-sentry-traces
staging:
- ritsubi-storefront-staging-sentry-logs
- ritsubi-storefront-staging-sentry-traces
preview:
- ritsubi-storefront-preview-sentry-logs
- ritsubi-storefront-preview-sentry-traces
mock:
- ritsubi-storefront-mock-sentry-logs
- ritsubi-storefront-mock-sentry-traces
sampling
production の Worker runtime logs / traces は head sampling rate 0.1 を既定とする。
staging / preview / mock は切り分け優先のため 0.5 を既定とする。
運用上の扱い
Storefront の deploy / release / sourcemap / browser diagnostics は既存の Sentry release 運用を継続してよい。
今回の変更では browser SDK を @sentry/react、Worker SDK を @sentry/cloudflare に分離し、Worker runtime telemetry の配送経路は Cloudflare Observability を正本とする。

完了条件¶

apps/storefront/wrangler.toml に environment ごとの logs / traces destination 名が定義されていること。
docs/infrastructure-and-environment.md と docs/03-implementation/infrastructure/monitoring-operations.md が、Storefront browser は @sentry/react、Worker runtime は @sentry/cloudflare + Cloudflare Observability export という構成を説明していること。