io.sentry.core

Class Hub

java.lang.Object

io.sentry.core.Hub

All Implemented Interfaces:

IHub

public final class Hub
extends java.lang.Object
implements IHub

Constructor Summary

Constructors

Constructor and Description
Hub(@NotNull SentryOptions options)

Method Summary

Modifier and Type	Method and Description
void	addBreadcrumb(@NotNull Breadcrumb breadcrumb, @Nullable java.lang.Object hint) Adds a breadcrumb to the current Scope
void	bindClient(@NotNull ISentryClient client) Binds a different client to the hub
SentryId	captureEnvelope(@NotNull SentryEnvelope envelope, @Nullable java.lang.Object hint) Captures an envelope.
@NotNull SentryId	captureEvent(@NotNull SentryEvent event, @Nullable java.lang.Object hint) Captures the event.
@NotNull SentryId	captureException(@NotNull java.lang.Throwable throwable, @Nullable java.lang.Object hint) Captures the exception.
@NotNull SentryId	captureMessage(@NotNull java.lang.String message, @NotNull SentryLevel level) Captures the message.
void	clearBreadcrumbs() Deletes current breadcrumbs from the current scope.
@NotNull IHub	clone() Clones the Hub
void	close() Flushes out the queue for up to timeout seconds and disable the Hub.
void	configureScope(@NotNull ScopeCallback callback) Configures the scope through the callback.
void	endSession() Ends the current session
void	flush(long timeoutMillis) Flushes events queued up, but keeps the Hub enabled.
@NotNull SentryId	getLastEventId() Last event id recorded in the current scope
boolean	isEnabled() Check if the Hub is enabled/active.
void	popScope() Removes the first scope
void	pushScope() Pushes a new scope while inheriting the current scope's data.
void	removeExtra(@NotNull java.lang.String key) Removes the extra key to an arbitrary value to the current Scope
void	removeTag(@NotNull java.lang.String key) Removes the tag to a string value to the current Scope
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
void	setFingerprint(@NotNull java.util.List<java.lang.String> fingerprint) Sets the fingerprint to group specific events together to the current Scope.
void	setLevel(@Nullable SentryLevel level) Sets the level of all events sent within current Scope
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
void	setTransaction(@Nullable java.lang.String transaction) Sets the name of the current transaction to the current Scope.
void	setUser(@Nullable User user) Shallow merges user configuration (email, username, etc) to the current Scope.
void	startSession() Starts a new session.
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

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

Methods inherited from interface io.sentry.core.IHub

addBreadcrumb, addBreadcrumb, addBreadcrumb, captureEnvelope, captureEvent, captureException, captureMessage

Constructor Detail

Hub

public Hub(@NotNull
           @NotNull SentryOptions options)

Method Detail

isEnabled

public boolean isEnabled()

Description copied from interface: IHub

Check if the Hub is enabled/active.

Specified by:

isEnabled in interface IHub

Returns:

true if its enabled or false otherwise.

captureEvent

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

Description copied from interface: IHub

Captures the event.

Specified by:

captureEvent in interface IHub

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 @NotNull SentryId captureMessage(@NotNull
                                                 @NotNull java.lang.String message,
                                                 @NotNull
                                                 @NotNull SentryLevel level)

Description copied from interface: IHub

Captures the message.

Specified by:

captureMessage in interface IHub

Parameters:

message - The message to send.

level - The message level.

Returns:

The Id (SentryId object) of the event

captureEnvelope

@ApiStatus.Internal
public SentryId captureEnvelope(@NotNull
                                                    @NotNull SentryEnvelope envelope,
                                                    @Nullable
                                                    @Nullable java.lang.Object hint)

Description copied from interface: IHub

Captures an envelope.

Specified by:

captureEnvelope in interface IHub

Parameters:

envelope - the SentryEnvelope to send.

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

Returns:

The Id (SentryId object) of the event

captureException

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

Description copied from interface: IHub

Captures the exception.

Specified by:

captureException in interface IHub

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

startSession

public void startSession()

Description copied from interface: IHub

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

Specified by:

startSession in interface IHub

endSession

public void endSession()

Description copied from interface: IHub

Ends the current session

Specified by:

endSession in interface IHub

close

public void close()

Description copied from interface: IHub

Flushes out the queue for up to timeout seconds and disable the Hub.

Specified by:

close in interface IHub

addBreadcrumb

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

Description copied from interface: IHub

Adds a breadcrumb to the current Scope

Specified by:

addBreadcrumb in interface IHub

Parameters:

breadcrumb - the breadcrumb

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

setLevel

public void setLevel(@Nullable
                     @Nullable SentryLevel level)

Description copied from interface: IHub

Sets the level of all events sent within current Scope

Specified by:

setLevel in interface IHub

Parameters:

level - the Sentry level

setTransaction

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

Description copied from interface: IHub

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

Specified by:

setTransaction in interface IHub

Parameters:

transaction - the transaction

setUser

public void setUser(@Nullable
                    @Nullable User user)

Description copied from interface: IHub

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

Specified by:

setUser in interface IHub

Parameters:

user - the user

setFingerprint

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

Description copied from interface: IHub

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

Specified by:

setFingerprint in interface IHub

Parameters:

fingerprint - the fingerprints

clearBreadcrumbs

public void clearBreadcrumbs()

Description copied from interface: IHub

Deletes current breadcrumbs from the current scope.

Specified by:

clearBreadcrumbs in interface IHub

setTag

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

Description copied from interface: IHub

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

Specified by:

setTag in interface IHub

Parameters:

key - the key

value - the value

removeTag

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

Description copied from interface: IHub

Removes the tag to a string value to the current Scope

Specified by:

removeTag in interface IHub

Parameters:

key - the key

setExtra

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

Description copied from interface: IHub

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

Specified by:

setExtra in interface IHub

Parameters:

key - the key

value - the value

removeExtra

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

Description copied from interface: IHub

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

Specified by:

removeExtra in interface IHub

Parameters:

key - the key

getLastEventId

@NotNull
public @NotNull SentryId getLastEventId()

Description copied from interface: IHub

Last event id recorded in the current scope

Specified by:

getLastEventId in interface IHub

Returns:

last SentryId

pushScope

public void pushScope()

Description copied from interface: IHub

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

Specified by:

pushScope in interface IHub

popScope

public void popScope()

Description copied from interface: IHub

Removes the first scope

Specified by:

popScope in interface IHub

withScope

public void withScope(@NotNull
                      @NotNull ScopeCallback callback)

Description copied from interface: IHub

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

Specified by:

withScope in interface IHub

Parameters:

callback - the callback

configureScope

public void configureScope(@NotNull
                           @NotNull ScopeCallback callback)

Description copied from interface: IHub

Configures the scope through the callback.

Specified by:

configureScope in interface IHub

Parameters:

callback - The configure scope callback.

bindClient

public void bindClient(@NotNull
                       @NotNull ISentryClient client)

Description copied from interface: IHub

Binds a different client to the hub

Specified by:

bindClient in interface IHub

Parameters:

client - the client.

flush

public void flush(long timeoutMillis)

Description copied from interface: IHub

Flushes events queued up, but keeps the Hub enabled. Not implemented yet.

Specified by:

flush in interface IHub

Parameters:

timeoutMillis - time in milliseconds

clone

@NotNull
public @NotNull IHub clone()

Description copied from interface: IHub

Clones the Hub

Specified by:

clone in interface IHub

Overrides:

clone in class java.lang.Object

Returns:

the cloned Hub