Documentation / @agentick/core / TelemetryProvider

Interface: TelemetryProvider

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

Interface for telemetry providers (e.g., OpenTelemetry, DataDog).

Implement this interface to integrate with your observability platform.

Example

import { trace, metrics } from '@opentelemetry/api';

const otelProvider: TelemetryProvider = {
  startTrace(name) { return trace.getTracer('agentick').startSpan(name).spanContext().traceId; },
  startSpan(name) { return trace.getTracer('agentick').startSpan(name); },
  // ... implement other methods
};

Telemetry.setProvider(otelProvider);

Methods

endTrace()

endTrace(): void

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

End the current trace.

Returns

void

---

getCounter()

getCounter(name, unit?, description?): Counter

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

Get or create a counter metric.

Parameters

name

string

unit?

string

description?

string

Returns

Counter

---

getHistogram()

getHistogram(name, unit?, description?): Histogram

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

Get or create a histogram metric.

Parameters

name

string

unit?

string

description?

string

Returns

Histogram

---

recordError()

recordError(error): void

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

Record an error in the current trace/span.

Parameters

error

any

Returns

void

---

startSpan()

startSpan(name): Span

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

Start a new span within the current trace.

Parameters

name

string

Returns

Span

---

startTrace()

startTrace(name): string

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

Start a new trace and return its ID.

Parameters

name

string

Returns

string