https://github.com/pellared/olog

OpenTelemetry Logging Facade
https://github.com/pellared/olog

Last synced: 9 months ago
JSON representation

OpenTelemetry Logging Facade

• Host: GitHub
• URL: https://github.com/pellared/olog
• Owner: pellared
• License: mit
• Created: 2025-09-26T11:24:04.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-09-26T13:31:08.000Z (9 months ago)
• Last Synced: 2025-09-26T14:42:08.898Z (9 months ago)
• Language: Go
• Homepage:
• Size: 63.5 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
# olog - OpenTelemetry Logging Facade

[![Go Reference](https://pkg.go.dev/badge/github.com/pellared/olog.svg)](https://pkg.go.dev/github.com/pellared/olog)

[![Keep a Changelog](https://img.shields.io/badge/changelog-Keep%20a%20Changelog-%23E05735)](CHANGELOG.md)

[![go.mod](https://img.shields.io/github/go-mod/go-version/pellared/olog)](go.mod)

[![LICENSE](https://img.shields.io/github/license/pellared/olog)](LICENSE)

[![Go Report Card](https://goreportcard.com/badge/github.com/pellared/olog)](https://goreportcard.com/report/github.com/pellared/olog)

[![Codecov](https://codecov.io/gh/pellared/olog/branch/main/graph/badge.svg)](https://codecov.io/gh/pellared/olog)

⭐ `Star` this repository if you find it valuable and worth maintaining.

👁 `Watch` this repository to get notified about new releases, issues, etc.

## Description

The `olog` package provides an ergonomic frontend API for OpenTelemetry structured logging.

It is designed to offer a more user-friendly interface while using the OpenTelemetry Logs API as the backend.

It addresses the concerns raised in

[opentelemetry-specification#4661](https://github.com/open-telemetry/opentelemetry-specification/issues/4661).

## Contributing

Feel free to create an issue,

join the [discussions](https://github.com/pellared/olog/discussions/2),

or propose a pull request.

Please follow the [Code of Conduct](CODE_OF_CONDUCT.md).

This module follows several key design principles:

1. **Ergonomic API**: Provides simple methods that are easy to use and understand

2. **Performance First**: Includes `Enabled()` checks and optimizations to minimize overhead

3. **Structured Logging**: Emphasizes key-value pairs over string formatting

4. **Compatibility**: Uses OpenTelemetry Logs API as the backend for full compatibility

5. **Composability**: Supports logger composition through `With()`

6. **Familiar Patterns**: Similar to `slog` design patterns that Go developers already know

## License

**olog** is licensed under the terms of the [MIT license](LICENSE).