Skip to content

Commit 2969cba

Browse files
committed
Add electron not support for stack trace unminification
1 parent 4b840a0 commit 2969cba

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

content/en/real_user_monitoring/guide/monitor-electron-applications-using-browser-sdk.md

+7-4
Original file line numberDiff line numberDiff line change
@@ -24,12 +24,12 @@ To install the Datadog Browser SDK to support Electron apps:
2424

2525
1. Set up and install [RUM Browser Monitoring][2] inside **every renderer process**, following the steps for CDN sync, CDN async, or npm.
2626

27-
2. Set the `sessionPersistence` parameter to `"local-storage"` in the RUM initialization configuration of each renderer process, as shown below.
27+
2. Set the `sessionPersistence` parameter to `"local-storage"` in the RUM initialization configuration of each renderer process, as shown below.
2828

2929
**Note**: This setting allows Datadog to collect RUM data without relying on browser cookies.
30-
30+
3131
- If you are targeting pages **available on the internet** (using the `https://` protocol), you **do not** need this parameter.
32-
- if you are embedding pages **inside your application** (using the `file://` protocol), Datadog needs to store sessions in local storage, as cookies are not available.
32+
- if you are embedding pages **inside your application** (using the `file://` protocol), Datadog needs to store sessions in local storage, as cookies are not available.
3333

3434
```javascript
3535
datadogRum.init({
@@ -40,7 +40,7 @@ To install the Datadog Browser SDK to support Electron apps:
4040
sessionPersistence: "local-storage"
4141
});
4242
```
43-
43+
4444
3. Once you've configured the SDK correctly, your data populates the [RUM Explorer][4].
4545

4646
## Troubleshooting
@@ -50,6 +50,8 @@ The same-origin policy prevents tracking an application for the same session in
5050

5151
This means that an application that uses Electron to embed a landing page, then later redirects the user to a website hosted on the Internet results in two sessions being created for that user - one for the embedded local files (`file://`) landing part of the application, and one for the remote part (`https://` files available on the internet).
5252

53+
**Note**: Unminified stack traces are not available when monitoring Electron applications that load embedded local files (i.e., when stack traces start with `file://`). To obtain unminified stack traces in this scenario, you must manually overwrite them using the [`beforeSend()` callback][2]. For further assistance, please contact [Datadog customer support][5].
54+
5355
### Short-lived sessions for instances with multiple windows at once
5456
An issue with local storage replication latency between windows can cause a short-lived session to be created (<1 second). To work around this, ensure multiple windows are created and initialized with a gap of more than 10 ms.
5557

@@ -60,3 +62,4 @@ An issue with local storage replication latency between windows can cause a shor
6062
[2]: /real_user_monitoring/browser/setup/
6163
[3]: https://www.electronjs.org/docs/latest/tutorial/process-model#the-renderer-process
6264
[4]: /real_user_monitoring/explorer/
65+
[5]: https://www.datadoghq.com/support/

0 commit comments

Comments
 (0)