Observability Guidelines

Apply these observability principles to ensure comprehensive visibility into distributed systems and microservices.

Core Observability Principles

• Guide the development of idiomatic, maintainable, and high-performance code with built-in observability
• Enforce modular design and separation of concerns through Clean Architecture
• Promote test-driven development and robust observability from the start

OpenTelemetry Integration

• Use OpenTelemetry for distributed tracing, metrics, and structured logging
• Start and propagate tracing spans across all service boundaries
• Use otel.Tracer for creating spans and otel.Meter for collecting metrics
• Export data to OpenTelemetry Collector, Jaeger, or Prometheus
• Configure appropriate sampling rates for production environments

Distributed Tracing