Module server/telemetry

Telemetry Module

OpenTelemetry integration for distributed tracing and metrics.

Setup

Enable telemetry with environment variables:

OTEL_ENABLED=true
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
Copy

All OTEL settings are routed through the config system (env vars + config file):

• OTEL_EXPORTER_OTLP_ENDPOINT — OTLP endpoint URL
• OTEL_TRACES_EXPORTER — Trace exporter: otlp (default), console, none
• OTEL_LOG_LEVEL — SDK diagnostic log level
• OTEL_METRIC_EXPORT_INTERVAL — Metric export interval (ms)

Framework-managed env vars:

• OTEL_METRICS_EXPORTER — otlp, prometheus, console, none (default: otlp,prometheus)

Usage

import { initializeTelemetry, withSpan, getTraceContext, serverMetrics } from './telemetry/index.js';

// Initialize at startup
initializeTelemetry();

// Create spans
await withSpan('myOperation', async (span) => {
  span.setAttribute('key', 'value');
  return await doSomething();
});

// Get trace context for propagation
const ctx = getTraceContext();

// Record metrics
serverMetrics.recordRequest('tool_name', 150, true);
Copy