Java

On this page, we get you up and running with Sentry's SDK, so that it will automatically report errors and exceptions in your application.

Using a framework or logging library? Take a look at our specific guides to get started.

Install

Sentry captures data by using an SDK within your application’s runtime.

build.gradle
Copied
// Make sure jcenter or mavenCentral is there.
repositories {
    jcenter()
    // Or
    mavenCentral()
}

// Add Sentry's SDK as a dependency.
dependencies {
    implementation 'io.sentry:sentry:3.1.0'
}

Configure

Configuration should happen as early as possible in your application's lifecycle.

Copied
import io.sentry.Sentry;

Sentry.init(options -> {
  options.setDsn("https://examplePublicKey@o0.ingest.sentry.io/0");
});

Verify

This snippet includes an intentional error, so you can test that everything is working as soon as you set it up:

Copied
import java.lang.Exception;
import io.sentry.Sentry;

try {
    throw new Exception("This is a test.");
} catch (Exception e) {
    Sentry.captureException(e);
}

Or, by manually generating an event:

In Java you can capture any exception object that you caught:

Copied
import io.sentry.Sentry;

try {
  aMethodThatMightFail();
} catch(Exception e) {
  Sentry.captureException(e);
}

To view and resolve the recorded error, log into sentry.io and open your project. Clicking on the error's title will open a page where you can see detailed information and mark it as resolved.

You can edit this page on GitHub.