OpenTelemetry library that unifies how Go applications implement OpenTelemetry for logs, metrics, and distributed tracing with production-ready TLS security features.

• Logs: OpenTelemetry log collection with configurable TLS settings
• Metrics: OpenTelemetry metric collection with configurable TLS settings
• Tracing: OpenTelemetry distributed tracing with configurable TLS settings
• Host Metrics: Collection of system-level metrics (CPU, memory, disk, network)
• Runtime Metrics: Go runtime metrics (GC, memory, goroutines, etc.)
• Slog Integration: Structured logging through Go's slog package
• Builder Pattern: Fluent APIs for easy configuration (logs.NewBuilder(), metrics.NewBuilder(), tracing.NewBuilder())
• TLS Support: Secure connections with comprehensive TLS configuration and validation
• Thread Safety: Safe for concurrent initialization and use
• Comprehensive Testing: Extensive test coverage (>85%) including race condition testing

go get github.com/wasilak/otelgo

package main

import (
    "context"
    "os"

    "github.com/wasilak/otelgo/logs"
    "github.com/wasilak/otelgo/metrics"
    "github.com/wasilak/otelgo/tracing"
)

func main() {
    // Set required environment variables
    os.Setenv("OTEL_SERVICE_NAME", "my-service")

    ctx := context.Background()

    // Initialize all three providers with minimal setup
    _, logProvider, _ := logs.NewBuilder().WithTLSInsecure().Build(ctx)
    _, metricProvider, _ := metrics.NewBuilder().WithTLSInsecure().Build(ctx)
    _, traceProvider, _ := tracing.NewBuilder().WithTLSInsecure().Build(ctx)

    // Use your providers here
    // Remember to shutdown when done
    defer func() {
        _ = logs.Shutdown(ctx, logProvider)
        _ = metrics.Shutdown(ctx, metricProvider)
        _ = tracing.Shutdown(ctx, traceProvider)
    }()
}

• Security Guide - TLS configuration, certificate setup, security best practices
• Configuration Guide - All configuration options, environment variables, and builder patterns
• Troubleshooting Guide - Common issues, error handling, debugging techniques
• API Reference - Complete API documentation for all public interfaces

All packages support fluent builder APIs for clean, readable configuration:

// Logs with custom attributes and TLS
_, logProvider, _ := logs.NewBuilder().
    WithAttributes(attribute.String("env", "production")).
    WithTLS(&internal.TLSConfig{
        CACertPath: "/path/to/ca.pem",
        ServerName: "collector.example.com",
    }).
    Build(ctx)

// Metrics with custom attributes
_, metricProvider, _ := metrics.NewBuilder().
    WithAttributes(attribute.String("service.region", "us-west-2")).
    WithTLSInsecure(). // Development only!
    Build(ctx)

// Tracing with host/runtime metrics and TLS
_, traceProvider, _ := tracing.NewBuilder().
    WithHostMetricsEnabled(true).
    WithRuntimeMetricsEnabled(true).
    WithTLS(&internal.TLSConfig{
        ClientCertPath: "/path/to/client-cert.pem",
        ClientKeyPath:  "/path/to/client-key.pem",
    }).
    Build(ctx)

All otelgo components feature production-ready security:

• Secure-by-default TLS: Proper certificate validation with customizable options
• Mutual TLS Support: Client certificate authentication for enhanced security
• Certificate Pinning Options: Server name verification and custom CA certificates
• Comprehensive Validation: Input validation for all configuration options
• Thread-Safe Initialization: Safe concurrent use patterns

For detailed security configuration, see our Security Guide.

Working examples are provided in the examples/ directory:

• Basic example - Fundamental usage patterns
• TLS Custom CA example - Secure TLS configuration
• Client Certificate example - Mutual TLS setup
• Error Handling example - Proper error handling
• Concurrent Initialization example - Thread-safe usage patterns

This project is licensed under the MIT License - see the LICENSE file for details.

Contributions are welcome! Please read our contribution guidelines and code of conduct before submitting pull requests.