Class: Tracer

Defined in: packages/agentos/src/core/observability/Tracer.ts:246

Distributed tracer implementation.

Implements

• ITracer

Constructors

Constructor

new Tracer(config?): Tracer

Defined in: packages/agentos/src/core/observability/Tracer.ts:257

Parameters

config?

Partial<TracerConfig>

Returns

Tracer

Properties

name

readonly name: string

Defined in: packages/agentos/src/core/observability/Tracer.ts:247

Gets the tracer name.

Implementation of

ITracer.name

Methods

addExporter()

addExporter(exporter): void

Defined in: packages/agentos/src/core/observability/Tracer.ts:381

Adds a span exporter.

Parameters

exporter

ISpanExporter

Exporter to add

Returns

void

Implementation of

ITracer.addExporter

---

extract()

extract(carrier): TraceContext | undefined

Defined in: packages/agentos/src/core/observability/Tracer.ts:346

Extracts trace context from a carrier.

Parameters

carrier

Record<string, string>

Object to extract from

Returns

TraceContext | undefined

Extracted context or undefined

Implementation of

ITracer.extract

---

flush()

flush(): Promise<void>

Defined in: packages/agentos/src/core/observability/Tracer.ts:385

Forces export of all completed spans.

Returns

Promise<void>

Implementation of

ITracer.flush

---

getActiveSpans()

getActiveSpans(): ISpan[]

Defined in: packages/agentos/src/core/observability/Tracer.ts:377

Gets all active spans.

Returns

ISpan[]

Array of active spans

Implementation of

ITracer.getActiveSpans

---

getCurrentContext()

getCurrentContext(): TraceContext | undefined

Defined in: packages/agentos/src/core/observability/Tracer.ts:267

Gets the current trace context.

Returns

TraceContext | undefined

Implementation of

ITracer.getCurrentContext

---

getSpan()

getSpan(spanId): ISpan | undefined

Defined in: packages/agentos/src/core/observability/Tracer.ts:373

Gets a span by ID.

Parameters

spanId

string

Span ID

Returns

ISpan | undefined

The span or undefined

Implementation of

ITracer.getSpan

---

getStats()

getStats(): TracerStats

Defined in: packages/agentos/src/core/observability/Tracer.ts:401

Gets tracer statistics.

Returns

TracerStats

Implementation of

ITracer.getStats

---

inject()

inject<T>(carrier): T

Defined in: packages/agentos/src/core/observability/Tracer.ts:334

Injects trace context into a carrier (for propagation).

Type Parameters

T

T extends Record<string, string>

Parameters

carrier

T

Object to inject into

Returns

T

The carrier with injected context

Implementation of

ITracer.inject

---

resetStats()

resetStats(): void

Defined in: packages/agentos/src/core/observability/Tracer.ts:405

Resets statistics.

Returns

void

Implementation of

ITracer.resetStats

---

shutdown()

shutdown(): Promise<void>

Defined in: packages/agentos/src/core/observability/Tracer.ts:409

Shuts down the tracer.

Returns

Promise<void>

Implementation of

ITracer.shutdown

---

startSpan()

startSpan(name, options?): ISpan

Defined in: packages/agentos/src/core/observability/Tracer.ts:271

Starts a new span.

Parameters

name

string

Span name

options?

SpanOptions

Span options

Returns

ISpan

The created span

Implementation of

ITracer.startSpan

---

withSpan()

withSpan<T>(name, fn, options?): Promise<T>

Defined in: packages/agentos/src/core/observability/Tracer.ts:320

Wraps an async function with tracing.

Type Parameters

T

T

Parameters

name

string

Span name

fn

(span) => Promise<T>

Function to wrap

options?

SpanOptions

Span options

Returns

Promise<T>

Result of the function

Implementation of

ITracer.withSpan