v0.1.0

[rossabaker]

This is the first public release of otel4s, an OpenTelemetry implementation for Cats Effect. Rather than another ad hoc metrics or tracing abstraction, we are leaning fully into the OpenTelemetry specification. By embracing this ecosystem:

• We can provide a high-fidelity implementation.
• The core vocabulary is shared across the multiple languages in your distributed system.
• Your telemetry can be exported to the growing network of vendors who support the protocol.

Meanwhile, the API is purely functional, built on core Cats Effect abstractions, making it a natural fit into the Typelevel Scala ecosystem.

The API is highly experimental, but already capable of exporting traces and metrics. We welcome all library and application developers who want to try it on for size, but discourage making it a dependency of a binary-stable library at this point in time. We welcome your feedback in the form of issues, discussions, and pull requests.

---

This discussion was created from the release v0.1.0.

[rossabaker]

Example of how we would instrument a library like Skunk with otel4s. This is not an upstream pull request, but rather a proof-of-concept.

[rossabaker]

Example of http4s middlewares based on natchez-http4s-otel. Unlike the Skunk example, this doesn't yet compile. We still need to translate the concept of the kernel.

[iRevive]

Is there a plan to integrate otel4s into http4s core?

[rossabaker]

Maybe not core, but I strongly believe backends should. http4s observability is currently based on middlewares, which by the laws of nature can't measure anything that happens before the request is parsed and delivered to the middleware.

Not everybody shares this belief, so I'm not sure which will be first, but they'll all have my encouragement.

[iRevive]

I've updated typelevel/keypool#396. Well, keypool is cross-compiled for Scala 2.12, otel4s - isn't.

Same story with Skunk.

[rossabaker]

Oh, I hadn't done any crossbuilding in my Skunk PoC. I'm sure some library maintainers could be talked into dropping 2.12 (http4s-1.0 does), but I don't want to do an ecosystem ripple just for that. 🤔