Interface PluginTypes.Span (8.0.0)

Represents a trace span.

Package

@google-cloud/trace-agent

Properties

type

readonly type: SpanType;

The current span type. See SpanType for more information.

Methods

addLabel(key, value)

addLabel(key: string, value: any): void;

Adds a key-value pair as a label to the trace span. The value will be converted to a string if it is not already, and both the key and value may be truncated according to the user's configuration.

Parameters
NameDescription
key string

The label's key.

value any

The label's value.

Returns
TypeDescription
void

endSpan(timestamp)

endSpan(timestamp?: Date): void;

Ends the span. This method should only be called once.

Parameter
NameDescription
timestamp Date

A custom span end time; defaults to the time when endSpan was called if not provided.

Returns
TypeDescription
void

getTraceContext()

getTraceContext(): TraceContext | null;

Gets the current trace context, or null if it can't be retrieved. The trace context.

Returns
TypeDescription
TraceContext | null