io.sentry.core

Class Sentry

java.lang.Object

io.sentry.core.Sentry

public final class Sentry
extends java.lang.Object

Sentry SDK main API entry point

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Sentry.OptionsConfiguration<T extends SentryOptions> Configuration options callback

Method Summary

Modifier and Type	Method and Description
static void	addBreadcrumb(@NotNull Breadcrumb breadcrumb) Adds a breadcrumb to the current Scope
static void	addBreadcrumb(@NotNull Breadcrumb breadcrumb, @Nullable java.lang.Object hint) Adds a breadcrumb to the current Scope
static void	addBreadcrumb(@NotNull java.lang.String message) Adds a breadcrumb to the current Scope
static void	addBreadcrumb(@NotNull java.lang.String message, @NotNull java.lang.String category) Adds a breadcrumb to the current Scope
static void	bindClient(@NotNull ISentryClient client) Binds a different client to the current hub
static @NotNull SentryId	captureEvent(@NotNull SentryEvent event) Captures the event.
static @NotNull SentryId	captureEvent(@NotNull SentryEvent event, @Nullable java.lang.Object hint) Captures the event.
static @NotNull SentryId	captureException(@NotNull java.lang.Throwable throwable) Captures the exception.
static @NotNull SentryId	captureException(@NotNull java.lang.Throwable throwable, @Nullable java.lang.Object hint) Captures the exception.
static @NotNull SentryId	captureMessage(@NotNull java.lang.String message) Captures the message.
static @NotNull SentryId	captureMessage(@NotNull java.lang.String message, @NotNull SentryLevel level) Captures the message.
static void	clearBreadcrumbs() Deletes current breadcrumbs from the current scope.
static void	close() Close the SDK
static void	configureScope(@NotNull ScopeCallback callback) Configures the scope through the callback.
static void	endSession() Ends the current session
static void	flush(long timeoutMillis) Flushes events queued up to the current hub.
static @NotNull SentryId	getLastEventId() Last event id recorded in the current scope
static void	init() Initializes the SDK
static <T extends SentryOptions> void	init(@NotNull OptionsContainer<T> clazz, @NotNull Sentry.OptionsConfiguration<T> optionsConfiguration) Initializes the SDK
static <T extends SentryOptions> void	init(@NotNull OptionsContainer<T> clazz, @NotNull Sentry.OptionsConfiguration<T> optionsConfiguration, boolean globalHubMode) Initializes the SDK
static void	init(@NotNull Sentry.OptionsConfiguration<SentryOptions> optionsConfiguration) Initializes the SDK with an optional configuration options callback.
static void	init(@NotNull Sentry.OptionsConfiguration<SentryOptions> optionsConfiguration, boolean globalHubMode) Initializes the SDK with an optional configuration options callback.
static boolean	isEnabled() Check if the current Hub is enabled/active.
static void	popScope() Removes the first scope
static void	pushScope() Pushes a new scope while inheriting the current scope's data.
static void	removeExtra(@NotNull java.lang.String key) Removes the extra key to an arbitrary value to the current Scope
static void	removeTag(@NotNull java.lang.String key) Removes the tag to a string value to the current Scope
static void	setExtra(@NotNull java.lang.String key, @NotNull java.lang.String value) Sets the extra key to an arbitrary value to the current Scope, overwriting a potential previous value
static void	setFingerprint(@NotNull java.util.List<java.lang.String> fingerprint) Sets the fingerprint to group specific events together to the current Scope.
static void	setLevel(@Nullable SentryLevel level) Sets the level of all events sent within current Scope
static void	setTag(@NotNull java.lang.String key, @NotNull java.lang.String value) Sets the tag to a string value to the current Scope, overwriting a potential previous value
static void	setTransaction(@Nullable java.lang.String transaction) Sets the name of the current transaction to the current Scope.
static void	setUser(@Nullable User user) Shallow merges user configuration (email, username, etc) to the current Scope.
static void	startSession() Starts a new session.
static void	withScope(@NotNull ScopeCallback callback) Runs the callback with a new scope which gets dropped at the end

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

isEnabled

public static boolean isEnabled()

Check if the current Hub is enabled/active.

Returns:

true if its enabled or false otherwise.

init

public static void init()

Initializes the SDK

init

public static <T extends SentryOptions> void init(@NotNull
                                                  @NotNull OptionsContainer<T> clazz,
                                                  @NotNull
                                                  @NotNull Sentry.OptionsConfiguration<T> optionsConfiguration)
                                           throws java.lang.IllegalAccessException,
                                                  java.lang.InstantiationException,
                                                  java.lang.NoSuchMethodException,
                                                  java.lang.reflect.InvocationTargetException

Initializes the SDK

Type Parameters:

T - class that extends SentryOptions

Parameters:

clazz - OptionsContainer for SentryOptions

optionsConfiguration - configuration options callback

Throws:

java.lang.IllegalAccessException - the IllegalAccessException

java.lang.InstantiationException - the InstantiationException

java.lang.NoSuchMethodException - the NoSuchMethodException

java.lang.reflect.InvocationTargetException - the InvocationTargetException

init

public static <T extends SentryOptions> void init(@NotNull
                                                  @NotNull OptionsContainer<T> clazz,
                                                  @NotNull
                                                  @NotNull Sentry.OptionsConfiguration<T> optionsConfiguration,
                                                  boolean globalHubMode)
                                           throws java.lang.IllegalAccessException,
                                                  java.lang.InstantiationException,
                                                  java.lang.NoSuchMethodException,
                                                  java.lang.reflect.InvocationTargetException

Initializes the SDK

Type Parameters:

T - class that extends SentryOptions

Parameters:

clazz - OptionsContainer for SentryOptions

optionsConfiguration - configuration options callback

globalHubMode - the globalHubMode

Throws:

java.lang.IllegalAccessException - the IllegalAccessException

java.lang.InstantiationException - the InstantiationException

java.lang.NoSuchMethodException - the NoSuchMethodException

java.lang.reflect.InvocationTargetException - the InvocationTargetException

init

public static void init(@NotNull
                        @NotNull Sentry.OptionsConfiguration<SentryOptions> optionsConfiguration)

Initializes the SDK with an optional configuration options callback.

Parameters:

optionsConfiguration - configuration options callback

init

public static void init(@NotNull
                        @NotNull Sentry.OptionsConfiguration<SentryOptions> optionsConfiguration,
                        boolean globalHubMode)

Initializes the SDK with an optional configuration options callback.

Parameters:

optionsConfiguration - configuration options callback

globalHubMode - the globalHubMode

close

public static void close()

Close the SDK

captureEvent

@NotNull
public static @NotNull SentryId captureEvent(@NotNull
                                                      @NotNull SentryEvent event)

Captures the event.

Parameters:

event - the event

Returns:

The Id (SentryId object) of the event

captureEvent

@NotNull
public static @NotNull SentryId captureEvent(@NotNull
                                                      @NotNull SentryEvent event,
                                                      @Nullable
                                                      @Nullable java.lang.Object hint)

Captures the event.

Parameters:

event - the event

hint - SDK specific but provides high level information about the origin of the event

Returns:

The Id (SentryId object) of the event

captureMessage

@NotNull
public static @NotNull SentryId captureMessage(@NotNull
                                                        @NotNull java.lang.String message)

Captures the message.

Parameters:

message - The message to send.

Returns:

The Id (SentryId object) of the event

captureMessage

@NotNull
public static @NotNull SentryId captureMessage(@NotNull
                                                        @NotNull java.lang.String message,
                                                        @NotNull
                                                        @NotNull SentryLevel level)

Captures the message.

Parameters:

message - The message to send.

level - The message level.

Returns:

The Id (SentryId object) of the event

captureException

@NotNull
public static @NotNull SentryId captureException(@NotNull
                                                          @NotNull java.lang.Throwable throwable)

Captures the exception.

Parameters:

throwable - The exception.

Returns:

The Id (SentryId object) of the event

captureException

@NotNull
public static @NotNull SentryId captureException(@NotNull
                                                          @NotNull java.lang.Throwable throwable,
                                                          @Nullable
                                                          @Nullable java.lang.Object hint)

Captures the exception.

Parameters:

throwable - The exception.

hint - SDK specific but provides high level information about the origin of the event

Returns:

The Id (SentryId object) of the event

addBreadcrumb

public static void addBreadcrumb(@NotNull
                                 @NotNull Breadcrumb breadcrumb,
                                 @Nullable
                                 @Nullable java.lang.Object hint)

Adds a breadcrumb to the current Scope

Parameters:

breadcrumb - the breadcrumb

hint - SDK specific but provides high level information about the origin of the event

addBreadcrumb

public static void addBreadcrumb(@NotNull
                                 @NotNull Breadcrumb breadcrumb)

Adds a breadcrumb to the current Scope

Parameters:

breadcrumb - the breadcrumb

addBreadcrumb

public static void addBreadcrumb(@NotNull
                                 @NotNull java.lang.String message)

Adds a breadcrumb to the current Scope

Parameters:

message - rendered as text and the whitespace is preserved.

addBreadcrumb

public static void addBreadcrumb(@NotNull
                                 @NotNull java.lang.String message,
                                 @NotNull
                                 @NotNull java.lang.String category)

Adds a breadcrumb to the current Scope

Parameters:

message - rendered as text and the whitespace is preserved.

category - Categories are dotted strings that indicate what the crumb is or where it comes from.

setLevel

public static void setLevel(@Nullable
                            @Nullable SentryLevel level)

Sets the level of all events sent within current Scope

Parameters:

level - the Sentry level

setTransaction

public static void setTransaction(@Nullable
                                  @Nullable java.lang.String transaction)

Sets the name of the current transaction to the current Scope.

Parameters:

transaction - the transaction

setUser

public static void setUser(@Nullable
                           @Nullable User user)

Shallow merges user configuration (email, username, etc) to the current Scope.

Parameters:

user - the user

setFingerprint

public static void setFingerprint(@NotNull
                                  @NotNull java.util.List<java.lang.String> fingerprint)

Sets the fingerprint to group specific events together to the current Scope.

Parameters:

fingerprint - the fingerprints

clearBreadcrumbs

public static void clearBreadcrumbs()

Deletes current breadcrumbs from the current scope.

setTag

public static void setTag(@NotNull
                          @NotNull java.lang.String key,
                          @NotNull
                          @NotNull java.lang.String value)

Sets the tag to a string value to the current Scope, overwriting a potential previous value

Parameters:

key - the key

value - the value

removeTag

public static void removeTag(@NotNull
                             @NotNull java.lang.String key)

Removes the tag to a string value to the current Scope

Parameters:

key - the key

setExtra

public static void setExtra(@NotNull
                            @NotNull java.lang.String key,
                            @NotNull
                            @NotNull java.lang.String value)

Sets the extra key to an arbitrary value to the current Scope, overwriting a potential previous value

Parameters:

key - the key

value - the value

removeExtra

public static void removeExtra(@NotNull
                               @NotNull java.lang.String key)

Removes the extra key to an arbitrary value to the current Scope

Parameters:

key - the key

getLastEventId

@NotNull
public static @NotNull SentryId getLastEventId()

Last event id recorded in the current scope

Returns:

last SentryId

pushScope

public static void pushScope()

Pushes a new scope while inheriting the current scope's data.

popScope

public static void popScope()

Removes the first scope

withScope

public static void withScope(@NotNull
                             @NotNull ScopeCallback callback)

Runs the callback with a new scope which gets dropped at the end

Parameters:

callback - the callback

configureScope

public static void configureScope(@NotNull
                                  @NotNull ScopeCallback callback)

Configures the scope through the callback.

Parameters:

callback - The configure scope callback.

bindClient

public static void bindClient(@NotNull
                              @NotNull ISentryClient client)

Binds a different client to the current hub

Parameters:

client - the client.

flush

public static void flush(long timeoutMillis)

Flushes events queued up to the current hub. Not implemented yet.

Parameters:

timeoutMillis - time in milliseconds

startSession

public static void startSession()

Starts a new session. If there's a running session, it ends it before starting the new one.

endSession

public static void endSession()

Ends the current session