libtelemetry - SKILL.md Agent Skill

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.