libtelemetry

libtelemetry——基于 OpenTelemetry 的日志与追踪工具。createLogger 与 Logger 提供符合 RFC 5424 标准的结构化日志记录。Tracer 可创建分布式追踪跨度。TraceVisualizer 可渲染追踪图表。TraceIndex 存储追踪数据。observe 函数可在操作执行过程中进行计时与记录。适用于日志记录、分布式追踪，以及性能监控。

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

javascript

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

javascript

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.