Add sample rate to baggage as well as trace in envelope header and flatten user - #2135

Merged
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage
Jul 1, 2022
Merged

Add sample rate to baggage as well as trace in envelope header and flatten user#2135
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage

Conversation

@adinauer

@adinaueradinauer commented Jun 24, 2022

Copy link
Copy Markdown
Member

📜 Description

Add sample rate to baggage header as well as trace in envelope header.
Flatten user into user_id and user_segment for trace in envelope header.

💡 Motivation and Context

To allow for dynamic sampling and align with docs / other SDKs: getsentry/develop#613

💚 How did you test it?

📝 Checklist

  • I reviewed the submitted code
  • I added tests to verify the changes
  • I updated the docs if needed
  • No breaking changes

🔮 Next steps

@adinauer

Copy link
Copy Markdown
MemberAuthor

@AbhiPrasad@lforst@Lms24 can any of you please leave a review, once you feel the docs are ready to make sure this aligns?

@codecov-commenter

codecov-commenter commented Jun 24, 2022

Copy link
Copy Markdown

Codecov Report

Merging #2135 (1170cc7) into main (413862e) will decrease coverage by 0.01%.
The diff coverage is 85.80%.

@@ Coverage Diff @@## main #2135 +/- ##
============================================
- Coverage 80.95% 80.94% -0.02% - Complexity 3257 3290 +33 
============================================
Files 231 233 +2 Lines 11964 12044 +80 Branches 1589 1594 +5 ============================================
+ Hits 9686 9749 +63 - Misses 1698 1712 +14 - Partials 580 583 +3 
Impacted FilesCoverage Δ
...entry/src/main/java/io/sentry/NoOpTransaction.java25.00% <0.00%> (-0.81%)⬇️
sentry/src/main/java/io/sentry/OutboxSender.java65.64% <64.70%> (-0.74%)⬇️
...ry/src/main/java/io/sentry/TransactionContext.java85.71% <71.42%> (-14.29%)⬇️
...ain/java/io/sentry/protocol/SentryTransaction.java88.97% <75.00%> (-0.28%)⬇️
sentry/src/main/java/io/sentry/SpanContext.java83.94% <76.92%> (-0.68%)⬇️
...y/src/main/java/io/sentry/util/SampleRateUtil.java88.88% <88.88%> (ø)
sentry/src/main/java/io/sentry/TraceContext.java86.74% <90.90%> (-0.01%)⬇️
sentry/src/main/java/io/sentry/Baggage.java89.41% <100.00%> (+0.25%)⬆️
sentry/src/main/java/io/sentry/Hub.java76.41% <100.00%> (ø)
sentry/src/main/java/io/sentry/SentryOptions.java82.03% <100.00%> (ø)
... and 5 more

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 413862e...1170cc7. Read the comment docs.

}

public void setSampleRate(final @Nullable String sampleRate) {
set("sentry-samplerate", sampleRate);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We decided to make baggage and envelope header key names identical (except for the sentry- prefix in baggage keys) so that we're able to just dump the DSC data into both transport mechanisms without any mapping. (Linking to the preview here for more details)

Therefore, we should change the snake case keys to underscores (like in the example below)

Suggested change
set("sentry-samplerate", sampleRate);
set("sentry-sample_rate", sampleRate);

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does that also mean

  • sentry-publickey becomes sentry-public_key
  • sentry-traceid becomes sentry_trace_id
  • sentry-userid becomes sentry-user_id
  • sentry-usersegment becomes sentry-user_segment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, exactly

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • sentry-traceid becomes sentry_trace_id

It becomes sentry-trace_id, but that probably just was a typo ^^

@adinaueradinauerJun 27, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK thanks, will update.
Yeah just a typo on the _ there.

@adinaueradinauer mentioned this pull request Jun 28, 2022
4 tasks
@adinauer
adinauer marked this pull request as ready for review June 29, 2022 08:25
@adinauer
adinauer requested a review from romtsn as a code ownerJune 29, 2022 08:25
Comment threadCHANGELOG.md Outdated
Comment on lines +9 to +13
## Unreleased

### Features

- Add sample rate to baggage as well as trace in envelope header and flatten user ([#2135](https://github.com/getsentry/sentry-java/pull/2135))

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Merge main into the branch to fix the changelog.

private static @Nullable String getSegment(final @NotNull User user) {
final Map<String, String> others = user.getOthers();
if (others != null) {
return others.get("segment");

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should segment be a new field in the Userprotocol maybe?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

JS seems to have it https://github.com/getsentry/sentry-javascript/blob/master/packages/types/src/user.ts while cocoa does not. Didn't check any other SDKs. Not sure what exactly this is used for / if it should be added. Can create a separate issue to track if you want.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, please, but let's be sure that the approach with others works if not now.
Also, in this issue, we should upgrade the protocol https://develop.sentry.dev/sdk/event-payloads/user/ (adding the new field).

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe there's a confusion here. Retrieving segment from others is not new behaviour. It's been there before. See

https://github.com/getsentry/sentry-java/pull/2135/files#diff-9049646d5de9245eead3115d46537579192044823590d4e9ef02eb221a9ae43cL118-L125

Comment on lines +88 to +90
if (sampleRateAsDouble < 0.0 || sampleRateAsDouble > 1.0) {
return null;
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we extract this logic from SentryOptions#setSampleRate and SentryOptions#setTracesSampleRate and reuse it as an util function.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

setSampleRate has sampleRate > 1.0 || sampleRate <= 0.0 while setTracesSampleRate has tracesSampleRate > 1.0 || tracesSampleRate < 0.0. Can add a util but won't reuse in both.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Indeed, tracesSampleRate can be 0.0

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added SampleRateUtil in #2141

Comment on lines +92 to +94
DecimalFormat df =
new DecimalFormat("#.################", DecimalFormatSymbols.getInstance(Locale.US));
return df.format(sampleRateAsDouble);

@marandanetomarandanetoJun 29, 2022

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should avoid US locale and use Locale.ROOT instead, some custom OS versions might not have the US locale.
Why don't we just transform the Double to String and send it as it is?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because we don't want exponent formatting. 0.00000021.toString() would become 2.1E-7 which we don't want.
Can replace the locale.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the spec defining the number of max digits? because ################ can lead to a different value, not sure if this would round or not.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would round on the last digit. Yes we're aligning with JS on the max digits here.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the locale usage in #2141

return baggage;
}

public static final class TraceContextUser implements JsonUnknown, JsonSerializable {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would that be a breaking change if people is upgrading SDKs from X to Y? how does the ser/deser behave if you're reading a JSON with the older structure.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, updated the code to parse from legacy JSON in #2141

adinauerand others added 4 commits June 30, 2022 12:16
* Commit tests
* Add sample rate from traces sampler to DSC
* Do not replace null with true/false
* Restore sample rate in OutboxSender
* Remove fallback for sampling decision from TraceContext
* Remove sample rate fallback from TracesSamplingDecision
* Test more envelope header trace fields for OutboxSender
* CR changes
…y/sentry-java into feat/add-sample-rate-to-baggage

@romtsnromtsn left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@adinauer
adinauer merged commit fa3886f into mainJul 1, 2022
@adinauer
adinauer deleted the feat/add-sample-rate-to-baggage branch July 1, 2022 13:47
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@adinauer@codecov-commenter@romtsn@marandaneto@lforst@Lms24
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Add sample rate to baggage as well as trace in envelope header and flatten user - #2135

Merged
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage
Jul 1, 2022
Merged

Add sample rate to baggage as well as trace in envelope header and flatten user#2135
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage

Conversation

@adinauer

@adinaueradinauer commented Jun 24, 2022

Copy link
Copy Markdown
Member

📜 Description

Add sample rate to baggage header as well as trace in envelope header.
Flatten user into user_id and user_segment for trace in envelope header.

💡 Motivation and Context

To allow for dynamic sampling and align with docs / other SDKs: getsentry/develop#613

💚 How did you test it?

📝 Checklist

  • I reviewed the submitted code
  • I added tests to verify the changes
  • I updated the docs if needed
  • No breaking changes

🔮 Next steps

@adinauer

Copy link
Copy Markdown
MemberAuthor

@AbhiPrasad@lforst@Lms24 can any of you please leave a review, once you feel the docs are ready to make sure this aligns?

@codecov-commenter

codecov-commenter commented Jun 24, 2022

Copy link
Copy Markdown

Codecov Report

Merging #2135 (1170cc7) into main (413862e) will decrease coverage by 0.01%.
The diff coverage is 85.80%.

@@ Coverage Diff @@## main #2135 +/- ##
============================================
- Coverage 80.95% 80.94% -0.02% - Complexity 3257 3290 +33 
============================================
Files 231 233 +2 Lines 11964 12044 +80 Branches 1589 1594 +5 ============================================
+ Hits 9686 9749 +63 - Misses 1698 1712 +14 - Partials 580 583 +3 
Impacted FilesCoverage Δ
...entry/src/main/java/io/sentry/NoOpTransaction.java25.00% <0.00%> (-0.81%)⬇️
sentry/src/main/java/io/sentry/OutboxSender.java65.64% <64.70%> (-0.74%)⬇️
...ry/src/main/java/io/sentry/TransactionContext.java85.71% <71.42%> (-14.29%)⬇️
...ain/java/io/sentry/protocol/SentryTransaction.java88.97% <75.00%> (-0.28%)⬇️
sentry/src/main/java/io/sentry/SpanContext.java83.94% <76.92%> (-0.68%)⬇️
...y/src/main/java/io/sentry/util/SampleRateUtil.java88.88% <88.88%> (ø)
sentry/src/main/java/io/sentry/TraceContext.java86.74% <90.90%> (-0.01%)⬇️
sentry/src/main/java/io/sentry/Baggage.java89.41% <100.00%> (+0.25%)⬆️
sentry/src/main/java/io/sentry/Hub.java76.41% <100.00%> (ø)
sentry/src/main/java/io/sentry/SentryOptions.java82.03% <100.00%> (ø)
... and 5 more

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 413862e...1170cc7. Read the comment docs.

}

public void setSampleRate(final @Nullable String sampleRate) {
set("sentry-samplerate", sampleRate);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We decided to make baggage and envelope header key names identical (except for the sentry- prefix in baggage keys) so that we're able to just dump the DSC data into both transport mechanisms without any mapping. (Linking to the preview here for more details)

Therefore, we should change the snake case keys to underscores (like in the example below)

Suggested change
set("sentry-samplerate", sampleRate);
set("sentry-sample_rate", sampleRate);

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does that also mean

  • sentry-publickey becomes sentry-public_key
  • sentry-traceid becomes sentry_trace_id
  • sentry-userid becomes sentry-user_id
  • sentry-usersegment becomes sentry-user_segment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, exactly

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • sentry-traceid becomes sentry_trace_id

It becomes sentry-trace_id, but that probably just was a typo ^^

@adinaueradinauerJun 27, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK thanks, will update.
Yeah just a typo on the _ there.

@adinaueradinauer mentioned this pull request Jun 28, 2022
4 tasks
@adinauer
adinauer marked this pull request as ready for review June 29, 2022 08:25
@adinauer
adinauer requested a review from romtsn as a code ownerJune 29, 2022 08:25
Comment threadCHANGELOG.md Outdated
Comment on lines +9 to +13
## Unreleased

### Features

- Add sample rate to baggage as well as trace in envelope header and flatten user ([#2135](https://github.com/getsentry/sentry-java/pull/2135))

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Merge main into the branch to fix the changelog.

private static @Nullable String getSegment(final @NotNull User user) {
final Map<String, String> others = user.getOthers();
if (others != null) {
return others.get("segment");

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should segment be a new field in the Userprotocol maybe?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

JS seems to have it https://github.com/getsentry/sentry-javascript/blob/master/packages/types/src/user.ts while cocoa does not. Didn't check any other SDKs. Not sure what exactly this is used for / if it should be added. Can create a separate issue to track if you want.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, please, but let's be sure that the approach with others works if not now.
Also, in this issue, we should upgrade the protocol https://develop.sentry.dev/sdk/event-payloads/user/ (adding the new field).

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe there's a confusion here. Retrieving segment from others is not new behaviour. It's been there before. See

https://github.com/getsentry/sentry-java/pull/2135/files#diff-9049646d5de9245eead3115d46537579192044823590d4e9ef02eb221a9ae43cL118-L125

Comment on lines +88 to +90
if (sampleRateAsDouble < 0.0 || sampleRateAsDouble > 1.0) {
return null;
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we extract this logic from SentryOptions#setSampleRate and SentryOptions#setTracesSampleRate and reuse it as an util function.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

setSampleRate has sampleRate > 1.0 || sampleRate <= 0.0 while setTracesSampleRate has tracesSampleRate > 1.0 || tracesSampleRate < 0.0. Can add a util but won't reuse in both.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Indeed, tracesSampleRate can be 0.0

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added SampleRateUtil in #2141

Comment on lines +92 to +94
DecimalFormat df =
new DecimalFormat("#.################", DecimalFormatSymbols.getInstance(Locale.US));
return df.format(sampleRateAsDouble);

@marandanetomarandanetoJun 29, 2022

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should avoid US locale and use Locale.ROOT instead, some custom OS versions might not have the US locale.
Why don't we just transform the Double to String and send it as it is?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because we don't want exponent formatting. 0.00000021.toString() would become 2.1E-7 which we don't want.
Can replace the locale.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the spec defining the number of max digits? because ################ can lead to a different value, not sure if this would round or not.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would round on the last digit. Yes we're aligning with JS on the max digits here.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the locale usage in #2141

return baggage;
}

public static final class TraceContextUser implements JsonUnknown, JsonSerializable {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would that be a breaking change if people is upgrading SDKs from X to Y? how does the ser/deser behave if you're reading a JSON with the older structure.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, updated the code to parse from legacy JSON in #2141

adinauerand others added 4 commits June 30, 2022 12:16
* Commit tests
* Add sample rate from traces sampler to DSC
* Do not replace null with true/false
* Restore sample rate in OutboxSender
* Remove fallback for sampling decision from TraceContext
* Remove sample rate fallback from TracesSamplingDecision
* Test more envelope header trace fields for OutboxSender
* CR changes
…y/sentry-java into feat/add-sample-rate-to-baggage

@romtsnromtsn left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@adinauer
adinauer merged commit fa3886f into mainJul 1, 2022
@adinauer
adinauer deleted the feat/add-sample-rate-to-baggage branch July 1, 2022 13:47
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@adinauer@codecov-commenter@romtsn@marandaneto@lforst@Lms24
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Add sample rate to baggage as well as trace in envelope header and flatten user - #2135

Merged
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage
Jul 1, 2022
Merged

Add sample rate to baggage as well as trace in envelope header and flatten user#2135
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage

Conversation

@adinauer

@adinaueradinauer commented Jun 24, 2022

Copy link
Copy Markdown
Member

📜 Description

Add sample rate to baggage header as well as trace in envelope header.
Flatten user into user_id and user_segment for trace in envelope header.

💡 Motivation and Context

To allow for dynamic sampling and align with docs / other SDKs: getsentry/develop#613

💚 How did you test it?

📝 Checklist

  • I reviewed the submitted code
  • I added tests to verify the changes
  • I updated the docs if needed
  • No breaking changes

🔮 Next steps

@adinauer

Copy link
Copy Markdown
MemberAuthor

@AbhiPrasad@lforst@Lms24 can any of you please leave a review, once you feel the docs are ready to make sure this aligns?

@codecov-commenter

codecov-commenter commented Jun 24, 2022

Copy link
Copy Markdown

Codecov Report

Merging #2135 (1170cc7) into main (413862e) will decrease coverage by 0.01%.
The diff coverage is 85.80%.

@@ Coverage Diff @@## main #2135 +/- ##
============================================
- Coverage 80.95% 80.94% -0.02% - Complexity 3257 3290 +33 
============================================
Files 231 233 +2 Lines 11964 12044 +80 Branches 1589 1594 +5 ============================================
+ Hits 9686 9749 +63 - Misses 1698 1712 +14 - Partials 580 583 +3 
Impacted FilesCoverage Δ
...entry/src/main/java/io/sentry/NoOpTransaction.java25.00% <0.00%> (-0.81%)⬇️
sentry/src/main/java/io/sentry/OutboxSender.java65.64% <64.70%> (-0.74%)⬇️
...ry/src/main/java/io/sentry/TransactionContext.java85.71% <71.42%> (-14.29%)⬇️
...ain/java/io/sentry/protocol/SentryTransaction.java88.97% <75.00%> (-0.28%)⬇️
sentry/src/main/java/io/sentry/SpanContext.java83.94% <76.92%> (-0.68%)⬇️
...y/src/main/java/io/sentry/util/SampleRateUtil.java88.88% <88.88%> (ø)
sentry/src/main/java/io/sentry/TraceContext.java86.74% <90.90%> (-0.01%)⬇️
sentry/src/main/java/io/sentry/Baggage.java89.41% <100.00%> (+0.25%)⬆️
sentry/src/main/java/io/sentry/Hub.java76.41% <100.00%> (ø)
sentry/src/main/java/io/sentry/SentryOptions.java82.03% <100.00%> (ø)
... and 5 more

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 413862e...1170cc7. Read the comment docs.

}

public void setSampleRate(final @Nullable String sampleRate) {
set("sentry-samplerate", sampleRate);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We decided to make baggage and envelope header key names identical (except for the sentry- prefix in baggage keys) so that we're able to just dump the DSC data into both transport mechanisms without any mapping. (Linking to the preview here for more details)

Therefore, we should change the snake case keys to underscores (like in the example below)

Suggested change
set("sentry-samplerate", sampleRate);
set("sentry-sample_rate", sampleRate);

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does that also mean

  • sentry-publickey becomes sentry-public_key
  • sentry-traceid becomes sentry_trace_id
  • sentry-userid becomes sentry-user_id
  • sentry-usersegment becomes sentry-user_segment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, exactly

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • sentry-traceid becomes sentry_trace_id

It becomes sentry-trace_id, but that probably just was a typo ^^

@adinaueradinauerJun 27, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK thanks, will update.
Yeah just a typo on the _ there.

@adinaueradinauer mentioned this pull request Jun 28, 2022
4 tasks
@adinauer
adinauer marked this pull request as ready for review June 29, 2022 08:25
@adinauer
adinauer requested a review from romtsn as a code ownerJune 29, 2022 08:25
Comment threadCHANGELOG.md Outdated
Comment on lines +9 to +13
## Unreleased

### Features

- Add sample rate to baggage as well as trace in envelope header and flatten user ([#2135](https://github.com/getsentry/sentry-java/pull/2135))

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Merge main into the branch to fix the changelog.

private static @Nullable String getSegment(final @NotNull User user) {
final Map<String, String> others = user.getOthers();
if (others != null) {
return others.get("segment");

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should segment be a new field in the Userprotocol maybe?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

JS seems to have it https://github.com/getsentry/sentry-javascript/blob/master/packages/types/src/user.ts while cocoa does not. Didn't check any other SDKs. Not sure what exactly this is used for / if it should be added. Can create a separate issue to track if you want.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, please, but let's be sure that the approach with others works if not now.
Also, in this issue, we should upgrade the protocol https://develop.sentry.dev/sdk/event-payloads/user/ (adding the new field).

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe there's a confusion here. Retrieving segment from others is not new behaviour. It's been there before. See

https://github.com/getsentry/sentry-java/pull/2135/files#diff-9049646d5de9245eead3115d46537579192044823590d4e9ef02eb221a9ae43cL118-L125

Comment on lines +88 to +90
if (sampleRateAsDouble < 0.0 || sampleRateAsDouble > 1.0) {
return null;
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we extract this logic from SentryOptions#setSampleRate and SentryOptions#setTracesSampleRate and reuse it as an util function.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

setSampleRate has sampleRate > 1.0 || sampleRate <= 0.0 while setTracesSampleRate has tracesSampleRate > 1.0 || tracesSampleRate < 0.0. Can add a util but won't reuse in both.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Indeed, tracesSampleRate can be 0.0

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added SampleRateUtil in #2141

Comment on lines +92 to +94
DecimalFormat df =
new DecimalFormat("#.################", DecimalFormatSymbols.getInstance(Locale.US));
return df.format(sampleRateAsDouble);

@marandanetomarandanetoJun 29, 2022

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should avoid US locale and use Locale.ROOT instead, some custom OS versions might not have the US locale.
Why don't we just transform the Double to String and send it as it is?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because we don't want exponent formatting. 0.00000021.toString() would become 2.1E-7 which we don't want.
Can replace the locale.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the spec defining the number of max digits? because ################ can lead to a different value, not sure if this would round or not.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would round on the last digit. Yes we're aligning with JS on the max digits here.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the locale usage in #2141

return baggage;
}

public static final class TraceContextUser implements JsonUnknown, JsonSerializable {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would that be a breaking change if people is upgrading SDKs from X to Y? how does the ser/deser behave if you're reading a JSON with the older structure.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, updated the code to parse from legacy JSON in #2141

adinauerand others added 4 commits June 30, 2022 12:16
* Commit tests
* Add sample rate from traces sampler to DSC
* Do not replace null with true/false
* Restore sample rate in OutboxSender
* Remove fallback for sampling decision from TraceContext
* Remove sample rate fallback from TracesSamplingDecision
* Test more envelope header trace fields for OutboxSender
* CR changes
…y/sentry-java into feat/add-sample-rate-to-baggage

@romtsnromtsn left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@adinauer
adinauer merged commit fa3886f into mainJul 1, 2022
@adinauer
adinauer deleted the feat/add-sample-rate-to-baggage branch July 1, 2022 13:47
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@adinauer@codecov-commenter@romtsn@marandaneto@lforst@Lms24
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Add sample rate to baggage as well as trace in envelope header and flatten user - #2135

Merged
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage
Jul 1, 2022
Merged

Add sample rate to baggage as well as trace in envelope header and flatten user#2135
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage

Conversation

@adinauer

@adinaueradinauer commented Jun 24, 2022

Copy link
Copy Markdown
Member

📜 Description

Add sample rate to baggage header as well as trace in envelope header.
Flatten user into user_id and user_segment for trace in envelope header.

💡 Motivation and Context

To allow for dynamic sampling and align with docs / other SDKs: getsentry/develop#613

💚 How did you test it?

📝 Checklist

  • I reviewed the submitted code
  • I added tests to verify the changes
  • I updated the docs if needed
  • No breaking changes

🔮 Next steps

@adinauer

Copy link
Copy Markdown
MemberAuthor

@AbhiPrasad@lforst@Lms24 can any of you please leave a review, once you feel the docs are ready to make sure this aligns?

@codecov-commenter

codecov-commenter commented Jun 24, 2022

Copy link
Copy Markdown

Codecov Report

Merging #2135 (1170cc7) into main (413862e) will decrease coverage by 0.01%.
The diff coverage is 85.80%.

@@ Coverage Diff @@## main #2135 +/- ##
============================================
- Coverage 80.95% 80.94% -0.02% - Complexity 3257 3290 +33 
============================================
Files 231 233 +2 Lines 11964 12044 +80 Branches 1589 1594 +5 ============================================
+ Hits 9686 9749 +63 - Misses 1698 1712 +14 - Partials 580 583 +3 
Impacted FilesCoverage Δ
...entry/src/main/java/io/sentry/NoOpTransaction.java25.00% <0.00%> (-0.81%)⬇️
sentry/src/main/java/io/sentry/OutboxSender.java65.64% <64.70%> (-0.74%)⬇️
...ry/src/main/java/io/sentry/TransactionContext.java85.71% <71.42%> (-14.29%)⬇️
...ain/java/io/sentry/protocol/SentryTransaction.java88.97% <75.00%> (-0.28%)⬇️
sentry/src/main/java/io/sentry/SpanContext.java83.94% <76.92%> (-0.68%)⬇️
...y/src/main/java/io/sentry/util/SampleRateUtil.java88.88% <88.88%> (ø)
sentry/src/main/java/io/sentry/TraceContext.java86.74% <90.90%> (-0.01%)⬇️
sentry/src/main/java/io/sentry/Baggage.java89.41% <100.00%> (+0.25%)⬆️
sentry/src/main/java/io/sentry/Hub.java76.41% <100.00%> (ø)
sentry/src/main/java/io/sentry/SentryOptions.java82.03% <100.00%> (ø)
... and 5 more

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 413862e...1170cc7. Read the comment docs.

}

public void setSampleRate(final @Nullable String sampleRate) {
set("sentry-samplerate", sampleRate);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We decided to make baggage and envelope header key names identical (except for the sentry- prefix in baggage keys) so that we're able to just dump the DSC data into both transport mechanisms without any mapping. (Linking to the preview here for more details)

Therefore, we should change the snake case keys to underscores (like in the example below)

Suggested change
set("sentry-samplerate", sampleRate);
set("sentry-sample_rate", sampleRate);

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does that also mean

  • sentry-publickey becomes sentry-public_key
  • sentry-traceid becomes sentry_trace_id
  • sentry-userid becomes sentry-user_id
  • sentry-usersegment becomes sentry-user_segment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, exactly

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • sentry-traceid becomes sentry_trace_id

It becomes sentry-trace_id, but that probably just was a typo ^^

@adinaueradinauerJun 27, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK thanks, will update.
Yeah just a typo on the _ there.

@adinaueradinauer mentioned this pull request Jun 28, 2022
4 tasks
@adinauer
adinauer marked this pull request as ready for review June 29, 2022 08:25
@adinauer
adinauer requested a review from romtsn as a code ownerJune 29, 2022 08:25
Comment threadCHANGELOG.md Outdated
Comment on lines +9 to +13
## Unreleased

### Features

- Add sample rate to baggage as well as trace in envelope header and flatten user ([#2135](https://github.com/getsentry/sentry-java/pull/2135))

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Merge main into the branch to fix the changelog.

private static @Nullable String getSegment(final @NotNull User user) {
final Map<String, String> others = user.getOthers();
if (others != null) {
return others.get("segment");

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should segment be a new field in the Userprotocol maybe?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

JS seems to have it https://github.com/getsentry/sentry-javascript/blob/master/packages/types/src/user.ts while cocoa does not. Didn't check any other SDKs. Not sure what exactly this is used for / if it should be added. Can create a separate issue to track if you want.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, please, but let's be sure that the approach with others works if not now.
Also, in this issue, we should upgrade the protocol https://develop.sentry.dev/sdk/event-payloads/user/ (adding the new field).

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe there's a confusion here. Retrieving segment from others is not new behaviour. It's been there before. See

https://github.com/getsentry/sentry-java/pull/2135/files#diff-9049646d5de9245eead3115d46537579192044823590d4e9ef02eb221a9ae43cL118-L125

Comment on lines +88 to +90
if (sampleRateAsDouble < 0.0 || sampleRateAsDouble > 1.0) {
return null;
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we extract this logic from SentryOptions#setSampleRate and SentryOptions#setTracesSampleRate and reuse it as an util function.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

setSampleRate has sampleRate > 1.0 || sampleRate <= 0.0 while setTracesSampleRate has tracesSampleRate > 1.0 || tracesSampleRate < 0.0. Can add a util but won't reuse in both.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Indeed, tracesSampleRate can be 0.0

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added SampleRateUtil in #2141

Comment on lines +92 to +94
DecimalFormat df =
new DecimalFormat("#.################", DecimalFormatSymbols.getInstance(Locale.US));
return df.format(sampleRateAsDouble);

@marandanetomarandanetoJun 29, 2022

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should avoid US locale and use Locale.ROOT instead, some custom OS versions might not have the US locale.
Why don't we just transform the Double to String and send it as it is?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because we don't want exponent formatting. 0.00000021.toString() would become 2.1E-7 which we don't want.
Can replace the locale.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the spec defining the number of max digits? because ################ can lead to a different value, not sure if this would round or not.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would round on the last digit. Yes we're aligning with JS on the max digits here.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the locale usage in #2141

return baggage;
}

public static final class TraceContextUser implements JsonUnknown, JsonSerializable {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would that be a breaking change if people is upgrading SDKs from X to Y? how does the ser/deser behave if you're reading a JSON with the older structure.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, updated the code to parse from legacy JSON in #2141

adinauerand others added 4 commits June 30, 2022 12:16
* Commit tests
* Add sample rate from traces sampler to DSC
* Do not replace null with true/false
* Restore sample rate in OutboxSender
* Remove fallback for sampling decision from TraceContext
* Remove sample rate fallback from TracesSamplingDecision
* Test more envelope header trace fields for OutboxSender
* CR changes
…y/sentry-java into feat/add-sample-rate-to-baggage

@romtsnromtsn left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@adinauer
adinauer merged commit fa3886f into mainJul 1, 2022
@adinauer
adinauer deleted the feat/add-sample-rate-to-baggage branch July 1, 2022 13:47
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@adinauer@codecov-commenter@romtsn@marandaneto@lforst@Lms24
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Add sample rate to baggage as well as trace in envelope header and flatten user - #2135

Merged
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage
Jul 1, 2022
Merged

Add sample rate to baggage as well as trace in envelope header and flatten user#2135
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage

Conversation

@adinauer

@adinaueradinauer commented Jun 24, 2022

Copy link
Copy Markdown
Member

📜 Description

Add sample rate to baggage header as well as trace in envelope header.
Flatten user into user_id and user_segment for trace in envelope header.

💡 Motivation and Context

To allow for dynamic sampling and align with docs / other SDKs: getsentry/develop#613

💚 How did you test it?

📝 Checklist

  • I reviewed the submitted code
  • I added tests to verify the changes
  • I updated the docs if needed
  • No breaking changes

🔮 Next steps

@adinauer

Copy link
Copy Markdown
MemberAuthor

@AbhiPrasad@lforst@Lms24 can any of you please leave a review, once you feel the docs are ready to make sure this aligns?

@codecov-commenter

codecov-commenter commented Jun 24, 2022

Copy link
Copy Markdown

Codecov Report

Merging #2135 (1170cc7) into main (413862e) will decrease coverage by 0.01%.
The diff coverage is 85.80%.

@@ Coverage Diff @@## main #2135 +/- ##
============================================
- Coverage 80.95% 80.94% -0.02% - Complexity 3257 3290 +33 
============================================
Files 231 233 +2 Lines 11964 12044 +80 Branches 1589 1594 +5 ============================================
+ Hits 9686 9749 +63 - Misses 1698 1712 +14 - Partials 580 583 +3 
Impacted FilesCoverage Δ
...entry/src/main/java/io/sentry/NoOpTransaction.java25.00% <0.00%> (-0.81%)⬇️
sentry/src/main/java/io/sentry/OutboxSender.java65.64% <64.70%> (-0.74%)⬇️
...ry/src/main/java/io/sentry/TransactionContext.java85.71% <71.42%> (-14.29%)⬇️
...ain/java/io/sentry/protocol/SentryTransaction.java88.97% <75.00%> (-0.28%)⬇️
sentry/src/main/java/io/sentry/SpanContext.java83.94% <76.92%> (-0.68%)⬇️
...y/src/main/java/io/sentry/util/SampleRateUtil.java88.88% <88.88%> (ø)
sentry/src/main/java/io/sentry/TraceContext.java86.74% <90.90%> (-0.01%)⬇️
sentry/src/main/java/io/sentry/Baggage.java89.41% <100.00%> (+0.25%)⬆️
sentry/src/main/java/io/sentry/Hub.java76.41% <100.00%> (ø)
sentry/src/main/java/io/sentry/SentryOptions.java82.03% <100.00%> (ø)
... and 5 more

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 413862e...1170cc7. Read the comment docs.

}

public void setSampleRate(final @Nullable String sampleRate) {
set("sentry-samplerate", sampleRate);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We decided to make baggage and envelope header key names identical (except for the sentry- prefix in baggage keys) so that we're able to just dump the DSC data into both transport mechanisms without any mapping. (Linking to the preview here for more details)

Therefore, we should change the snake case keys to underscores (like in the example below)

Suggested change
set("sentry-samplerate", sampleRate);
set("sentry-sample_rate", sampleRate);

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does that also mean

  • sentry-publickey becomes sentry-public_key
  • sentry-traceid becomes sentry_trace_id
  • sentry-userid becomes sentry-user_id
  • sentry-usersegment becomes sentry-user_segment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, exactly

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • sentry-traceid becomes sentry_trace_id

It becomes sentry-trace_id, but that probably just was a typo ^^

@adinaueradinauerJun 27, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK thanks, will update.
Yeah just a typo on the _ there.

@adinaueradinauer mentioned this pull request Jun 28, 2022
4 tasks
@adinauer
adinauer marked this pull request as ready for review June 29, 2022 08:25
@adinauer
adinauer requested a review from romtsn as a code ownerJune 29, 2022 08:25
Comment threadCHANGELOG.md Outdated
Comment on lines +9 to +13
## Unreleased

### Features

- Add sample rate to baggage as well as trace in envelope header and flatten user ([#2135](https://github.com/getsentry/sentry-java/pull/2135))

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Merge main into the branch to fix the changelog.

private static @Nullable String getSegment(final @NotNull User user) {
final Map<String, String> others = user.getOthers();
if (others != null) {
return others.get("segment");

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should segment be a new field in the Userprotocol maybe?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

JS seems to have it https://github.com/getsentry/sentry-javascript/blob/master/packages/types/src/user.ts while cocoa does not. Didn't check any other SDKs. Not sure what exactly this is used for / if it should be added. Can create a separate issue to track if you want.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, please, but let's be sure that the approach with others works if not now.
Also, in this issue, we should upgrade the protocol https://develop.sentry.dev/sdk/event-payloads/user/ (adding the new field).

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe there's a confusion here. Retrieving segment from others is not new behaviour. It's been there before. See

https://github.com/getsentry/sentry-java/pull/2135/files#diff-9049646d5de9245eead3115d46537579192044823590d4e9ef02eb221a9ae43cL118-L125

Comment on lines +88 to +90
if (sampleRateAsDouble < 0.0 || sampleRateAsDouble > 1.0) {
return null;
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we extract this logic from SentryOptions#setSampleRate and SentryOptions#setTracesSampleRate and reuse it as an util function.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

setSampleRate has sampleRate > 1.0 || sampleRate <= 0.0 while setTracesSampleRate has tracesSampleRate > 1.0 || tracesSampleRate < 0.0. Can add a util but won't reuse in both.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Indeed, tracesSampleRate can be 0.0

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added SampleRateUtil in #2141

Comment on lines +92 to +94
DecimalFormat df =
new DecimalFormat("#.################", DecimalFormatSymbols.getInstance(Locale.US));
return df.format(sampleRateAsDouble);

@marandanetomarandanetoJun 29, 2022

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should avoid US locale and use Locale.ROOT instead, some custom OS versions might not have the US locale.
Why don't we just transform the Double to String and send it as it is?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because we don't want exponent formatting. 0.00000021.toString() would become 2.1E-7 which we don't want.
Can replace the locale.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the spec defining the number of max digits? because ################ can lead to a different value, not sure if this would round or not.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would round on the last digit. Yes we're aligning with JS on the max digits here.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the locale usage in #2141

return baggage;
}

public static final class TraceContextUser implements JsonUnknown, JsonSerializable {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would that be a breaking change if people is upgrading SDKs from X to Y? how does the ser/deser behave if you're reading a JSON with the older structure.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, updated the code to parse from legacy JSON in #2141

adinauerand others added 4 commits June 30, 2022 12:16
* Commit tests
* Add sample rate from traces sampler to DSC
* Do not replace null with true/false
* Restore sample rate in OutboxSender
* Remove fallback for sampling decision from TraceContext
* Remove sample rate fallback from TracesSamplingDecision
* Test more envelope header trace fields for OutboxSender
* CR changes
…y/sentry-java into feat/add-sample-rate-to-baggage

@romtsnromtsn left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@adinauer
adinauer merged commit fa3886f into mainJul 1, 2022
@adinauer
adinauer deleted the feat/add-sample-rate-to-baggage branch July 1, 2022 13:47
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@adinauer@codecov-commenter@romtsn@marandaneto@lforst@Lms24
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Add sample rate to baggage as well as trace in envelope header and flatten user - #2135

Merged
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage
Jul 1, 2022
Merged

Add sample rate to baggage as well as trace in envelope header and flatten user#2135
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage

Conversation

@adinauer

@adinaueradinauer commented Jun 24, 2022

Copy link
Copy Markdown
Member

📜 Description

Add sample rate to baggage header as well as trace in envelope header.
Flatten user into user_id and user_segment for trace in envelope header.

💡 Motivation and Context

To allow for dynamic sampling and align with docs / other SDKs: getsentry/develop#613

💚 How did you test it?

📝 Checklist

  • I reviewed the submitted code
  • I added tests to verify the changes
  • I updated the docs if needed
  • No breaking changes

🔮 Next steps

@adinauer

Copy link
Copy Markdown
MemberAuthor

@AbhiPrasad@lforst@Lms24 can any of you please leave a review, once you feel the docs are ready to make sure this aligns?

@codecov-commenter

codecov-commenter commented Jun 24, 2022

Copy link
Copy Markdown

Codecov Report

Merging #2135 (1170cc7) into main (413862e) will decrease coverage by 0.01%.
The diff coverage is 85.80%.

@@ Coverage Diff @@## main #2135 +/- ##
============================================
- Coverage 80.95% 80.94% -0.02% - Complexity 3257 3290 +33 
============================================
Files 231 233 +2 Lines 11964 12044 +80 Branches 1589 1594 +5 ============================================
+ Hits 9686 9749 +63 - Misses 1698 1712 +14 - Partials 580 583 +3 
Impacted FilesCoverage Δ
...entry/src/main/java/io/sentry/NoOpTransaction.java25.00% <0.00%> (-0.81%)⬇️
sentry/src/main/java/io/sentry/OutboxSender.java65.64% <64.70%> (-0.74%)⬇️
...ry/src/main/java/io/sentry/TransactionContext.java85.71% <71.42%> (-14.29%)⬇️
...ain/java/io/sentry/protocol/SentryTransaction.java88.97% <75.00%> (-0.28%)⬇️
sentry/src/main/java/io/sentry/SpanContext.java83.94% <76.92%> (-0.68%)⬇️
...y/src/main/java/io/sentry/util/SampleRateUtil.java88.88% <88.88%> (ø)
sentry/src/main/java/io/sentry/TraceContext.java86.74% <90.90%> (-0.01%)⬇️
sentry/src/main/java/io/sentry/Baggage.java89.41% <100.00%> (+0.25%)⬆️
sentry/src/main/java/io/sentry/Hub.java76.41% <100.00%> (ø)
sentry/src/main/java/io/sentry/SentryOptions.java82.03% <100.00%> (ø)
... and 5 more

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 413862e...1170cc7. Read the comment docs.

}

public void setSampleRate(final @Nullable String sampleRate) {
set("sentry-samplerate", sampleRate);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We decided to make baggage and envelope header key names identical (except for the sentry- prefix in baggage keys) so that we're able to just dump the DSC data into both transport mechanisms without any mapping. (Linking to the preview here for more details)

Therefore, we should change the snake case keys to underscores (like in the example below)

Suggested change
set("sentry-samplerate", sampleRate);
set("sentry-sample_rate", sampleRate);

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does that also mean

  • sentry-publickey becomes sentry-public_key
  • sentry-traceid becomes sentry_trace_id
  • sentry-userid becomes sentry-user_id
  • sentry-usersegment becomes sentry-user_segment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, exactly

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • sentry-traceid becomes sentry_trace_id

It becomes sentry-trace_id, but that probably just was a typo ^^

@adinaueradinauerJun 27, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK thanks, will update.
Yeah just a typo on the _ there.

@adinaueradinauer mentioned this pull request Jun 28, 2022
4 tasks
@adinauer
adinauer marked this pull request as ready for review June 29, 2022 08:25
@adinauer
adinauer requested a review from romtsn as a code ownerJune 29, 2022 08:25
Comment threadCHANGELOG.md Outdated
Comment on lines +9 to +13
## Unreleased

### Features

- Add sample rate to baggage as well as trace in envelope header and flatten user ([#2135](https://github.com/getsentry/sentry-java/pull/2135))

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Merge main into the branch to fix the changelog.

private static @Nullable String getSegment(final @NotNull User user) {
final Map<String, String> others = user.getOthers();
if (others != null) {
return others.get("segment");

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should segment be a new field in the Userprotocol maybe?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

JS seems to have it https://github.com/getsentry/sentry-javascript/blob/master/packages/types/src/user.ts while cocoa does not. Didn't check any other SDKs. Not sure what exactly this is used for / if it should be added. Can create a separate issue to track if you want.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, please, but let's be sure that the approach with others works if not now.
Also, in this issue, we should upgrade the protocol https://develop.sentry.dev/sdk/event-payloads/user/ (adding the new field).

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe there's a confusion here. Retrieving segment from others is not new behaviour. It's been there before. See

https://github.com/getsentry/sentry-java/pull/2135/files#diff-9049646d5de9245eead3115d46537579192044823590d4e9ef02eb221a9ae43cL118-L125

Comment on lines +88 to +90
if (sampleRateAsDouble < 0.0 || sampleRateAsDouble > 1.0) {
return null;
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we extract this logic from SentryOptions#setSampleRate and SentryOptions#setTracesSampleRate and reuse it as an util function.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

setSampleRate has sampleRate > 1.0 || sampleRate <= 0.0 while setTracesSampleRate has tracesSampleRate > 1.0 || tracesSampleRate < 0.0. Can add a util but won't reuse in both.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Indeed, tracesSampleRate can be 0.0

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added SampleRateUtil in #2141

Comment on lines +92 to +94
DecimalFormat df =
new DecimalFormat("#.################", DecimalFormatSymbols.getInstance(Locale.US));
return df.format(sampleRateAsDouble);

@marandanetomarandanetoJun 29, 2022

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should avoid US locale and use Locale.ROOT instead, some custom OS versions might not have the US locale.
Why don't we just transform the Double to String and send it as it is?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because we don't want exponent formatting. 0.00000021.toString() would become 2.1E-7 which we don't want.
Can replace the locale.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the spec defining the number of max digits? because ################ can lead to a different value, not sure if this would round or not.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would round on the last digit. Yes we're aligning with JS on the max digits here.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the locale usage in #2141

return baggage;
}

public static final class TraceContextUser implements JsonUnknown, JsonSerializable {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would that be a breaking change if people is upgrading SDKs from X to Y? how does the ser/deser behave if you're reading a JSON with the older structure.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, updated the code to parse from legacy JSON in #2141

adinauerand others added 4 commits June 30, 2022 12:16
* Commit tests
* Add sample rate from traces sampler to DSC
* Do not replace null with true/false
* Restore sample rate in OutboxSender
* Remove fallback for sampling decision from TraceContext
* Remove sample rate fallback from TracesSamplingDecision
* Test more envelope header trace fields for OutboxSender
* CR changes
…y/sentry-java into feat/add-sample-rate-to-baggage

@romtsnromtsn left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@adinauer
adinauer merged commit fa3886f into mainJul 1, 2022
@adinauer
adinauer deleted the feat/add-sample-rate-to-baggage branch July 1, 2022 13:47
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@adinauer@codecov-commenter@romtsn@marandaneto@lforst@Lms24
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Add sample rate to baggage as well as trace in envelope header and flatten user - #2135

Merged
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage
Jul 1, 2022
Merged

Add sample rate to baggage as well as trace in envelope header and flatten user#2135
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage

Conversation

@adinauer

@adinaueradinauer commented Jun 24, 2022

Copy link
Copy Markdown
Member

📜 Description

Add sample rate to baggage header as well as trace in envelope header.
Flatten user into user_id and user_segment for trace in envelope header.

💡 Motivation and Context

To allow for dynamic sampling and align with docs / other SDKs: getsentry/develop#613

💚 How did you test it?

📝 Checklist

  • I reviewed the submitted code
  • I added tests to verify the changes
  • I updated the docs if needed
  • No breaking changes

🔮 Next steps

@adinauer

Copy link
Copy Markdown
MemberAuthor

@AbhiPrasad@lforst@Lms24 can any of you please leave a review, once you feel the docs are ready to make sure this aligns?

@codecov-commenter

codecov-commenter commented Jun 24, 2022

Copy link
Copy Markdown

Codecov Report

Merging #2135 (1170cc7) into main (413862e) will decrease coverage by 0.01%.
The diff coverage is 85.80%.

@@ Coverage Diff @@## main #2135 +/- ##
============================================
- Coverage 80.95% 80.94% -0.02% - Complexity 3257 3290 +33 
============================================
Files 231 233 +2 Lines 11964 12044 +80 Branches 1589 1594 +5 ============================================
+ Hits 9686 9749 +63 - Misses 1698 1712 +14 - Partials 580 583 +3 
Impacted FilesCoverage Δ
...entry/src/main/java/io/sentry/NoOpTransaction.java25.00% <0.00%> (-0.81%)⬇️
sentry/src/main/java/io/sentry/OutboxSender.java65.64% <64.70%> (-0.74%)⬇️
...ry/src/main/java/io/sentry/TransactionContext.java85.71% <71.42%> (-14.29%)⬇️
...ain/java/io/sentry/protocol/SentryTransaction.java88.97% <75.00%> (-0.28%)⬇️
sentry/src/main/java/io/sentry/SpanContext.java83.94% <76.92%> (-0.68%)⬇️
...y/src/main/java/io/sentry/util/SampleRateUtil.java88.88% <88.88%> (ø)
sentry/src/main/java/io/sentry/TraceContext.java86.74% <90.90%> (-0.01%)⬇️
sentry/src/main/java/io/sentry/Baggage.java89.41% <100.00%> (+0.25%)⬆️
sentry/src/main/java/io/sentry/Hub.java76.41% <100.00%> (ø)
sentry/src/main/java/io/sentry/SentryOptions.java82.03% <100.00%> (ø)
... and 5 more

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 413862e...1170cc7. Read the comment docs.

}

public void setSampleRate(final @Nullable String sampleRate) {
set("sentry-samplerate", sampleRate);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We decided to make baggage and envelope header key names identical (except for the sentry- prefix in baggage keys) so that we're able to just dump the DSC data into both transport mechanisms without any mapping. (Linking to the preview here for more details)

Therefore, we should change the snake case keys to underscores (like in the example below)

Suggested change
set("sentry-samplerate", sampleRate);
set("sentry-sample_rate", sampleRate);

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does that also mean

  • sentry-publickey becomes sentry-public_key
  • sentry-traceid becomes sentry_trace_id
  • sentry-userid becomes sentry-user_id
  • sentry-usersegment becomes sentry-user_segment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, exactly

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • sentry-traceid becomes sentry_trace_id

It becomes sentry-trace_id, but that probably just was a typo ^^

@adinaueradinauerJun 27, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK thanks, will update.
Yeah just a typo on the _ there.

@adinaueradinauer mentioned this pull request Jun 28, 2022
4 tasks
@adinauer
adinauer marked this pull request as ready for review June 29, 2022 08:25
@adinauer
adinauer requested a review from romtsn as a code ownerJune 29, 2022 08:25
Comment threadCHANGELOG.md Outdated
Comment on lines +9 to +13
## Unreleased

### Features

- Add sample rate to baggage as well as trace in envelope header and flatten user ([#2135](https://github.com/getsentry/sentry-java/pull/2135))

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Merge main into the branch to fix the changelog.

private static @Nullable String getSegment(final @NotNull User user) {
final Map<String, String> others = user.getOthers();
if (others != null) {
return others.get("segment");

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should segment be a new field in the Userprotocol maybe?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

JS seems to have it https://github.com/getsentry/sentry-javascript/blob/master/packages/types/src/user.ts while cocoa does not. Didn't check any other SDKs. Not sure what exactly this is used for / if it should be added. Can create a separate issue to track if you want.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, please, but let's be sure that the approach with others works if not now.
Also, in this issue, we should upgrade the protocol https://develop.sentry.dev/sdk/event-payloads/user/ (adding the new field).

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe there's a confusion here. Retrieving segment from others is not new behaviour. It's been there before. See

https://github.com/getsentry/sentry-java/pull/2135/files#diff-9049646d5de9245eead3115d46537579192044823590d4e9ef02eb221a9ae43cL118-L125

Comment on lines +88 to +90
if (sampleRateAsDouble < 0.0 || sampleRateAsDouble > 1.0) {
return null;
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we extract this logic from SentryOptions#setSampleRate and SentryOptions#setTracesSampleRate and reuse it as an util function.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

setSampleRate has sampleRate > 1.0 || sampleRate <= 0.0 while setTracesSampleRate has tracesSampleRate > 1.0 || tracesSampleRate < 0.0. Can add a util but won't reuse in both.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Indeed, tracesSampleRate can be 0.0

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added SampleRateUtil in #2141

Comment on lines +92 to +94
DecimalFormat df =
new DecimalFormat("#.################", DecimalFormatSymbols.getInstance(Locale.US));
return df.format(sampleRateAsDouble);

@marandanetomarandanetoJun 29, 2022

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should avoid US locale and use Locale.ROOT instead, some custom OS versions might not have the US locale.
Why don't we just transform the Double to String and send it as it is?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because we don't want exponent formatting. 0.00000021.toString() would become 2.1E-7 which we don't want.
Can replace the locale.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the spec defining the number of max digits? because ################ can lead to a different value, not sure if this would round or not.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would round on the last digit. Yes we're aligning with JS on the max digits here.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the locale usage in #2141

return baggage;
}

public static final class TraceContextUser implements JsonUnknown, JsonSerializable {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would that be a breaking change if people is upgrading SDKs from X to Y? how does the ser/deser behave if you're reading a JSON with the older structure.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, updated the code to parse from legacy JSON in #2141

adinauerand others added 4 commits June 30, 2022 12:16
* Commit tests
* Add sample rate from traces sampler to DSC
* Do not replace null with true/false
* Restore sample rate in OutboxSender
* Remove fallback for sampling decision from TraceContext
* Remove sample rate fallback from TracesSamplingDecision
* Test more envelope header trace fields for OutboxSender
* CR changes
…y/sentry-java into feat/add-sample-rate-to-baggage

@romtsnromtsn left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@adinauer
adinauer merged commit fa3886f into mainJul 1, 2022
@adinauer
adinauer deleted the feat/add-sample-rate-to-baggage branch July 1, 2022 13:47
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@adinauer@codecov-commenter@romtsn@marandaneto@lforst@Lms24
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Add sample rate to baggage as well as trace in envelope header and flatten user - #2135

Merged
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage
Jul 1, 2022
Merged

Add sample rate to baggage as well as trace in envelope header and flatten user#2135
adinauer merged 10 commits into
mainfrom
feat/add-sample-rate-to-baggage

Conversation

@adinauer

@adinaueradinauer commented Jun 24, 2022

Copy link
Copy Markdown
Member

📜 Description

Add sample rate to baggage header as well as trace in envelope header.
Flatten user into user_id and user_segment for trace in envelope header.

💡 Motivation and Context

To allow for dynamic sampling and align with docs / other SDKs: getsentry/develop#613

💚 How did you test it?

📝 Checklist

  • I reviewed the submitted code
  • I added tests to verify the changes
  • I updated the docs if needed
  • No breaking changes

🔮 Next steps

@adinauer

Copy link
Copy Markdown
MemberAuthor

@AbhiPrasad@lforst@Lms24 can any of you please leave a review, once you feel the docs are ready to make sure this aligns?

@codecov-commenter

codecov-commenter commented Jun 24, 2022

Copy link
Copy Markdown

Codecov Report

Merging #2135 (1170cc7) into main (413862e) will decrease coverage by 0.01%.
The diff coverage is 85.80%.

@@ Coverage Diff @@## main #2135 +/- ##
============================================
- Coverage 80.95% 80.94% -0.02% - Complexity 3257 3290 +33 
============================================
Files 231 233 +2 Lines 11964 12044 +80 Branches 1589 1594 +5 ============================================
+ Hits 9686 9749 +63 - Misses 1698 1712 +14 - Partials 580 583 +3 
Impacted FilesCoverage Δ
...entry/src/main/java/io/sentry/NoOpTransaction.java25.00% <0.00%> (-0.81%)⬇️
sentry/src/main/java/io/sentry/OutboxSender.java65.64% <64.70%> (-0.74%)⬇️
...ry/src/main/java/io/sentry/TransactionContext.java85.71% <71.42%> (-14.29%)⬇️
...ain/java/io/sentry/protocol/SentryTransaction.java88.97% <75.00%> (-0.28%)⬇️
sentry/src/main/java/io/sentry/SpanContext.java83.94% <76.92%> (-0.68%)⬇️
...y/src/main/java/io/sentry/util/SampleRateUtil.java88.88% <88.88%> (ø)
sentry/src/main/java/io/sentry/TraceContext.java86.74% <90.90%> (-0.01%)⬇️
sentry/src/main/java/io/sentry/Baggage.java89.41% <100.00%> (+0.25%)⬆️
sentry/src/main/java/io/sentry/Hub.java76.41% <100.00%> (ø)
sentry/src/main/java/io/sentry/SentryOptions.java82.03% <100.00%> (ø)
... and 5 more

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 413862e...1170cc7. Read the comment docs.

}

public void setSampleRate(final @Nullable String sampleRate) {
set("sentry-samplerate", sampleRate);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We decided to make baggage and envelope header key names identical (except for the sentry- prefix in baggage keys) so that we're able to just dump the DSC data into both transport mechanisms without any mapping. (Linking to the preview here for more details)

Therefore, we should change the snake case keys to underscores (like in the example below)

Suggested change
set("sentry-samplerate", sampleRate);
set("sentry-sample_rate", sampleRate);

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does that also mean

  • sentry-publickey becomes sentry-public_key
  • sentry-traceid becomes sentry_trace_id
  • sentry-userid becomes sentry-user_id
  • sentry-usersegment becomes sentry-user_segment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, exactly

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • sentry-traceid becomes sentry_trace_id

It becomes sentry-trace_id, but that probably just was a typo ^^

@adinaueradinauerJun 27, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK thanks, will update.
Yeah just a typo on the _ there.

@adinaueradinauer mentioned this pull request Jun 28, 2022
4 tasks
@adinauer
adinauer marked this pull request as ready for review June 29, 2022 08:25
@adinauer
adinauer requested a review from romtsn as a code ownerJune 29, 2022 08:25
Comment threadCHANGELOG.md Outdated
Comment on lines +9 to +13
## Unreleased

### Features

- Add sample rate to baggage as well as trace in envelope header and flatten user ([#2135](https://github.com/getsentry/sentry-java/pull/2135))

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Merge main into the branch to fix the changelog.

private static @Nullable String getSegment(final @NotNull User user) {
final Map<String, String> others = user.getOthers();
if (others != null) {
return others.get("segment");

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should segment be a new field in the Userprotocol maybe?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

JS seems to have it https://github.com/getsentry/sentry-javascript/blob/master/packages/types/src/user.ts while cocoa does not. Didn't check any other SDKs. Not sure what exactly this is used for / if it should be added. Can create a separate issue to track if you want.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, please, but let's be sure that the approach with others works if not now.
Also, in this issue, we should upgrade the protocol https://develop.sentry.dev/sdk/event-payloads/user/ (adding the new field).

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe there's a confusion here. Retrieving segment from others is not new behaviour. It's been there before. See

https://github.com/getsentry/sentry-java/pull/2135/files#diff-9049646d5de9245eead3115d46537579192044823590d4e9ef02eb221a9ae43cL118-L125

Comment on lines +88 to +90
if (sampleRateAsDouble < 0.0 || sampleRateAsDouble > 1.0) {
return null;
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we extract this logic from SentryOptions#setSampleRate and SentryOptions#setTracesSampleRate and reuse it as an util function.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

setSampleRate has sampleRate > 1.0 || sampleRate <= 0.0 while setTracesSampleRate has tracesSampleRate > 1.0 || tracesSampleRate < 0.0. Can add a util but won't reuse in both.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Indeed, tracesSampleRate can be 0.0

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added SampleRateUtil in #2141

Comment on lines +92 to +94
DecimalFormat df =
new DecimalFormat("#.################", DecimalFormatSymbols.getInstance(Locale.US));
return df.format(sampleRateAsDouble);

@marandanetomarandanetoJun 29, 2022

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should avoid US locale and use Locale.ROOT instead, some custom OS versions might not have the US locale.
Why don't we just transform the Double to String and send it as it is?

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because we don't want exponent formatting. 0.00000021.toString() would become 2.1E-7 which we don't want.
Can replace the locale.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the spec defining the number of max digits? because ################ can lead to a different value, not sure if this would round or not.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would round on the last digit. Yes we're aligning with JS on the max digits here.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the locale usage in #2141

return baggage;
}

public static final class TraceContextUser implements JsonUnknown, JsonSerializable {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would that be a breaking change if people is upgrading SDKs from X to Y? how does the ser/deser behave if you're reading a JSON with the older structure.

@adinaueradinauerJun 29, 2022

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, updated the code to parse from legacy JSON in #2141

adinauerand others added 4 commits June 30, 2022 12:16
* Commit tests
* Add sample rate from traces sampler to DSC
* Do not replace null with true/false
* Restore sample rate in OutboxSender
* Remove fallback for sampling decision from TraceContext
* Remove sample rate fallback from TracesSamplingDecision
* Test more envelope header trace fields for OutboxSender
* CR changes
…y/sentry-java into feat/add-sample-rate-to-baggage

@romtsnromtsn left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@adinauer
adinauer merged commit fa3886f into mainJul 1, 2022
@adinauer
adinauer deleted the feat/add-sample-rate-to-baggage branch July 1, 2022 13:47
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@adinauer@codecov-commenter@romtsn@marandaneto@lforst@Lms24