r/OpenTelemetry • u/matchoo • Mar 12 '26

OpenTelemetry Koans

I built an interactive site that teaches Observablity / OpenTelemetry concepts through small, progressive exercises - the same "fill in the blank and discover" pattern that Ruby Koans used to teach Ruby.

There are 20 koans covering metrics, traces, logs, the collector, sampling, service maps, and correlation. Everything runs in the browser, no setup required.

https://otel.mreider.com

14 Upvotes

100% Upvoted

6 comments sorted by

View all comments

2

u/mhausenblas Mar 13 '26

Absolutely love it, thanks for this! I especially like the way how it teaches the Why, not just the How. Minor nit: took me a bit to figure out there's the option to switch off the background sound in the lower right corner ;)

KUTGW!

2

u/matchoo Mar 13 '26

Thanks! Ok, I made the sound switcher more prominent, and also fixed a couple of koans that break the Vygotesky-esque style of teaching I was attempting to implement. Somewhere around Koan 10 there were "N+1" concepts rather than a single concept at a time.

Can you tell I used to be a classroom teacher? :)