AIDK API Reference / aidk-kernel / Span

Interface: Span

Defined in: packages/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: packages/kernel/src/telemetry.ts:22

End the span, recording its duration.

Returns

void

---

recordError()

recordError(error: any): void;

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

Record an error that occurred during this span.

Parameters

Parameter	Type
error	any

Returns

void

---

setAttribute()

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

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

Set an attribute on the span for filtering/analysis.

Parameters

Parameter	Type
key	string
value	any

Returns

void