Telemere: improved OpenTelemetry interop

[ptaoussanis]

Task: Look for opportunities to improve Telemere's OpenTelemetry support - incl. first-class conveyance of Telemere's trace info, etc.

Motivation: Telemere already supports basic interop with OpenTelemetry via its OpenTelemetry logging handler, but there's probably further opportunities to convey more information (notably Telemere spans) to OpenTelemetry in a way that better allows it to digest this info.

Pointers to relevant docs, etc. would be helpful if you have them!

[robert-stuttaford]

Watching Telemere with keen interest :-D We use Timbre for logging today, and have big plans to make use of Honeycomb in our next arc of observability work (we use https://github.com/steffan-westcott/clj-otel for our experiments at the moment).

Telemere looks like it would fit very neatly into our plans!

[duzunov]

I would be very happy to test OTel support in Telemere

[emowcee]

Really interested to see where the otel thread is leading! Following

[ptaoussanis]

Hi folks! 👋 I've just pushed Telemere v1 beta 18 to Clojars.

This includes the first experimental support for automatically emitting correlated logs and tracing data to OpenTelemetry.

See here for info on getting started. There's no special usage instructions - in principle you should just be able to use the regular Telemere API as always, and your signals will just be auto-converted in an appropriate way.

I'm not a big user of OpenTelemetry myself, so will definitely need help with testing and feedback from folks interested in this feature! 🙏 The kinds of feedback I'm looking for include:

• Usage reports (is everything working correctly, is it intuitive, etc.?)
• Feedback on output (how are the attribute names, coercions, etc.?)
• Any limitations (anything you want to do but can't?)
• Any other thoughts or suggestions! Now's the perfect time to get changes in, before Telemere itself is marked as stable.

The best places to leave feedback:

• The #telemere slack channel
• The Telemere GitHub (feel free to open an issue)

Thanks! Cheers :-)

[ptaoussanis]

Update: v1 beta 21 is now on Clojars and includes improved integration with OpenTelemetry tracing.

Telemere's tracing forms now emit code that interops directly with the OpenTelemetry tracing API when it’s present. This means that Telemere spans will show as expected within spans created by other (auto/manual) OpenTelemetry tools, and vice versa.

Barring any unexpected issues or suggested changes, this feature should now basically be complete.

[ptaoussanis]

Closing for now, but please feel free to ping if anyone runs into issues!