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.