opentelemetry-kotlin 1周年 これまでの歩みと、これからのコントリビューション/opentelemetry-kotlin: A Year of Progress, an Invitation to Contribute

2026/09/08 開催の「Kotlin 15周年記念イベント」の登壇資料です。

https://kotlin.connpass.com/event/402617/

Transcript

1. opentelemetry-kotlin 1周年 これまでの歩みと、これからのコントリビューション 2026/09/08 Kotlin 15周年記念イベント Masaki Sugimoto
2. 目次 はじめに opentelemetry-kotlin の今までを説明する 私と opentelemetry-kotlin の関わり opentelemetry-kotlin にコミットしてみよう otel-kotlin の Maintainer からのメッセージ まとめ 1
3. 目次 はじめに opentelemetry-kotlin の今までを説明する 私と opentelemetry-kotlin の関わり opentelemetry-kotlin にコミットしてみよう otel-kotlin の Maintainer からのメッセージ まとめ 2
4. はじめに 自己紹介 名前 Masaki Sugimoto 所属 株式会社ヘンリー 現在のロール レセコン一体型電子カルテ「Henry」のレセコン側の SWE 過去の経歴 Yahoo!オークション・Yahoo!フリマの SWE → SRE オブザーバビリティまわりでいろいろやっています opentelemetry-kotlin approver（opentelemetry-kotlin の approve 権限保持者） OpenTelemetry docs-ja-approver（日本語ドキュメントのレビュー権限保持者） Mackerel アンバサダー 技術サークル「天体可観測」で同人誌執筆 Observability Conference Tokyo 2025（O11y Con Tokyo）実行委員 3
5. はじめに 登壇目的 opentelemetry-kotlin が寄贈されてから、もうすぐ 1 周年！ めでたい！せっかくなので、これまでの流れを説明する みなさんにコミットしてほしい！ 機能が不足しており、まだまだやることは多い 登壇内容 opentelemetry-kotlin の今までを説明する opentelemetry-kotlin と私の関わり opentelemetry-kotlin の簡単なアーキテクチャと基礎 opentelemetry-kotlin の Maintainer からのメッセージ 4
6. 目次 はじめに opentelemetry-kotlin の今までを説明する 私と opentelemetry-kotlin の関わり opentelemetry-kotlin にコミットしてみよう otel-kotlin の Maintainer からのメッセージ まとめ 5
7. opentelemetry-kotlin の今までを説明する 今までの歴史 6
8. opentelemetry-kotlin の今までを説明する 当初と現在 もうすぐ 1 年が経過するが…… 正直、機能が不十分で、本番環境で利用できるレベルではない 2026 年 9 月時点では、Trace、Log、Metrics のすべてが Development 過去の PR でクリティカルなバグを修正しており、現在も不安 完成したと思っていた機能が OpenTelemetry Spec に準拠していなかったこともある 7
9. 目次 はじめに opentelemetry-kotlin の今までを説明する 私と opentelemetry-kotlin の関わり opentelemetry-kotlin にコミットしてみよう otel-kotlin の Maintainer からのメッセージ まとめ 8
10. 私と opentelemetry-kotlin の関わり approver になるきっかけ org に移行される前のリポジトリ（embrace）で、コミットできた ちょうど Approver の募集もしていた 9
11. 私と opentelemetry-kotlin の関わり 過去のコントリビューション（AI 要約）（1/2） 2026 年 8 月 30 日時点の GitHub 公式データを調べました。 一言でまとめると、Msksgm はプロジェクト初期からレビューに参加し、その後は 「OpenTelemetry 仕様への準拠」「Sampling/Trace の正しさ」「Kotlin API の安全性・性能」を 中心に実装を担ってきました。 活動 実績 作成した PR 13件 マージ済み PR / main へのコミット 10件 クローズ・未マージ 3件 10
12. 私と opentelemetry-kotlin の関わり 過去のコントリビューション（AI 要約）（2/2） OpenTelemetry 仕様への準拠 #608 Sampler に attributes と links を正しく渡す 従来は shouldSample に空の attributes/links が渡されていた問題を修正。順序、上限、重複排 除までテストしています。実装規模もマージ済み PR 中で最大級です。 #587 AlwaysRecordSampler の実装 DROP を RECORD_ONLY に変換する組み込み Sampler を、Kotlin 実装と Java 互換層の両方へ追 加しました。 #589 非サンプリングSpanをexportしないよう修正 RECORD_ONLY の Span が Exporter まで流れてしまう仕様違反を修正。Simple、Batch、 Persistence、In-memory の各 Processor に適用しています。 #595 TextMapPropagator の carrier を nullable に変更 TextMapGetter / TextMapSetter のシグネチャを OpenTelemetry 仕様に合わせ、互換実装やテ ストも更新しました。 11
13. 私と opentelemetry-kotlin の関わり コントリビューションを振り返って 想像以上にやることが残っていた Development なのはわかっていたが、想定以上だった コミットのハードルは低い 仕様への追従やバグ修正は、他言語（Go/Java）の実装を読めれば、なおさら取り組みやすい 仕様を読んで実装に落とし込むのが楽しい 小さく始められる。オブザーバビリティに詳しくなれる メンテナーの人たちがあったけえ しばらく対応できなかった時期に DM がきた 12
14. 目次 はじめに opentelemetry-kotlin の今までを説明する 私と opentelemetry-kotlin の関わり opentelemetry-kotlin にコミットしてみよう otel-kotlin の Maintainer からのメッセージ まとめ 13
15. opentelemetry-kotlin にコミットしてみよう OpenTelemetry のアーキテクチャ概要 「実践 OpenTelemetry」より引用。 14
16. opentelemetry-kotlin にコミットしてみよう リポジトリ内のディレクトリとの対応（解釈） 15
17. opentelemetry-kotlin にコミットしてみよう opentelemetry-kotlin モジュールとの対応 16
18. opentelemetry-kotlin にコミットしてみよう どのようなときに修正するのか 17
19. opentelemetry-kotlin にコミットしてみよう Tracer SDK の実装と OTel Specification の対応例 18
20. opentelemetry-kotlin にコミットしてみよう Issue が起票される 19
21. opentelemetry-kotlin にコミットしてみよう （推定） Good Fist Issues （現在）Metrics API や Configurations 系は比較的取り組みやすいかも 20
22. opentelemetry-kotlin にコミットしてみよう コミットしよう！ 21
23. 目次 はじめに opentelemetry-kotlin の今までを説明する 私と opentelemetry-kotlin の関わり opentelemetry-kotlin にコミットしてみよう otel-kotlin の Maintainer からのメッセージ まとめ 22
24. otel-kotlin の Maintainer からのメッセージ 「Kotlin 15周年記念イベントで紹介するよ」に対して 英語（原文ママ） Thanks for letting us know! From my POV, I think the Tracing/Logging APIs are getting closer to stabilisation, although we're still a few months away from calling both stable. That matches what is written in our high-level roadmap: https://github.com/open-telemetry/opentelemetrykotlin/blob/main/ROADMAP.md It would be really helpful asking folks to try out the project in their own applications and give feedback on whether they would like anything to change on the API or the behavior of the library. Contributors are always welcome too. There are lots of issues in our Github tracker right now, so it's a good opportunity if anybody is looking for an open-source project. 日本語（AI 翻訳） お知らせいただきありがとうございます！ 私の見解では、Tracing API と Logging API は安定版にかなり近づいてきています。ただし、両方を安定版と呼べるようになるまでには、まだ数か月 かかる見込みです。これは、概要レベルのロードマップに記載されている内容とも一致しています： https://github.com/opentelemetry/opentelemetry-kotlin/blob/main/ROADMAP.md 皆さんに実際のアプリケーションでこのプロジェクトを試してもらい、API やライブラリの挙動について変更してほしい点がないか、フィードバックを 寄せてもらえるよう呼びかけていただけると、とても助かります。 もちろん、コントリビューターもいつでも歓迎です。現在、GitHub の Issue トラッカーには多くの Issue があるので、参加するオープンソースプロジ ェクトを探している方にとっては、良い機会だと思います。 23
25. otel-kotlin の Maintainer からのメッセージ ほかに個人的に気になったこと（意訳） Q. Ktor のライブラリ計装は、opentelemetry-java にもあるけど吸収する予定ですか？ A. 主要な Kotlin ライブラリは Contrib に追加する予定です（現在は Stable 化を優先しています） Q. opentelemetry-android は opentelemetry-kotlin の安定化により、今後なくなりますか？ A. リポジトリ自体は残り、依存先が opentelemetry-java から opentelemetry-kotlin に変わります 24
26. otel-kotlin の Maintainer からのメッセージ 元画像 #otel-kotlin で気軽に質問できます。CNCF Slack に入ろう！ 25
27. 目次 はじめに opentelemetry-kotlin の今までを説明する 私と opentelemetry-kotlin の関わり opentelemetry-kotlin にコミットしてみよう otel-kotlin の Maintainer からのメッセージ まとめ 26
28. まとめ opentelemetry-kotlin の今までを説明する 2026 年 1 月、opentelemetry org に寄贈された 不足している機能は多いが、開発は活発 opentelemetry-kotlin と私の活動 私の活動内容を紹介 opentelemetry-kotlin のコミット内容を紹介 opentelemetry-kotlin にコミットしてみよう OpenTelemetry の基本的なアーキテクチャを紹介 opentelemetry-kotlin と Specification の対応例を紹介 opentelemetry-kotlin の Maintainer からのメッセージ #otel-kotlin からメッセージをもらいました 27