Skip to main content

Class: Tracer

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

Distributed tracer implementation.

Implements​

Constructors​

Constructor​

new Tracer(config?): Tracer

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

Parameters​

config?​

Partial<TracerConfig>

Returns​

Tracer

Properties​

name​

readonly name: string

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

Gets the tracer name.

Implementation of​

ITracer.name

Methods​

addExporter()​

addExporter(exporter): void

Defined in: packages/agentos/src/safety/evaluation/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/safety/evaluation/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/safety/evaluation/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/safety/evaluation/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/safety/evaluation/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/safety/evaluation/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/safety/evaluation/observability/Tracer.ts:401

Gets tracer statistics.

Returns​

TracerStats

Implementation of​

ITracer.getStats

inject()​

inject<T>(carrier): T

Defined in: packages/agentos/src/safety/evaluation/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/safety/evaluation/observability/Tracer.ts:405

Resets statistics.

Returns​

void

Implementation of​

ITracer.resetStats

shutdown()​

shutdown(): Promise<void>

Defined in: packages/agentos/src/safety/evaluation/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/safety/evaluation/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/safety/evaluation/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