Class Span

Span contains all data about a span

Hierarchy

Span

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.

`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

child

child(spanContext?: Pick<SpanContext, "description" | "op" | "status" | "tags" | "data" | "startTimestamp" | "endTimestamp">): Span
Use startChild

Deprecated
Parameters
- Optional spanContext: Pick<SpanContext, "description" | "op" | "status" | "tags" | "data" | "startTimestamp" | "endTimestamp">
Returns Span
Implementation of Span.child
- Defined in node_modules/@sentry/tracing/dist/span.d.ts:93

finish

finish(endTimestamp?: number): 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 node_modules/@sentry/tracing/dist/span.d.ts:121

getTraceContext

getTraceContext(): {
    data?: {
        [key: string]: any;
    };
    description?: string;
    op?: string;
    parent_span_id?: string;
    span_id: string;
    status?: string;
    tags?: {
        [key: string]: Primitive;
    };
    trace_id: string;
}
Convert the object to JSON for w. spans array info only

Returns {
    data?: {
        [key: string]: any;
    };
    description?: string;
    op?: string;
    parent_span_id?: string;
    span_id: string;
    status?: string;
    tags?: {
        [key: string]: Primitive;
    };
    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
- Optional status?: string
- Optional tags?: {
  [key: string]: Primitive;
  }
  - [key: string]: Primitive
- trace_id: string
Implementation of Span.getTraceContext
- Defined in node_modules/@sentry/tracing/dist/span.d.ts:137

isSuccess

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

Returns boolean
Implementation of Span.isSuccess
- Defined in node_modules/@sentry/tracing/dist/span.d.ts:117

setData

setData(key: string, value: any): 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 node_modules/@sentry/tracing/dist/span.d.ts:105

setHttpStatus

setHttpStatus(httpStatus: number): 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 node_modules/@sentry/tracing/dist/span.d.ts:113

setStatus

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

setTag

setTag(key: string, value: Primitive): 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 node_modules/@sentry/tracing/dist/span.d.ts:101

startChild

startChild(spanContext?: Pick<SpanContext, "description" | "op" | "status" | "tags" | "data" | "startTimestamp" | "endTimestamp">): 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, "description" | "op" | "status" | "tags" | "data" | "startTimestamp" | "endTimestamp">
Returns Span
Implementation of Span.startChild
- Defined in node_modules/@sentry/tracing/dist/span.d.ts:97

toContext

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

Returns SpanContext
Implementation of Span.toContext
- Defined in node_modules/@sentry/tracing/dist/span.d.ts:129

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 node_modules/@sentry/tracing/dist/span.d.ts:154

toTraceparent

toTraceparent(): string
Return a traceparent compatible header string

Returns string
Implementation of Span.toTraceparent
- Defined in node_modules/@sentry/tracing/dist/span.d.ts:125

updateWithContext

updateWithContext(spanContext: SpanContext): Span
Updates the current span with a new SpanContext
Parameters
- spanContext: SpanContext
Returns Span
Implementation of Span.updateWithContext
- Defined in node_modules/@sentry/tracing/dist/span.d.ts:133

Class Span

Hierarchy

Implements

Index

Properties

Methods

Properties

data

Type declaration

[key: string]: any

Optional description

Optional endTimestamp

Optional op

Optional parentSpanId

Optional sampled

spanId

Optional spanRecorder

startTimestamp

Optional status

tags

Type declaration

[key: string]: Primitive

traceId

Optional transaction

Methods

child

Deprecated

Parameters

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

Returns Span

finish

Parameters

Optional endTimestamp: number

Returns void

getTraceContext

Returns { data?: { [key: string]: any; }; description?: string; op?: string; parent_span_id?: string; span_id: string; status?: string; tags?: { [key: string]: Primitive; }; 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

Optional status?: string

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

[key: string]: Primitive

trace_id: string

isSuccess

Returns boolean

setData

Parameters

key: string

value: any

Returns Span

setHttpStatus

Parameters

httpStatus: number

Returns Span

setStatus

Parameters

value: SpanStatus

Returns Span

setTag

Parameters

key: string

value: Primitive

Returns Span

startChild

Parameters

Optional spanContext: Pick<SpanContext, "description" | "op" | "status" | "tags" | "data" | "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

`Optional` description

`Optional` endTimestamp

`Optional` op

`Optional` parentSpanId

`Optional` sampled

`Optional` spanRecorder

`Optional` status

`Optional` transaction

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

`Optional` endTimestamp: number

Returns {
data?: {
[key: string]: any;
};
description?: string;
op?: string;
parent_span_id?: string;
span_id: string;
status?: string;
tags?: {
[key: string]: Primitive;
};
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` spanContext: Pick<SpanContext, "description" | "op" | "status" | "tags" | "data" | "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