name: libtelemetry description: > libtelemetry - OpenTelemetry-based logging and tracing. createLogger and Logger provide RFC 5424 structured logging. Tracer creates distributed trace spans. TraceVisualizer renders trace diagrams. TraceIndex stores trace data. observe function wraps operations with timing. Use for logging, distributed tracing, and performance monitoring.

libtelemetry Skill

When to Use

• Adding structured logging to services
• Implementing distributed tracing across microservices
• Visualizing trace data for debugging
• Monitoring operation timing and performance

Key Concepts

Logger: RFC 5424 compliant structured logging with severity levels.

Tracer: Creates spans for distributed tracing across service boundaries.

TraceVisualizer: Renders trace spans as visual diagrams.

Usage Patterns

Pattern 1: Structured logging

import { createLogger } from "@copilot-ld/libtelemetry";

const logger = createLogger("my-service");
logger.info("Request received", { requestId: "123" });
logger.error("Operation failed", { error: err.message });

Pattern 2: Distributed tracing

import { Tracer } from "@copilot-ld/libtelemetry/tracer.js";

const tracer = new Tracer(storage);
const span = tracer.startSpan("processRequest");
// ... do work ...
span.end();

Integration

Used by all services and extensions. Traces stored via Trace service.