Hi Creators,
Today, we are excited to launch two new real-time analytics updates to help you improve your experiences:
- Error report: View up-to-the-minute errors and warnings for both server and client. Filter by place and severity, search by keyword, and even see stack traces to troubleshoot errors.
- Client performance metrics: View up-to-the-minute client metrics (crash rates, frame rates, and memory usage) to spot performance issues early.
You can find your Error Report and Performance pages in the Real-Time section of the Creator Dashboard.
Visit your error report to troubleshoot issues
To view your experience’s error report (e.g., after releasing a new update):
- Navigate to your Creator Dashboard and select your experience.
- Select Error Report in the Real-Time section.
You can update your error report as follows:
- Change the date range
- Turn on/off version annotations in the chart
- Filter to errors or warnings only
- Filter by place
- Search by keyword
Based on your updates above, you’ll see a chart that shows up-to-the-minute errors and warnings split by server and client.
Below the chart, you’ll see a table that shows your experience’s errors and warnings by count. You can view stack traces and other details for select errors and warnings by clicking a row that has a down arrow. A stack trace is a list of method calls that your experience was in the middle of when an exception was thrown.
Error reports are available to all creators with published experiences. For more, check out our error report docs.
Monitor your client performance (crash rates, frame rates, and memory usage)
To view your experience’s client metrics:
- Navigate to your Creator Dashboard and select your experience.
- Select Performance in the Real-Time section.
Scroll down on the page to see your:
- Client frame rates: Frames per second processed by each client. Large drops may signal issues.
- Client crash rates: Sessions ended in crashes as a percentage of the total sessions ended. Large spikes may signal issues.
- Client memory usage: Memory consumed by client. Large spikes may signal issues.
- Client memory usage percentage: Percent of available memory consumed by the client relative to available client memory. Large spikes may signal issues.
Note that these charts can be noisy for experiences with low user counts. Your experience needs at least 100 daily active users (corresponds to a few concurrent users) to see these charts.
Troubleshooting client performance issues
If you identify a performance issue, use the following steps to debug and fix it:
-
Check your recent update and consider rolling it back if the metrics impact is severe.
-
Use built-in testing tools to troubleshoot performance:
a. Developer Console for viewing error and log messages and detailed information on memory and networking.
b. ScriptProfiler: for identifying scripts that take up the most resources.
c. MicroProfiler for viewing unoptimized portions of your experience visually. -
Gather user feedback from your community.
For more, check out our performance page docs.
Build analytics with the community
We’d love to build analytics closely with all of you. If you’d like to preview upcoming analytics features and give feedback, please fill out this quick form and we’ll get back to you.
Please let us know if you have any questions about today’s launch.
Thank you.