Skip to content

Commit c3c428f

Browse files
sync: update documentation sources (2026-03-17 19:04 UTC)
1 parent 3a02948 commit c3c428f

6 files changed

Lines changed: 69 additions & 0 deletions

File tree

roblox/common/navigation/analytics.yaml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,8 @@ navigation:
1111
path: /production/analytics/performance
1212
- title: Error report
1313
path: /production/analytics/error-report
14+
- title: Crashes
15+
path: /production/analytics/crashes
1416

1517
- heading: Adjust and experiment
1618
- title: Configs
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
---
2+
title: Server crashes chart
3+
description: Explains how to identify the root cause of server crashes using the Crashes chart and server memory snapshots.
4+
---
5+
6+
The **server crashes chart** and **server out-of-memory snapshots** can help you identify the root cause of server crashes and improve your experience's stability.
7+
8+
When a server detects it is running out of memory, the engine automatically captures a compact `JSON` summary of the data model before the server shuts down. If you see a spike in your server out-of-memory crashes, you can use the chart and memory snapshots to diagnose the issue:
9+
10+
- **Select a snapshot**: Use the server out-of-memory snapshot list to find a crash, then examine memory usage by the latest timestamp, place ID, place version, server version, or server uptime to either find long-term memory leaks or line up the crash with reports from players or your own testing window.
11+
- **Visualize the memory usage**: Click on a snapshot to open the treemap viewer that shows nodes weighted by memory usage. You can drill into nodes to see which services, folders, or assets dominated memory at crash time.
12+
- **Investigate in Studio**: Use the breadcrumbs at the top of the viewer to highlight parent containers that hold potentially bloated assets. With this context, you can jump into Studio to investigate and fix the specific script or asset causing the issue.
13+
14+
<img src="../../assets/analytics/crashes/crashes-chart.png" alt="A view of the server crashes chart." width="100%" />
15+
16+
## Access the chart
17+
18+
To access the server crashes chart, you must either be the experience owner or have [analytics group permissions](../../production/analytics/analytics-dashboard.md#grant-group-permission).
19+
20+
1. Navigate to the [Creations](https://create.roblox.com/dashboard/creations) page on the **Creator Hub**.
21+
2. Under the **Creator Hub** dropdown, select your account or the group that owns the experience.
22+
3. Select the experience.
23+
4. In the **Monitoring** dropdown, select **Crashes**.
24+
25+
## Use the chart
26+
27+
The server crashes chart provides a deep-dive visibility into potential causes for server crashes. Crashes are broken down by crash reason:
28+
29+
- **Out-of-memory crashes** - Servers are crashing due to high memory usage that you can take direct action to fix.
30+
- **Platform crashes** - Servers are crashing due to engine-level errors or corrupted memory when they enter an unrecoverable state. Roblox monitors and takes direct action to fix these crashes.
31+
32+
<Alert severity="info">
33+
If you see a significant uptick in platform crashes, [file a bug report](https://devforum.roblox.com/t/how-to-post-a-bug-report/24388).
34+
</Alert>
35+
36+
You can use the chart's menus to adjust date range, time interval, and annotations, and the **Place** menu to examine individual places rather than the entire experience.
37+
38+
<img src="../../assets/analytics/crashes/crashes-chart-filters.png" alt="A close-up view of the server crashes chart's filters." width="100%" />
39+
40+
Directly below the chart is a list of server out-of-memory snapshots that you can examine either by timestamp, server version, server uptime, place ID, or place version. When you select any of these snapshots, the treemap view displays with nodes weighted by memory usage.
41+
42+
<img src="../../assets/analytics/crashes/memory-snapshot.png" alt="A close-up view of an example snapshot list and open memory snapshot." width="100%" />
43+
44+
To demonstrate how you can use the chart and server out-of-memory snapshots to dianose a memory leak:
45+
46+
1. Review the chart to identify any spikes.
47+
2. Use the **Place** menu to filter by place version so that you can confirm the location of your memory leak.
48+
3. Scroll down to the memory snapshots and examine the list by **Server uptime** to review servers that ran for several hours before hitting the memory limit. This provides evidence of a memory leak.
49+
4. Open the snapshot in the treemap view to highlight the largest nodes.
50+
5. Investigate these nodes in Studio to see where you can add cleanup logic.
51+
52+
<Alert severity="info">
53+
You can also download the raw CSV summary of the memory snapshots for your own analysis, including feeding the data into your favorite LLM or writing your own parsing script.
54+
</Alert>

roblox/en-us/production/analytics/performance.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -136,6 +136,10 @@ The **Server** tab includes the following charts:
136136
</tbody>
137137
</table>
138138

139+
<Alert severity="info">
140+
For a deep dive view on server crashes and out-of-memory snapshots, see [Server crashes chart](crashes.md).
141+
</Alert>
142+
139143
The server CPU and memory charts default to the **Overall** view, but have dropdown menus for individual process groups, such as physics, rendering, and scripts. The sum of these categories is **not** comprehensive; the server performs a small—typically insignificant—amount of additional work per frame that isn't included in any category. As such, the overall millisecond and MB values are slightly lower than reality, but close enough to give you a clear understanding of server performance.
140144

141145
If a category is higher than usual or appears to be taking up a disproportionate amount of time, use the dropdown menu to drill down on the group and identify processes that could be causing issues.

0 commit comments

Comments
 (0)