io.sentry

Interface ISpan

All Known Subinterfaces:

ITransaction

All Known Implementing Classes:

NoOpSpan, NoOpTransaction, SentryTransaction, Span

public interface ISpan

Represents performance monitoring Span.

Method Summary

Modifier and Type	Method and Description
void	finish() Sets span timestamp marking this span as finished.
void	finish(@Nullable SpanStatus status) Sets span timestamp marking this span as finished.
@Nullable java.lang.String	getDescription() Returns the span description.
@Nullable java.lang.String	getOperation() Returns the span operation.
@NotNull SpanContext	getSpanContext() Gets the span context.
@Nullable SpanStatus	getStatus() Returns the span status
@Nullable java.lang.Throwable	getThrowable() Gets the throwable that was thrown during the execution of the span.
void	setDescription(@Nullable java.lang.String description) Sets span description.
void	setOperation(@Nullable java.lang.String operation) Sets span operation.
void	setStatus(@Nullable SpanStatus status) Sets span status.
void	setTag(@NotNull java.lang.String key, @NotNull java.lang.String value) Sets the tag on span or transaction.
void	setThrowable(@Nullable java.lang.Throwable throwable) Sets the throwable that was thrown during the execution of the span.
@NotNull ISpan	startChild(@NotNull java.lang.String operation) Starts a child Span.
@NotNull ISpan	startChild(@NotNull java.lang.String operation, @Nullable java.lang.String description) Starts a child Span.
@NotNull SentryTraceHeader	toSentryTrace() Returns a string that could be sent as a sentry-trace header.

Method Detail

startChild

@NotNull
@NotNull ISpan startChild(@NotNull
                                   @NotNull java.lang.String operation)

Starts a child Span.

Parameters:

operation - - new span operation name

Returns:

a new transaction span

startChild

@NotNull
@NotNull ISpan startChild(@NotNull
                                   @NotNull java.lang.String operation,
                                   @Nullable
                                   @Nullable java.lang.String description)

Starts a child Span.

Parameters:

operation - - new span operation name

description - - new span description name

Returns:

a new transaction span

toSentryTrace

@NotNull
@NotNull SentryTraceHeader toSentryTrace()

Returns a string that could be sent as a sentry-trace header.

Returns:

SentryTraceHeader.

finish

void finish()

Sets span timestamp marking this span as finished.

finish

void finish(@Nullable
            @Nullable SpanStatus status)

Sets span timestamp marking this span as finished.

Parameters:

status - - the status

setOperation

void setOperation(@Nullable
                  @Nullable java.lang.String operation)

Sets span operation.

Parameters:

operation - - the operation

getOperation

@Nullable
@Nullable java.lang.String getOperation()

Returns the span operation.

Returns:

the operation

setDescription

void setDescription(@Nullable
                    @Nullable java.lang.String description)

Sets span description.

Parameters:

description - - the description.

getDescription

@Nullable
@Nullable java.lang.String getDescription()

Returns the span description.

Returns:

the description

setStatus

void setStatus(@Nullable
               @Nullable SpanStatus status)

Sets span status.

Parameters:

status - - the status.

getStatus

@Nullable
@Nullable SpanStatus getStatus()

Returns the span status

Returns:

the status

setThrowable

void setThrowable(@Nullable
                  @Nullable java.lang.Throwable throwable)

Sets the throwable that was thrown during the execution of the span.

Parameters:

throwable - - the throwable.

getThrowable

@Nullable
@Nullable java.lang.Throwable getThrowable()

Gets the throwable that was thrown during the execution of the span.

Returns:

throwable or null if none

getSpanContext

@NotNull
@NotNull SpanContext getSpanContext()

Gets the span context.

Returns:

the span context

setTag

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

Sets the tag on span or transaction.

Parameters:

key - the tag key

value - the tag value