OpenTelemetry Tracing

Purpose

Generate command/query handlers and services with OpenTelemetry instrumentation for distributed tracing, including span creation, attributes, and error recording.

When to Use

• Adding observability to CQRS handlers
• Creating instrumented services
• Implementing distributed tracing
• Performance monitoring

What It Generates

Instrumented Handler Template

apps/api/src/modules/{feature}/commands/{operation}/{operation}.handler.ts
apps/api/src/modules/{feature}/services/{feature}.service.ts

Patterns Enforced

Span Creation

All handlers create spans:

• Span name: {feature}.{operation}
• Attributes: tenantId, actorId, operation, resource
• Error recording on exceptions

Span Attributes

Standard attributes:

• tenant.id - Tenant ID
• actor.id - User performing action
• operation.name - Operation name
• operation.type - command/query/event
• resource.id - Resource being operated on
• error.type - Error type (on failure)

Span Status

• OK on success
• Error on failure (with error recording)

Usage Example

/skill tracing-otel --name=CreateUser --type=command

Related Files

• Feature CQRS - CQRS handlers with tracing
• Cache Redis - Cache operations with tracing