getsentry · JPeer264 · Aug 13, 2026 · Aug 12, 2026 · Aug 12, 2026 · Aug 12, 2026
diff --git a/MIGRATION.md b/MIGRATION.md
@@ -745,8 +745,6 @@ Sentry.init({
   );
 ```
 
-- The `enableRpcTracePropagation` option now defaults to `true`. Trace context is propagated across RPC calls (service bindings, Durable Objects, WorkerEntrypoints) unless you explicitly set `enableRpcTracePropagation: false`.
-
 - The `instrumentPrototypeMethods` option of `instrumentDurableObjectWithSentry` was removed. Use `enableRpcTracePropagation` instead, which was introduced as its replacement in v10.
 
 ```diff

@@ -18,7 +18,6 @@ export const MyDurableObject = Sentry.instrumentDurableObjectWithSentry(
     dsn: env.SENTRY_DSN,
     traceLifecycle: 'static',
     tracesSampleRate: 1.0,
-    enableRpcTracePropagation: false,
   }),
   MyDurableObjectBase,
 );
@@ -28,7 +27,6 @@ export default Sentry.withSentry(
     dsn: env.SENTRY_DSN,
     traceLifecycle: 'static',
     tracesSampleRate: 1.0,
-    enableRpcTracePropagation: false,
   }),
   {
     async fetch(request, env) {

@@ -21,7 +21,6 @@ export const MyDurableObject = Sentry.instrumentDurableObjectWithSentry(
     dsn: env.SENTRY_DSN,
     traceLifecycle: 'static',
     tracesSampleRate: 1.0,
-    enableRpcTracePropagation: false,
   }),
   MyDurableObjectBase,
 );
@@ -31,7 +30,6 @@ export default Sentry.withSentry(
     dsn: env.SENTRY_DSN,
     traceLifecycle: 'static',
     tracesSampleRate: 1.0,
-    enableRpcTracePropagation: false,
   }),
   {
     async fetch(request, env) {

@@ -62,7 +62,6 @@ export const NoPropagationEntrypoint = Sentry.withSentry(
     dsn: env.SENTRY_DSN,
     traceLifecycle: 'static',
     tracesSampleRate: 1.0,
-    enableRpcTracePropagation: false,
     transportOptions: { fetch: fetch.bind(globalThis) },
   }),
   MySubWorkerEntrypointBase,

@@ -20,12 +20,7 @@ class LoopbackEntrypointBase extends WorkerEntrypoint<Env> {
 }
 
 export const LoopbackEntrypoint = Sentry.withSentry(
-  (env: Env) => ({
-    dsn: env.SENTRY_DSN,
-    traceLifecycle: 'static',
-    tracesSampleRate: 0,
-    enableRpcTracePropagation: false,
-  }),
+  (env: Env) => ({ dsn: env.SENTRY_DSN, traceLifecycle: 'static', tracesSampleRate: 0 }),
   LoopbackEntrypointBase,
 );
 

@@ -21,7 +21,6 @@ export const MyDurableObject = Sentry.instrumentDurableObjectWithSentry(
     dsn: env.SENTRY_DSN,
     traceLifecycle: 'static',
     tracesSampleRate: 1.0,
-    enableRpcTracePropagation: false,
   }),
   MyDurableObjectBase,
 );
@@ -47,7 +46,6 @@ export default Sentry.withSentry(
     dsn: env.SENTRY_DSN,
     traceLifecycle: 'static',
     tracesSampleRate: 1.0,
-    enableRpcTracePropagation: false,
   }),
   MyWorkerEntrypointBase,
 );
@@ -200,20 +200,34 @@ interface BaseCloudflareOptions {
    * - Create spans for each RPC method invocation
    * - Capture errors thrown by RPC methods
    *
-   * **Important:** This option is enabled by default. Set it to `false` to opt out, e.g. if you
-   * do not want trace context to leave your Worker via RPC calls.
+   * **Important:** This option should be enabled on **both sides** for full trace propagation.
    *
-   * @default true
+   * @default false
    * @example
    * ```ts
-   * // Opt out of RPC trace propagation
+   * // Worker side (caller)
    * export default Sentry.withSentry(
    *   (env) => ({
    *     dsn: env.SENTRY_DSN,
-   *     enableRpcTracePropagation: false,
+   *     enableRpcTracePropagation: true,
    *   }),
    *   handler,
    * );
+   *
+   * // Durable Object side (receiver)
+   * export const MyDO = Sentry.instrumentDurableObjectWithSentry(
+   *   (env) => ({
+   *     dsn: env.SENTRY_DSN,
+   *     enableRpcTracePropagation: true,
+   *   }),
+   *   MyDOBase,
+   * );
+   *
+   * // WorkerEntrypoint side (receiver)
+   * export const MyEntrypoint = Sentry.withSentry(
+   *   env => ({ dsn: env.SENTRY_DSN, enableRpcTracePropagation: true }),
+   *   MyEntrypointBase,
+   * );
    * ```
    */
   enableRpcTracePropagation?: boolean;

@@ -274,8 +274,8 @@ export function finalizeWithRpcInstrumentation<T extends object>(
   context: InstrumentedDurableObjectContext,
   excludedMethods?: ReadonlySet<string>,
 ): T {
-  // Skip RPC instrumentation only when explicitly opted out (enabled by default)
-  if (options.enableRpcTracePropagation === false) {
+  // Skip RPC instrumentation if not enabled
+  if (!options.enableRpcTracePropagation) {
     return obj;
   }
 
@@ -403,8 +403,7 @@ function createRpcPrototypeWrapper(methodName: string, originalMethod: Unchecked
  * - webSocketClose
  * - webSocketError
  *
- * RPC methods (prototype methods) are instrumented by default. Set `enableRpcTracePropagation`
- * to `false` to opt out.
+ * To instrument RPC methods (prototype methods), enable the `enableRpcTracePropagation` option.
  *
  * @param optionsCallback Function that returns the options for the SDK initialization.
  * @param DurableObjectClass The Durable Object class to instrument.
@@ -483,6 +482,7 @@ export function instrumentDurableObjectWithSentry<
  *   env => ({
  *     dsn: env.SENTRY_DSN,
  *     tracesSampleRate: 1.0,
+ *     enableRpcTracePropagation: true,
  *   }),
  *   MyAgentBase,
  * );

@@ -94,7 +94,7 @@ function instrumentMethod(
     true,
   );
 
-  if (options.enableRpcTracePropagation === false) {
+  if (!options.enableRpcTracePropagation) {
     return captureMethod;
   }
 

@@ -91,7 +91,7 @@ export function instrumentEnv<Env extends Record<string, unknown>>(env: Env, opt
         return instrumented;
       }
 
-      if (options?.enableRpcTracePropagation === false) {
+      if (!options?.enableRpcTracePropagation) {
         return item;
       }
 

@@ -317,37 +317,20 @@ describe('instrumentDurableObjectWithSentry', () => {
     expect(getInstrumented(obj.alarm)).toBeTruthy();
   });
 
-  it('Does not instrument RPC methods when enableRpcTracePropagation is false', () => {
+  it('Does not instrument RPC methods when enableRpcTracePropagation is not set', () => {
     const testClass = class {
       rpcMethod() {
         return 'result';
       }
     };
-    const instrumented = instrumentDurableObjectWithSentry(
-      vi.fn().mockReturnValue({ enableRpcTracePropagation: false }),
-      testClass as any,
-    );
+    const instrumented = instrumentDurableObjectWithSentry(vi.fn().mockReturnValue({}), testClass as any);
     const obj = Reflect.construct(instrumented, []);
 
     // RPC method should not be wrapped
     expect(getInstrumented(obj.rpcMethod)).toBeFalsy();
     expect(obj.rpcMethod()).toBe('result');
   });
 
-  it('instruments RPC methods by default when enableRpcTracePropagation is not set', () => {
-    const testClass = class {
-      rpcMethod() {
-        return 'result';
-      }
-    };
-    const instrumented = instrumentDurableObjectWithSentry(vi.fn().mockReturnValue({}), testClass as any);
-    const obj = Reflect.construct(instrumented, []);
-
-    // RPC method should be wrapped on the prototype by default
-    expect(getInstrumented(obj.rpcMethod)).toBeTruthy();
-    expect(obj.rpcMethod()).toBe('result');
-  });
-
   it('skips non-configurable prototype methods instead of failing construction', () => {
     const testClass = class {
       sealedMethod() {

@@ -82,28 +82,13 @@ describe('instrumentEnv', () => {
       newUniqueId: vi.fn(),
     };
     const env = { COUNTER: doNamespace };
-    const instrumented = instrumentEnv(env, { enableRpcTracePropagation: false });
+    const instrumented = instrumentEnv(env);
 
     // DO bindings pass through untouched when RPC propagation is disabled
     expect(instrumented.COUNTER).toBe(doNamespace);
     expect(instrumentDurableObjectNamespace).not.toHaveBeenCalled();
   });
 
-  it('detects and instruments DurableObjectNamespace bindings by default', () => {
-    const doNamespace = {
-      idFromName: vi.fn(),
-      idFromString: vi.fn(),
-      get: vi.fn(),
-      newUniqueId: vi.fn(),
-    };
-    const env = { COUNTER: doNamespace };
-    const instrumented = instrumentEnv(env, {});
-
-    const result = instrumented.COUNTER;
-    expect(instrumentDurableObjectNamespace).toHaveBeenCalledWith(doNamespace);
-    expect((result as any).__instrumented).toBe(true);
-  });
-
   it('detects and instruments DurableObjectNamespace bindings when enableRpcTracePropagation is enabled', () => {
     const doNamespace = {
       idFromName: vi.fn(),
@@ -175,7 +160,7 @@ describe('instrumentEnv', () => {
       },
     );
     const env = { SERVICE: jsrpcProxy };
-    const instrumented = instrumentEnv(env, { enableRpcTracePropagation: false });
+    const instrumented = instrumentEnv(env);
 
     const result = instrumented.SERVICE;
     // Should be the same reference — not wrapped when propagation is disabled
@@ -361,7 +346,7 @@ describe('instrumentEnv', () => {
       const mockFetch = vi.fn();
       const mtlsFetcher = createMtlsFetcherProxy(mockFetch);
       const env = { MY_CERT: mtlsFetcher };
-      const instrumented = instrumentEnv(env, { enableRpcTracePropagation: false });
+      const instrumented = instrumentEnv(env);
 
       expect(instrumented.MY_CERT).toBe(mtlsFetcher);
     });
@@ -393,7 +378,7 @@ describe('instrumentEnv', () => {
   });
 
   describe('JSRPC RPC method instrumentation', () => {
-    it('does not inject Sentry RPC meta when enableRpcTracePropagation is disabled', () => {
+    it('does not inject Sentry RPC meta by default (enableRpcTracePropagation not set)', () => {
       vi.spyOn(SentryCore, 'getTraceData').mockReturnValue({
         'sentry-trace': '12345678901234567890123456789012-1234567890123456-1',
         baggage: 'sentry-environment=production',
@@ -412,11 +397,11 @@ describe('instrumentEnv', () => {
         },
       );
       const env = { SERVICE: jsrpcProxy };
-      const instrumented = instrumentEnv(env, { enableRpcTracePropagation: false });
+      const instrumented = instrumentEnv(env);
 
       instrumented.SERVICE.myRpcMethod('arg1', 42);
 
-      // With enableRpcTracePropagation disabled, no metadata should be injected
+      // Without enableRpcTracePropagation, no metadata should be injected
       expect(rpcMethod).toHaveBeenCalledWith('arg1', 42);
     });
-Original file line number
+Diff line change
@@ Expand Up / @@ -745,8 +745,6 @@ Sentry.init({ @@
       );
     ```
-    - The `enableRpcTracePropagation` option now defaults to `true`. Trace context is propagated across RPC calls (service bindings, Durable Objects, WorkerEntrypoints) unless you explicitly set `enableRpcTracePropagation: false`.
     - The `instrumentPrototypeMethods` option of `instrumentDurableObjectWithSentry` was removed. Use `enableRpcTracePropagation` instead, which was introduced as its replacement in v10.
     ```diff
@@ Expand Down @@