Class Span

Span contains all data about a span

Hierarchy

Span
- Transaction
- Transaction

Implements

Span

Properties

data

data: {
[key: string]: any;
} = {}

Data of the Span.

Type declaration

[key: string]: any

`Optional` description

description?: string

Description of the Span.

`Optional` endTimestamp

endTimestamp?: number

Timestamp in seconds when the span ended.

instrumenter

instrumenter: Instrumenter = 'sentry'

The instrumenter that created this span.

`Optional` op

op?: string

Operation of the Span.

`Optional` parentSpanId

parentSpanId?: string

Parent Span ID

`Optional` sampled

sampled?: boolean

Was this span chosen to be sent as part of the sample?

spanId

spanId: string = ...

Span ID

`Optional` spanRecorder

spanRecorder?: SpanRecorder

List of spans that were finalized

startTimestamp

startTimestamp: number = ...

Timestamp in seconds when the span was created.

`Optional` status

status?: string

Internal keeper of the status

traceId

traceId: string = ...

Trace ID

`Optional` transaction

transaction?: Transaction

The transaction containing this span

Methods

finish

finish(endTimestamp?): void
Sets the finish timestamp on the current span.
Parameters
- Optional endTimestamp: number
  
  Takes an endTimestamp if the end should not be the time when you call this function.
Returns void
Implementation of Span.finish
- Defined in core/src/tracing/span.ts:248

getTraceContext

getTraceContext(): TraceContext
Convert the object to JSON for w. spans array info only

Returns TraceContext
Implementation of Span.getTraceContext
- Defined in core/src/tracing/span.ts:312

isSuccess

isSuccess(): boolean
Determines whether span was successful (HTTP200)

Returns boolean
Implementation of Span.isSuccess
- Defined in core/src/tracing/span.ts:241

setData

setData(key, value): Span
Sets the data attribute on the current span
Parameters
- key: string
  
  Data key
- value: any
  
  Data value
Returns Span
Implementation of Span.setData
- Defined in core/src/tracing/span.ts:212

setHttpStatus

setHttpStatus(httpStatus): Span
Sets the status attribute on the current span based on the http code
Parameters
- httpStatus: number
  
  http code used to set the status
Returns Span
Implementation of Span.setHttpStatus
- Defined in core/src/tracing/span.ts:228

setStatus

setStatus(value): Span
Sets the status attribute on the current span See: {@sentry/tracing SpanStatus} for possible values
Parameters
- value: SpanStatusType
  
  http code used to set the status
Returns Span
Implementation of Span.setStatus
- Defined in core/src/tracing/span.ts:220

setTag

setTag(key, value): Span
Sets the tag attribute on the current span.

Can also be used to unset a tag, by passing undefined.
Parameters
- key: string
  
  Tag key
- value: Primitive
  
  Tag value
Returns Span
Implementation of Span.setTag
- Defined in core/src/tracing/span.ts:203

startChild

startChild(spanContext?): Span
Creates a new Span while setting the current Span.id as parentSpanId. Also the sampled decision will be inherited.
Parameters
- Optional spanContext: Pick<SpanContext, "status" | "tags" | "data" | "description" | "op" | "instrumenter" | "spanId" | "startTimestamp" | "endTimestamp">
Returns Span
Implementation of Span.startChild
- Defined in core/src/tracing/span.ts:170

toContext

toContext(): SpanContext
Returns the current span properties as a SpanContext

Returns SpanContext
Implementation of Span.toContext
- Defined in core/src/tracing/span.ts:274

toJSON

toJSON(): {
    data?: {
        [key: string]: any;
    };
    description?: string;
    op?: string;
    parent_span_id?: string;
    span_id: string;
    start_timestamp: number;
    status?: string;
    tags?: {
        [key: string]: Primitive;
    };
    timestamp?: number;
    trace_id: string;
}
Convert the object to JSON

Returns {
    data?: {
        [key: string]: any;
    };
    description?: string;
    op?: string;
    parent_span_id?: string;
    span_id: string;
    start_timestamp: number;
    status?: string;
    tags?: {
        [key: string]: Primitive;
    };
    timestamp?: number;
    trace_id: string;
}
- Optional data?: {
  [key: string]: any;
  }
  - [key: string]: any
- Optional description?: string
- Optional op?: string
- Optional parent_span_id?: string
- span_id: string
- start_timestamp: number
- Optional status?: string
- Optional tags?: {
  [key: string]: Primitive;
  }
  - [key: string]: Primitive
- Optional timestamp?: number
- trace_id: string
Implementation of Span.toJSON
- Defined in core/src/tracing/span.ts:328

toTraceparent

toTraceparent(): string
Return a traceparent compatible header string

Returns string
Implementation of Span.toTraceparent
- Defined in core/src/tracing/span.ts:267

updateWithContext

updateWithContext(spanContext): Span
Updates the current span with a new SpanContext
Parameters
- spanContext: SpanContext
Returns Span
Implementation of Span.updateWithContext
- Defined in core/src/tracing/span.ts:293

Class Span

Hierarchy

Implements

Index

Properties

Methods

Properties

data

Type declaration

[key: string]: any

Optional description

Optional endTimestamp

instrumenter

Optional op

Optional parentSpanId

Optional sampled

spanId

Optional spanRecorder

startTimestamp

Optional status

tags

Type declaration

[key: string]: Primitive

traceId

Optional transaction

Methods

finish

Parameters

Optional endTimestamp: number

Returns void

getTraceContext

Returns TraceContext

isSuccess

Returns boolean

setData

Parameters

key: string

value: any

Returns Span

setHttpStatus

Parameters

httpStatus: number

Returns Span

setStatus

Parameters

value: SpanStatusType

Returns Span

setTag

Parameters

key: string

value: Primitive

Returns Span

startChild

Parameters

Optional spanContext: Pick<SpanContext, "status" | "tags" | "data" | "description" | "op" | "instrumenter" | "spanId" | "startTimestamp" | "endTimestamp">

Returns Span

toContext

Returns SpanContext

toJSON

Returns { data?: { [key: string]: any; }; description?: string; op?: string; parent_span_id?: string; span_id: string; start_timestamp: number; status?: string; tags?: { [key: string]: Primitive; }; timestamp?: number; trace_id: string; }

Optional data?: { [key: string]: any; }

[key: string]: any

Optional description?: string

Optional op?: string

Optional parent_span_id?: string

span_id: string

start_timestamp: number

Optional status?: string

Optional tags?: { [key: string]: Primitive; }

[key: string]: Primitive

Optional timestamp?: number

trace_id: string

toTraceparent

Returns string

updateWithContext

Parameters

spanContext: SpanContext

Returns Span

Settings

Member Visibility

`Optional` description

`Optional` endTimestamp

`Optional` op

`Optional` parentSpanId

`Optional` sampled

`Optional` spanRecorder

`Optional` status

`Optional` transaction

`Optional` endTimestamp: number

`Optional` spanContext: Pick<SpanContext, "status" | "tags" | "data" | "description" | "op" | "instrumenter" | "spanId" | "startTimestamp" | "endTimestamp">

Returns {
data?: {
[key: string]: any;
};
description?: string;
op?: string;
parent_span_id?: string;
span_id: string;
start_timestamp: number;
status?: string;
tags?: {
[key: string]: Primitive;
};
timestamp?: number;
trace_id: string;
}

`Optional` data?: {
[key: string]: any;
}

`Optional` description?: string

`Optional` op?: string

`Optional` parent_span_id?: string

`Optional` status?: string

`Optional` tags?: {
[key: string]: Primitive;
}

`Optional` timestamp?: number