|
| 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> |
0 commit comments