v0.1.0-sdk-alpha (Zig 0.15.1)

[inge4pres]

OpenTelemetry Zig v0.1.0-sdk-alpha

We are excited to announce the first alpha release of OpenTelemetry for Zig! This release provides a native Zig implementation of the OpenTelemetry specification v1.48.0, offering observability primitives for traces, metrics, and logs.

Highlights

This alpha release includes:

• Complete Stable Signal Support: Full implementations of Traces, Metrics, and Logs APIs and SDKs
• OTLP Protocol Exporters: HTTP/Protobuf and HTTP/JSON exporters with gzip compression support
• Production-Ready Examples: 10+ working examples demonstrating real-world usage patterns
• Integration Tested: Verified against the official OpenTelemetry Collector
• Performance Benchmarks: Comprehensive benchmark suite for performance tracking

Requirements

• Zig version: 0.15.1 or later
• Integration tests: Docker (optional, for running integration tests)

Alpha Status Notice

Caution

This is an alpha release. While the implementation is functional and tested against the OpenTelemetry specification, it has not been battle-tested in production environments. We encourage you to:

• Test it in development and staging environments
• Report any issues you encounter
• Expect breaking changes in future releases as we stabilize the API

Documentation

• API Documentation: https://zig-o11y.github.io/opentelemetry-sdk/
• Contributing Guide: CONTRIBUTING.md
• OpenTelemetry Specification: https://opentelemetry.io/docs/specs/otel/

Known Limitations

• gRPC protocol support is not yet implemented
• Profile signal is not yet implemented
• Some advanced SDK features may not be fully implemented

Testing

This release includes:

• Unit tests: Comprehensive test coverage for all components
• Integration tests: Validated against the official OpenTelemetry Collector
• Benchmarks: Performance tracking for critical paths

Run tests locally:

zig build test                  # Unit tests
zig build integration          # Integration tests (requires Docker)
zig build benchmarks          # Performance benchmarks

Run examples locally:

zig build examples

Feedback and Support

We welcome your feedback! Please:

• Report issues on GitHub Issues
• Contribute improvements via Pull Requests
• Join discussions in the OpenTelemetry community

---

Thank you for trying OpenTelemetry Zig! We look forward to your feedback as we work towards a stable 1.0 release.

---

This discussion was created from the release v0.1.0-sdk-alpha (Zig 0.15.1).