observability-guidelines

SKILL.md

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