## TL;DR

Check your self-hosted version (Admin > Stats or the install compose file) against the 26.4.2 floor. Upgrade self-hosted to the latest release (the docs recommend latest, not just the floor).

## Steps

1. You upgraded `@sentry/node` or `@sentry/browser` to v11 against a self-hosted Sentry older than 26.4.2. Symptoms are vague: traces incomplete, new span fields missing, odd ingestion errors. The docs say lower versions may continue to work, but are not supported, which in practice means partial breakage, not a clean failure.

2. v11 changed the wire format: span streaming sends spans in batches as they finish instead of one transaction payload at the end, `sendDefaultPii` became `dataCollection` with new categories, and attributes replaced tags on spans. An old server does not understand the new shapes.

3. Check your self-hosted version (Admin > Stats or the install compose file) against the 26.4.2 floor. If the SDK is v11 and the server is older, that is the problem regardless of which symptom you saw first.

4. Upgrade self-hosted to the latest release (the docs recommend latest, not just the floor). Until then, pin the SDK to v10.x, which the old server understands. Do not run a mixed fleet: v10 and v11 SDKs against the same old server produce inconsistent data that is painful to reconcile later.

5. Self-hosted does not ship the lazy-loadable JS SDK bundles by default, so the Sentry loader snippet renders a noop stub. Either set `SETUP_JS_SDK_ASSETS=1` in your self-hosted `.env` (available since 24.10.0) and configure the loader URL, or ship the npm bundle instead of the loader.

## When to use

You are seeing this: Symptoms are vague: traces incomplete, new span fields missing, odd ingestion errors. Use this skill when you run into "Sentry: v11 SDK against old self-hosted silently misbehaves".

## When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

## Versions

Versions mentioned in the source: 26.4.2, 24.10.0. If you are on something much newer or older, the details may have shifted.

## Why this happens

v11 changed the wire format: span streaming sends spans in batches as they finish instead of one transaction payload at the end, sendDefaultPii became dataCollection with new categories, and attributes replaced tags on spans.
