io.sentry

Class HubAdapter

java.lang.Object

io.sentry.HubAdapter

All Implemented Interfaces:

IHub

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

Method Summary

Modifier and Type	Method and Description
void	addBreadcrumb(Breadcrumb breadcrumb, @Nullable java.lang.Object hint) Adds a breadcrumb to the current Scope
void	bindClient(ISentryClient client) Binds a different client to the hub
SentryId	captureEnvelope(SentryEnvelope envelope, @Nullable java.lang.Object hint) Captures an envelope.
SentryId	captureEvent(SentryEvent event, @Nullable java.lang.Object hint) Captures the event.
SentryId	captureException(java.lang.Throwable throwable, @Nullable java.lang.Object hint) Captures the exception.
SentryId	captureMessage(java.lang.String message, SentryLevel level) Captures the message.
@NotNull SentryId	captureTransaction(ITransaction transaction, java.lang.Object hint) Captures the transaction and enqueues it for sending to Sentry server.
void	captureUserFeedback(UserFeedback userFeedback) Captures a manually created user feedback and sends it to Sentry.
void	clearBreadcrumbs() Deletes current breadcrumbs from the current scope.
IHub	clone() Clones the Hub
void	close() Flushes out the queue for up to timeout seconds and disable the Hub.
void	configureScope(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.
static HubAdapter	getInstance()
SentryId	getLastEventId() Last event id recorded in the current scope
@NotNull SentryOptions	getOptions() Gets the SentryOptions attached to current scope.
@Nullable ISpan	getSpan() Gets the current active transaction or span.
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(java.lang.String key) Removes the extra key to an arbitrary value to the current Scope
void	removeTag(java.lang.String key) Removes the tag to a string value to the current Scope
void	setExtra(java.lang.String key, java.lang.String value) Sets the extra key to an arbitrary value to the current Scope, overwriting a potential previous value
void	setFingerprint(java.util.List<java.lang.String> fingerprint) Sets the fingerprint to group specific events together to the current Scope.
void	setLevel(SentryLevel level) Sets the level of all events sent within current Scope
void	setSpanContext(@NotNull java.lang.Throwable t, @NotNull ISpan sc) Associates ISpan with the Throwable.
void	setTag(java.lang.String key, java.lang.String value) Sets the tag to a string value to the current Scope, overwriting a potential previous value
void	setTransaction(java.lang.String transaction) Sets the name of the current transaction to the current Scope.
void	setUser(User user) Shallow merges user configuration (email, username, etc) to the current Scope.
void	startSession() Starts a new session.
@NotNull ITransaction	startTransaction(java.lang.String name, java.lang.String operation, CustomSamplingContext customSamplingContext) Creates a Transaction bound to the current hub and returns the instance.
@NotNull ITransaction	startTransaction(TransactionContext transactionContexts) Creates a Transaction bound to the current hub and returns the instance.
@NotNull ITransaction	startTransaction(TransactionContext transactionContexts, CustomSamplingContext customSamplingContext) Creates a Transaction bound to the current hub and returns the instance.
@Nullable SentryTraceHeader	traceHeaders() Returns trace header of active transaction or null if no transaction is active.
void	withScope(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.IHub

addBreadcrumb, addBreadcrumb, addBreadcrumb, captureEnvelope, captureEvent, captureException, captureMessage, captureTransaction, startTransaction

Method Detail

getInstance

public static HubAdapter getInstance()

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

public SentryId captureEvent(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

public SentryId captureMessage(java.lang.String message,
                               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(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

public SentryId captureException(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

captureUserFeedback

public void captureUserFeedback(UserFeedback userFeedback)

Description copied from interface: IHub

Captures a manually created user feedback and sends it to Sentry.

Specified by:

captureUserFeedback in interface IHub

Parameters:

userFeedback - The user feedback to send to Sentry.

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(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(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(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(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(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(java.lang.String key,
                   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(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(java.lang.String key,
                     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(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

public 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(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(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(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

public 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

captureTransaction

@NotNull
public @NotNull SentryId captureTransaction(ITransaction transaction,
                                                     java.lang.Object hint)

Description copied from interface: IHub

Captures the transaction and enqueues it for sending to Sentry server.

Specified by:

captureTransaction in interface IHub

Parameters:

transaction - the transaction

hint - the hint

Returns:

transaction's id

startTransaction

@NotNull
public @NotNull ITransaction startTransaction(TransactionContext transactionContexts)

Description copied from interface: IHub

Creates a Transaction bound to the current hub and returns the instance.

Specified by:

startTransaction in interface IHub

Parameters:

transactionContexts - the transaction contexts

Returns:

created transaction

startTransaction

@NotNull
public @NotNull ITransaction startTransaction(TransactionContext transactionContexts,
                                                       CustomSamplingContext customSamplingContext)

Description copied from interface: IHub

Creates a Transaction bound to the current hub and returns the instance. Based on the passed transaction and sampling contexts the decision if transaction is sampled will be taken by TracesSampler.

Specified by:

startTransaction in interface IHub

Parameters:

transactionContexts - the transaction context

customSamplingContext - the sampling context

Returns:

created transaction.

startTransaction

@NotNull
public @NotNull ITransaction startTransaction(java.lang.String name,
                                                       java.lang.String operation,
                                                       CustomSamplingContext customSamplingContext)

Description copied from interface: IHub

Creates a Transaction bound to the current hub and returns the instance. Based on the passed sampling context the decision if transaction is sampled will be taken by TracesSampler.

Specified by:

startTransaction in interface IHub

Parameters:

name - the transaction name

operation - the operation

customSamplingContext - the sampling context

Returns:

created transaction.

traceHeaders

@Nullable
public @Nullable SentryTraceHeader traceHeaders()

Description copied from interface: IHub

Returns trace header of active transaction or null if no transaction is active.

Specified by:

traceHeaders in interface IHub

Returns:

trace header or null

setSpanContext

public void setSpanContext(@NotNull
                           @NotNull java.lang.Throwable t,
                           @NotNull
                           @NotNull ISpan sc)

Description copied from interface: IHub

Associates ISpan with the Throwable. Used to determine in which trace the exception has been thrown in framework integrations.

Specified by:

setSpanContext in interface IHub

Parameters:

t - the throwable

sc - the span context

getSpan

@Nullable
public @Nullable ISpan getSpan()

Description copied from interface: IHub

Gets the current active transaction or span.

Specified by:

getSpan in interface IHub

Returns:

the active span or null when no active transaction is running

getOptions

@NotNull
public @NotNull SentryOptions getOptions()

Description copied from interface: IHub

Gets the SentryOptions attached to current scope.

Specified by:

getOptions in interface IHub

Returns:

the options attached to current scope.