feat(logs,metrics,spans): Add settings object spec for envelope item container

[Lms24]

This PR adds a specification for ingestion settings of what data Relay should infer from incoming requests. This object shall be the same across our new telemetry items (logs, metrics and spans (v2)) and it lives on the container object:

{
  "version": 2,
  "items": [...],
  "ingest_settings": {
    "infer_ip:": "auto",
    "infer_useragent:": "auto",
  }
}

This shall serve as a replacement for the settings property on the sdk object on events as defined here.
I went with the same 'auto' and 'never' values but omitted 'legacy' since it doesn't seem like we need it. If reviewers prefer, we can also use a boolean instead, assuming we never need more than two states.

For backwards compatibility, this also introduces a version field which must be set to at least 2 for ingest_settings to take effect.

Prior to this PR, @cleptric @Dav1dde and I discussed this format. Happy to adjust as reviewers see fit!

ref https://linear.app/getsentry/issue/FE-714/how-to-send-sdksettings-infer-ip

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
develop-docs	Ready	Preview, Comment	Apr 7, 2026 0:48am

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
sentry-docs	Ignored	Preview	Apr 7, 2026 0:48am

[Lms24]

spans docs are not yet converted to the changelog-based SpecSection format. Hence for now I added the component but set version 0.0.0.

[linear-code]

FE-714 How to send `sdk.settings` (`.infer_ip`)

[Dav1dde]

Looks good to me, but maybe we wanna bike-shed some more on the namings.

We also need to figure out how this works for logs and the existing extractions, I want to make sure we don't build more special cases.

It also has potential billing impact for logs, as these are billed by size (before extraction).

[jjbayer]

Discussed with @Dav1dde : We should introduce a top level version field in the item JSON that informs relay what to do with logs:

• version: 1 is the default. For logs, Relay automatically assumes infer_ip: auto (legacy behavior).
• New SDK versions set version: 2. Relay assumes infer_ip: never as the default.

Without the version field, we'd have to make infer_ip: auto the default, which would force new SDKs to explicitly send infer_ip: never to disable it.

[Lms24]

@jjbayer to confirm, you'd envision this?

{
  "version": 2,
  "items": [...],
  "settings": {
    "infer_ip:": "auto",
    "infer_useragent:": "auto",
  }
}

Happy to add it!

[jjbayer]

Yes please!

[Lms24]

@Dav1dde

but maybe we wanna bike-shed some more on the namings.

sure, anything that comes to mind? I think ingest_settings was on the table yesterday, which is more explicit and communicates intent more clearly. Happy to change it to that.

Also,

I went with the same 'auto' and 'never' values but omitted 'legacy' since it doesn't seem like we need it. If reviewers prefer, we can also use a boolean instead, assuming we never need more than two states.

we can "do better" with this second attempt, though tbh this is LOGAF-L for me (bundle size differences are negligible).

[coolguyzone]

Looks good! Thanks for updating

[Lms24]

@cleptric @jjbayer apologies for the delay! I made the following changes as discussed:

• added version property and specified that SDKs must set it to 2 or higher for Relay to apply the settings
• renamed settings -> ingest_settings to more clearly communicate the intent

Happy to make more adjustments if necessary!