Documentation / @agentick/kernel / Span

Interface: Span

Defined in: kernel/src/telemetry.ts:20

A span represents a unit of work or operation within a trace. Spans track timing, attributes, and errors for observability.

Example

const span = Telemetry.startSpan('database-query');
try {
  span.setAttribute('query', 'SELECT * FROM users');
  const result = await db.query(...);
  span.setAttribute('rowCount', result.length);
} catch (error) {
  span.recordError(error);
  throw error;
} finally {
  span.end();
}

Methods

end()

end(): void

Defined in: kernel/src/telemetry.ts:22

End the span, recording its duration.

Returns

void

---

recordError()

recordError(error): void

Defined in: kernel/src/telemetry.ts:26

Record an error that occurred during this span.

Parameters

error

any

Returns

void

---

setAttribute()

setAttribute(key, value): void

Defined in: kernel/src/telemetry.ts:24

Set an attribute on the span for filtering/analysis.

Parameters

key

string

value

any

Returns

void