Setting up Cloud Diagnostics

Before you can enable the Cloud Diagnostics service, you must set up your Project for Unity Services.

The Cloud Diagnostics service consists of two features:

• Crash and Exception Reporting
• User Reporting

To use Crash and Exception Reporting, you must explicitly enable it as shown in the How to enable crash and exception reporting section.

How to enable User Reporting for Cloud Diagnostics

To use User Reporting you must integrate the SDK with your app. You have the option of starting with the built-in user report Prefab or creating your own custom User Reporting UI. For more information on creating a custom User Reporting UI, see the "Advanced reporting features" section in User reports topic.

To add User Reporting to your app for Editor versions 2018.2 and earlier:

1. Open the Editor and select your Project.
2. Add the UserReporting directory to your Project’s Asset directory.
3. Download the SDK, and extract the packages.
4. In the Unity Editor, open your the Project that you are adding User Reporting to.
5. Open the location where you have the userreporting packages stored, and drag the appropriate package into your Assets folder in the Editor.
6. In the Import Unity Package dialog, click the Import button.

To add User Reporting to your app for Editor versions 2018.3 and later.

1. Open the Editor and select your Project.
2. Install the Unity User Reporting preview Package as shown in the Unity Package Manager documentation.
3. From the Window menu, select User Reporting and then click Import Packages.
4. In the Import Unity Package dialog, click the Import button.

To add the built-in user report Prefab to your app:

1. In your Project, open the Scene.
2. In your Assets folder, open the UserReporting folder and then select the Prefabs folder.
3. Drag the UserReportingPrefab into your Scene.

How to enable crash and exception reporting for Cloud Diagnostics

To enable Cloud Diagnostics:

1. In the Unity Editor menu bar, select Window > General > Services to open the Services window.
2. In the Services window, select Cloud Diagnostics.
3. Click the black toggle to turn on the service. It turns blue when it is on.

When Cloud Diagnostics are enabled, you can set number of debug log messages to include in crash reports.