You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: Remove generic references from Java and Kotlin (#15076)
Remove generic references or plural references to SDKs in the Java and Kotlin SDK docs.
---------
Co-authored-by: Alexander Dinauer <[email protected]>
Copy file name to clipboardExpand all lines: docs/platforms/java/common/configuration/draining.mdx
+1-2Lines changed: 1 addition & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,6 @@ sidebar_order: 70
4
4
description: "Learn more about the default behavior of our SDK if the application shuts down unexpectedly."
5
5
---
6
6
7
-
The default behavior of most SDKs is to send out events over the network
8
-
asynchronously in the background. This means that some events might be lost if the application shuts down unexpectedly. The SDKs provide mechanisms to cope with this.
7
+
By default the SDK sends out events over the network on a background thread. This means that some events might be lost if the application shuts down unexpectedly. The SDK provides mechanisms to cope with this.
When the SDK creates an event or breadcrumb for transmission, that transmission is typically created from some sort of source object. For instance, an error event is typically created from a log record or exception instance. For better customization, SDKs send these objects to certain callbacks (<PlatformIdentifiername="before-send" />, <PlatformIdentifiername="before-breadcrumb" /> or the event processor system in the SDK).
41
+
When the SDK creates an event or breadcrumb for transmission, that transmission is typically created from some sort of source object. For instance, an error event is typically created from a log record or exception instance. For better customization, the SDK sends these objects to certain callbacks (<PlatformIdentifiername="before-send" />, <PlatformIdentifiername="before-breadcrumb" /> and event processors).
42
42
43
43
### Using Hints
44
44
@@ -51,7 +51,7 @@ Event and breadcrumb `hints` are objects containing various information used to
51
51
52
52
For events, hints contain properties such as `event_id`, `originalException`, `syntheticException` (used internally to generate cleaner stack trace), and any other arbitrary `data` that you attach.
53
53
54
-
For breadcrumbs, the use of `hints`is implementation dependent. For XHR requests, the hint contains the xhr object itself; for user interactions the hint contains the DOM element and event name and so forth.
54
+
For breadcrumbs, the use of `hints`depends on the type of breadcrumb.
Copy file name to clipboardExpand all lines: docs/platforms/java/common/configuration/options.mdx
+5-11Lines changed: 5 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -102,12 +102,6 @@ Note that enabling this option may increase the payload size of events sent to S
102
102
103
103
If this flag is enabled, certain personally identifiable information (PII) is added by active integrations. By default, no such data is sent.
104
104
105
-
<Alert>
106
-
107
-
If you are using Sentry in your mobile app, read our [frequently asked questions about mobile data privacy](/security-legal-pii/security/mobile-privacy/) to assist with Apple App Store and Google Play app privacy details.
108
-
109
-
</Alert>
110
-
111
105
This option is turned off by default.
112
106
113
107
If you enable this option, be sure to manually remove what you don't want to send using our features for managing [_Sensitive Data_](../../data-management/sensitive-data/).
@@ -204,21 +198,21 @@ These options can be used to hook the SDK in various ways to customize the repor
204
198
205
199
<ConfigKeyname="before-send">
206
200
207
-
This function is called with an SDK-specific message or error event object, and can return a modified event object, or `null` to skip reporting the event. This can be used, for instance, for manual PII stripping before sending.
201
+
This function is called with the event payload, and can return a modified event object, or `null` to skip reporting the event. This can be used, for instance, for manual PII stripping before sending.
208
202
209
203
By the time <PlatformIdentifiername="before-send" /> is executed, all scope data has already been applied to the event. Further modification of the scope won't have any effect.
210
204
211
205
</ConfigKey>
212
206
213
207
<ConfigKeyname="before-send-transaction">
214
208
215
-
This function is called with an SDK-specific transaction event object, and can return a modified transaction event object, or `null` to skip reporting the event. One way this might be used is for manual PII stripping before sending.
209
+
This function is called with a transaction event object, and can return a modified transaction event object, or `null` to skip reporting the event. One way this might be used is for manual PII stripping before sending.
216
210
217
211
</ConfigKey>
218
212
219
213
<ConfigKeyname="before-breadcrumb">
220
214
221
-
This function is called with an SDK-specific breadcrumb object before the breadcrumb is added to the scope. When nothing is returned from the function, the breadcrumb is dropped. To pass the breadcrumb through, return the first argument, which contains the breadcrumb object.
215
+
This function is called with a breadcrumb object before the breadcrumb is added to the scope. When nothing is returned from the function, the breadcrumb is dropped. To pass the breadcrumb through, return the first argument, which contains the breadcrumb object.
222
216
The callback typically gets a second argument (called a "hint") which contains the original object from which the breadcrumb was created to further customize what the breadcrumb should look like.
223
217
224
218
</ConfigKey>
@@ -235,7 +229,7 @@ Transports are used to send events to Sentry. Transports can be customized to so
235
229
236
230
<ConfigKeyname="transport">
237
231
238
-
Switches out the transport used to send events. How this works depends on the SDK. It can, for instance, be used to capture events for unit-testing or to send it through some more complex setup that requires proxy authentication.
232
+
Switches out the transport used to send events. It can, for instance, be used to capture events for unit-testing or to send it through some more complex setup that requires proxy authentication.
239
233
240
234
</ConfigKey>
241
235
@@ -247,7 +241,7 @@ When set, a proxy can be configured that should be used for outbound requests. T
247
241
248
242
<ConfigKeyname="shutdown-timeout-millis">
249
243
250
-
Controls how many seconds to wait before shutting down. Sentry SDKs send events from a background queue. This queue is given a certain amount to drain pending events. The default is SDK specific but typically around two seconds. Setting this value too low may cause problems for sending events from command line applications. Setting the value too high will cause the application to block for a long time for users experiencing network connectivity problems.
244
+
Controls how many seconds to wait before shutting down. The SDK sends events from a background queue. This queue is given a certain amount to drain pending events. The default is two seconds. Setting this value too low may cause problems for sending events from command line applications. Setting the value too high will cause the application to block for a long time for users experiencing network connectivity problems.
Copy file name to clipboardExpand all lines: docs/platforms/java/common/configuration/sampling.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -60,7 +60,7 @@ By default, none of these options are set, meaning no transactions will be sent
60
60
61
61
### Default Sampling Context Data
62
62
63
-
The information contained in the <PlatformIdentifiername="sampling-context" /> object passed to the <PlatformIdentifiername="traces-sampler" /> when a transaction is created varies by platform and integration.
63
+
The information contained in the <PlatformIdentifiername="sampling-context" /> object passed to the <PlatformIdentifiername="traces-sampler" /> when a transaction is created varies by integration.
Copy file name to clipboardExpand all lines: docs/platforms/java/common/data-management/sensitive-data/index.mdx
+3-5Lines changed: 3 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,21 +19,19 @@ These are some great examples for data scrubbing that every company should think
19
19
20
20
We offer the following options depending on your legal and operational needs:
21
21
22
-
- filtering or scrubbing sensitive data within the SDK, so that data is _not sent to_ Sentry. Different SDKs have different capabilities, and configuration changes require a redeployment of your application.
22
+
- filtering or scrubbing sensitive data within the SDK, so that data is _not sent to_ Sentry. Configuration changes require a redeployment of your application.
23
23
-[configuring server-side scrubbing](/security-legal-pii/scrubbing/server-side-scrubbing/) to ensure Sentry does _not store_ data. Configuration changes are done in the Sentry UI and apply immediately for new events.
24
24
-[running a local Relay](/product/relay/) on your own server between the SDK and Sentry, so that data is _not sent to_ Sentry while configuration can still be applied without deploying.
25
25
26
26
<Alert>
27
27
28
28
Ensure that your team is aware of your company's policy around what can and cannot be sent to Sentry. We recommend determining this policy early in your implementation and communicating it as well as enforcing it via code review.
29
29
30
-
If you are using Sentry in your mobile app, read our [frequently asked questions about mobile data privacy](/security-legal-pii/security/mobile-privacy/) to assist with Apple App Store and Google Play app privacy details.
31
-
32
30
</Alert>
33
31
34
32
## Personally Identifiable Information (PII)
35
33
36
-
Our newer SDKs do not purposefully send PII to stay on the safe side. This behavior is controlled by an option called [`send-default-pii`](../../configuration/options/#send-default-pii).
34
+
The SDK purposefully does not send PII to stay on the safe side. This behavior is controlled by an option called [`send-default-pii`](../../configuration/options/#send-default-pii).
37
35
38
36
Turning this option on is required for certain features in Sentry to work, but also means you will need to be even more careful about what data is being sent to Sentry (using the options below).
39
37
@@ -43,7 +41,7 @@ If you _do not_ wish to use the default PII behavior, you can also choose to ide
SDKs provide a <PlatformIdentifiername="before-send" /> hook, which is invoked before an error or message event is sent and can be used to modify event data to remove sensitive information. Some SDKs also provide a <PlatformIdentifiername="before-send-transaction" /> hook which does the same thing for transactions. We recommend using <PlatformIdentifiername="before-send" /> and <PlatformIdentifiername="before-send-transaction" /> in the SDKs to **scrub any data before it is sent**, to ensure that sensitive data never leaves the local environment.
44
+
The SDK provides a <PlatformIdentifiername="before-send" /> hook, which is invoked before an error or message event is sent and can be used to modify event data to remove sensitive information. The SDK also provide a <PlatformIdentifiername="before-send-transaction" /> hook which does the same thing for transactions. We recommend using <PlatformIdentifiername="before-send" /> and <PlatformIdentifiername="before-send-transaction" /> in the SDK to **scrub any data before it is sent**, to ensure that sensitive data never leaves the local environment.
Copy file name to clipboardExpand all lines: docs/platforms/java/common/enriching-events/breadcrumbs/index.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,7 +29,7 @@ Manually record a breadcrumb:
29
29
30
30
SDKs allow you to customize breadcrumbs through the <PlatformIdentifiername="before-breadcrumb" /> hook.
31
31
32
-
This hook is passed an already assembled breadcrumb and, in some SDKs, an optional hint. The function can modify the breadcrumb or decide to discard it entirely by returning `null`:
32
+
This hook is passed an already assembled breadcrumb and <PlatformLinkto="/configuration/filtering/#using-hints">a `hint` object</PlatformLink> containing extra metadata. The function can modify the breadcrumb or decide to discard it entirely by returning `null`:
Copy file name to clipboardExpand all lines: docs/platforms/java/common/enriching-events/context/index.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,7 +29,7 @@ Learn more about conventions for common contexts in the [contexts interface deve
29
29
30
30
When sending context, _consider payload size limits_. Sentry does not recommend sending the entire application state and large data blobs in contexts. If you exceed the maximum payload size, Sentry will respond with HTTP error `413 Payload Too Large` and reject the event.
31
31
32
-
The Sentry SDK will try its best to accommodate the data you send and trim large context payloads. Some SDKs can truncate parts of the event; for more details, see the [developer documentation on SDK data handling](https://develop.sentry.dev/sdk/expected-features/data-handling/).
32
+
The Sentry SDK will try its best to accommodate the data you send and trim large context payloads. The SDK can truncate parts of the event; for more details, see the [developer documentation on SDK data handling](https://develop.sentry.dev/sdk/expected-features/data-handling/).
Copy file name to clipboardExpand all lines: docs/platforms/java/common/enriching-events/identify-user/index.mdx
+2-4Lines changed: 2 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,11 +22,9 @@ An alternative, or addition, to the username. Sentry is aware of email addresses
22
22
### `ip_address`
23
23
24
24
The user's IP address. If the user is unauthenticated, Sentry uses the IP address as a unique identifier for the user.
25
-
Serverside SDKs that instrument incoming requests will attempt to pull the IP address from the HTTP request data (`request.env.REMOTE_ADDR` field in JSON), if available. That might require <PlatformIdentifiername="send-default-pii" /> set to `true` in the SDK options.
25
+
The SDK will attempt to pull the IP address from the HTTP request data on incoming requests (`request.env.REMOTE_ADDR` field in JSON), if available. That requires <PlatformIdentifiername="send-default-pii" /> set to `true` in the SDK options.
26
26
27
-
If the user's `ip_address` is set to `"{{auto}}"`, Sentry will infer the IP address from the connection between your app and Sentry's server.
28
-
29
-
If the field is omitted, the default value is `null`. However, due to backwards compatibility concerns, certain platforms (in particular JavaScript) have a different default value for `"{{auto}}"`. SDKs and other clients should not rely on this behavior and should set IP addresses or `"{{auto}}"` explicitly.
27
+
If the user's `ip_address` is set to `"{{auto}}"`, Sentry will infer the IP address from the connection between your app and Sentry's server. If the field is omitted, the default value is `null`.
30
28
31
29
To opt out of storing users' IP addresses in your event data, you can go to your project settings, click on "Security & Privacy", and enable "Prevent Storing of IP Addresses" or use Sentry's [server-side data](/security-legal-pii/scrubbing/) scrubbing to remove `$user.ip_address`. Adding such a rule ultimately overrules any other logic.
Copy file name to clipboardExpand all lines: docs/platforms/java/common/enriching-events/scopes/index.mdx
+2-3Lines changed: 2 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,10 @@
1
1
---
2
2
title: Scopes
3
-
description: "SDKs will typically automatically manage the scopes for you in the framework integrations. Learn what a scope is and how you can use it to your advantage."
3
+
description: "The SDK will in most cases automatically manage the scopes for you in the framework integrations. Learn what a scope is and how you can use it to your advantage."
4
4
---
5
5
6
6
When an event is captured and sent to Sentry, SDKs will merge that event data with extra
7
-
information from the current scope. SDKs will typically automatically manage the scopes
8
-
for you in the framework integrations and you don't need to think about them. However,
7
+
information from the current scope. The SDK will in most cases automatically manage the scopes for you in the framework integrations and you don't need to think about them. However,
9
8
you should know what a scope is and how you can use it to your advantage.
Copy file name to clipboardExpand all lines: docs/platforms/java/common/enriching-events/scopes/index__v7.x.mdx
+2-3Lines changed: 2 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,10 @@
1
1
---
2
2
title: Scopes and Hubs
3
-
description: "SDKs will typically automatically manage the scopes for you in the framework integrations. Learn what a scope is and how you can use it to your advantage."
3
+
description: "The SDK will in most cases automatically manage the scopes for you in the framework integrations. Learn what a scope is and how you can use it to your advantage."
4
4
---
5
5
6
6
When an event is captured and sent to Sentry, SDKs will merge that event data with extra
7
-
information from the current scope. SDKs will typically automatically manage the scopes
8
-
for you in the framework integrations and you don't need to think about them. However,
7
+
information from the current scope. The SDK will in most cases automatically manage the scopes for you in the framework integrations and you don't need to think about them. However,
9
8
you should know what a scope is and how you can use it for your advantage.
0 commit comments