Skip to content
Sentry SDK for Unity3d
C#
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Assets
Packages ref: default to editor 2018.3 Oct 22, 2018
ProjectSettings
.editorconfig ref: .editorconfig matching sentry-dotnet SDK Oct 15, 2018
.gitignore
LICENSE ref: Licensed by Sentry Oct 11, 2018
README.md chore: Discord badge Sep 12, 2019

README.md

Using Sentry in Unity

Usage

In order to make Sentry work, you need to add SentrySdk component to any GameObject that is in the first loaded scene of the game.

You can also add it programatically. There can only be one SentrySdk in your whole project. To add it programatically do:

var sentry = myGameObject.AddComponent(typeof(SentrySdk)) as SentrySdk;
sentry.dsn = "__YOUR_DSN__";

The SDK needs to know which project within Sentry your errors should go to. That's defined via the DSN. DSN is the only obligatory parameter on SentrySdk object.

This is enough to capture automatic traceback events from the game. They will be sent to your DSN and you can find them at sentry.io

Example

There is an example scene in the Sentry asset. It has two components - SentrySdk and SentryTest. SentryTest is a component that handles button presses to crash or fail assert. SentrySdk is the main component that you have to use in your own project.

API

The basic API is automatic collection of test failures, so it should mostly run headless. There are two important APIs that are worth considering.

  • collecting breadcrumbs

    SentrySdk.AddBreadcrumb(string)

    will collect a breadcrumb.

  • sending messages

    SentrySdk.CaptureMessage(string)

    would send a message to Sentry.

Unity version

The lowest required version is Unity 5.6. Previous versions might work but were not tested and will not be supported.

Resources

You can’t perform that action at this time.