Skip to content

Commit 60b1a91

Browse files
ref(native): Update various parts of docs, adding 'Store Minidumps As Attachments' section (#12398)
1 parent 6e07826 commit 60b1a91

File tree

15 files changed

+100
-18
lines changed

15 files changed

+100
-18
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
title: "Store Minidumps As Attachments"
3+
description: "Learn how to enable storing minidumps as attachments in issue details."
4+
sidebar_order: 90
5+
---
6+
7+
8+
<Include name="store-minidumps-as-attachments-intro" />
9+
<Include name="store-minidumps-as-attachments-configuration" />

docs/platforms/native/common/enriching-events/attachments/index.mdx

+8-14
Original file line numberDiff line numberDiff line change
@@ -29,20 +29,6 @@ Attachments persist for 30 days; if your total storage included in your quota is
2929

3030
Learn more about how attachments impact your [quota](/pricing/quotas/).
3131

32-
## Crash Reports and Privacy
33-
34-
Crash reports may contain sensitive information about the target system, such as environment variables, local pathnames, or in-memory representations of input fields, including passwords. By default, Sentry only uses crash report files to create events and immediately drops them. All sensitive information is stripped from the resulting events.
35-
36-
All other types of attachments, such as log files or screenshots, are stored for 30 days when sent to Sentry. Note that Sentry does not apply data scrubbing to attachments.
37-
38-
### Enabling Crash Report Storage
39-
40-
You can enable _Store Native Crash Reports_ in your organization's **Security and Privacy Settings**. By default, this setting is disabled. Determine the maximum number of crash reports that will be stored per issue; disabled, unlimited, or maximum per issue:
41-
42-
![Attachments Example](./img/slide-bar-native-crashes.png)
43-
44-
If you set a limit per issue, as in the example above, a limit of 10, Sentry will store the first 10 attachments associated with this issue, but drop any that follow. To make room for additional attachments, delete them. Sentry will then accept attachments until the limit is reached again.
45-
4632
### Access to Attachments
4733

4834
To limit access to attachments, navigate to your organization's **General Settings**, then select the _Attachments Access_ dropdown to set appropriate access — any member of your organization, the organization billing owner, member, admin, manager, or owner.
@@ -51,6 +37,14 @@ To limit access to attachments, navigate to your organization's **General Settin
5137

5238
By default, access is granted to all members when storage is enabled. If a member does not have access to the project, the ability to download an attachment is not available; the button will be greyed out in Sentry. The member may only view that an attachment is stored.
5339

40+
## Store Minidumps as Attachments
41+
42+
<Include name="store-minidumps-as-attachments-intro" />
43+
44+
<Alert level="note">☝ This feature is supported on Windows, Linux, and Android.</Alert>
45+
46+
<Include name="store-minidumps-as-attachments-configuration" />
47+
5448
## Viewing Attachments
5549

5650
Attachments display on the bottom of the **Issue Details** page for the event that is shown.

docs/platforms/native/guides/minidumps/index.mdx

+5
Original file line numberDiff line numberDiff line change
@@ -123,3 +123,8 @@ uploads. These limits are subject to future change and defined currently as:
123123
- _100MB_ for all files combined
124124
- _100MB_ for each file individually
125125
- _1MB_ for event payloads
126+
127+
## Store Minidumps as Attachments
128+
129+
<Include name="store-minidumps-as-attachments-intro" />
130+
<Include name="store-minidumps-as-attachments-configuration" />
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: "Store Minidumps As Attachments"
3+
description: "Learn how to enable storing minidumps as attachments in issue details."
4+
sidebar_order: 90
5+
---
6+
7+
<Include name="store-minidumps-as-attachments-intro" />
8+
9+
<Alert level="note">☝ This feature is supported on Windows, Linux, and Android.</Alert>
10+
11+
<Include name="store-minidumps-as-attachments-configuration" />

docs/platforms/unity/enriching-events/attachments/index.mdx

+8
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,14 @@ To limit access to attachments, navigate to your organization's **General Settin
7171

7272
By default, access is granted to all members when storage is enabled. If a member does not have access to the project, the ability to download an attachment is not available; the button will be greyed out in Sentry. The member may only view that an attachment is stored.
7373

74+
## Store Minidumps as Attachments
75+
76+
<Include name="store-minidumps-as-attachments-intro" />
77+
78+
<Alert level="note">☝ This feature is supported on Windows, Linux, and Android.</Alert>
79+
80+
<Include name="store-minidumps-as-attachments-configuration" />
81+
7482
## Viewing Attachments
7583

7684
Attachments display on the bottom of the **Issue Details** page for the event that is shown.

docs/platforms/unity/native-support/index.mdx

+8
Original file line numberDiff line numberDiff line change
@@ -74,3 +74,11 @@ If you don't want to rely on the automated symbol upload, you can run `sentry-cl
7474
```bash
7575
sentry-cli --auth-token ___ORG_AUTH_TOKEN___ debug-files upload --org ___ORG_SLUG___ --project ___PROJECT_SLUG___ PATH_TO_SYMBOLS
7676
```
77+
78+
## Store Minidumps as Attachments
79+
80+
<Include name="store-minidumps-as-attachments-intro" />
81+
82+
<Alert level="note">☝ This feature is supported on Windows, Linux, and Android.</Alert>
83+
84+
<Include name="store-minidumps-as-attachments-configuration" />

docs/platforms/unreal/configuration/setup-crashreporter/index.mdx

+8
Original file line numberDiff line numberDiff line change
@@ -174,3 +174,11 @@ are subject to future change and defined currently as:
174174
## Issues With the Crash Reporter
175175

176176
Check out this community-generated [thread in Sentry's forum](https://forum.sentry.io/t/unreal-engine-crash-reporter-cant-get-it-to-work/7643) for UE Crash Reporter troubleshooting tips and solutions.
177+
178+
## Store Minidumps as Attachments
179+
180+
<Include name="store-minidumps-as-attachments-intro" />
181+
182+
<Alert level="note">☝ This feature is supported on Windows, Linux, and Android.</Alert>
183+
184+
<Include name="store-minidumps-as-attachments-configuration" />
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: "Store Minidumps As Attachments"
3+
description: "Learn about to store minidumps as attachments for improved processing and download in issue details."
4+
sidebar_order: 90
5+
---
6+
7+
8+
<Include name="store-minidumps-as-attachments-intro" />
9+
10+
<Alert level="note">☝ This feature is supported on Windows, Linux, and Android.</Alert>
11+
12+
<Include name="store-minidumps-as-attachments-configuration" />

docs/platforms/unreal/enriching-events/attachments/index.mdx

+8
Original file line numberDiff line numberDiff line change
@@ -112,6 +112,14 @@ To limit access to attachments, navigate to your organization's **General Settin
112112
113113
By default, access is granted to all members when storage is enabled. If a member does not have access to the project, the ability to download an attachment is not available; the button will be greyed out in Sentry. The member may only view that an attachment is stored.
114114
115+
## Store Minidumps as Attachments
116+
117+
<Include name="store-minidumps-as-attachments-intro" />
118+
119+
<Alert level="note">☝ This feature is supported on Windows, Linux, and Android.</Alert>
120+
121+
<Include name="store-minidumps-as-attachments-configuration" />
122+
115123
## Viewing Attachments
116124
117125
Attachments display on the bottom of the **Issue Details** page for the event that is shown.

docs/platforms/unreal/index.mdx

+12-4
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Don't already have an account and Sentry project established? Head over to [sent
3434

3535
## Install
3636

37-
Sentry captures data by using an SDK within your application’s runtime.
37+
Sentry captures data by using an SDK within your application’s runtime.
3838

3939
The Unreal Engine (UE) SDK is officially supported for the three latest UE versions. However, it is likely to be compatible with older engine versions as well depending on the specific features and functionality that you need.
4040

@@ -57,9 +57,9 @@ The table below highlights some key differences between different versions of th
5757
| `on_crash` hook (Windows) | Supported | Not supported | Supported |
5858
| Sentry CLI ** | Included | Manual download | Included |
5959

60-
Legend:
61-
`*`: Recommended version of the SDK
62-
`**`: Sentry CLI is a standalone tool that the plugin uses under the hood to automatically upload debug information files upon game build completion.
60+
Legend:
61+
`*`: Recommended version of the SDK
62+
`**`: Sentry CLI is a standalone tool that the plugin uses under the hood to automatically upload debug information files upon game build completion.
6363

6464
### Installing from GitHub Releases (Recommended)
6565

@@ -163,3 +163,11 @@ Learn more about manually capturing an error or message in our <PlatformLink to=
163163
</Note>
164164

165165
To view and resolve the recorded error, log into [sentry.io](https://sentry.io) and select your project. Clicking on the error's title will open a page where you can see detailed information and mark it as resolved.
166+
167+
## Store Minidumps as Attachments
168+
169+
<Include name="store-minidumps-as-attachments-intro" />
170+
171+
<Alert level="note">☝ This feature is supported on Windows, Linux, and Android.</Alert>
172+
173+
<Include name="store-minidumps-as-attachments-configuration" />
Loading
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
![Store Minidumps as Attachments Configuration Example](./img/store-minidumps-as-attachments.png)
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
### Enabling Minidump Storage
2+
3+
You can enable _Store Minidumps As Attachments_ in your organization or project settings under **Security & Privacy**. By default, this setting is disabled. Determine the maximum number of crash reports that will be stored per issue; disabled, unlimited, or maximum per issue:
4+
5+
<Include name="common-imgs/store-minidumps-as-attachments" />
6+
7+
If you set a limit per issue, as in the example above, a limit of 5, Sentry will store the first 5 attachments associated with this issue, but drop any that follow. To make room for additional attachments, delete them. Sentry will then accept attachments until the limit is reached again.
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
Minidumps may contain sensitive information about the target system, such as environment variables, local pathnames, or in-memory representations of input fields, including passwords. By default, Sentry only uses minidump files to create events and immediately drops them. All sensitive information is stripped from the resulting events.
2+
3+
All other types of attachments, such as log files or screenshots, are stored for 30 days when sent to Sentry. Note that Sentry does not apply data scrubbing to attachments.

0 commit comments

Comments
 (0)