OpenTelemetryにおけるGoのゼロコード・コンパイル時計装について #fukuokago

「Fukuoka.go#23 - connpass」登壇資料

https://fukuokago.connpass.com/event/397937/

解説ブログ

GoのOpenTelemetryゼロコード計装、コンパイル時方式が安定版(v1)になったので動かしてみた #fukuokago
https://zenn.dev/quiver/articles/d7bdf991d562e5

Transcript

1. OpenTelemetryにおけるGoの ゼロコード・コンパイル時計装について 2026/07/21 Fukuoka.go#23 George Yoshida
2. 自己紹介 クラスメソッド株式会社の福岡オフィス@赤坂で働いています 最近のおしごとはClaudeのガバナンス支援がメインです 母国語はPythonです Fukuoka.goの参加は #20 以来2回目です 2
3. オブザーバビリティとOpenTelemetry 目的(オブザーバビリティ) : 外部からシステムの状態を理解できるようにする 要件(シグナル) ： アプリケーションがトレース・メトリクス・ログなどを出力する 手段(OpenTelemetry) ： 計装（シグナル出力）を手助けする仕組み https://opentelemetry.io/docs/concepts/observability-primer/ 3
4. ClaudeもOpenTelemetryに対応している https://code.claude.com/docs/en/monitoring-usage 4
5. Goがゼロコードなコンパイル時計装に対応した https://opentelemetry.io/docs/zero-code/go/compile-time/ 5
6. 3つのキーワード 計装(Instrumentation) : トレース、メトリクス、ログといったシグナルを送出 ゼロコード : ソースコードの変更不要 コンパイル時 : コンパイル時に計装コードを注入 6
7. GoのOpenTelemetry連携、3つの選択肢 手動計装: ソースコードで直接実装。ビジネスロジックなど自由度高い コンパイル時計装: ビルド時に注入。ランタイム・ライブラリ単位で対応 eBPF計装 (OBI): 言語・システム横断でOSレベルの観測 7
8. Goとゼロコード 対応済みのJava / Python / Node.js / .NET 等はランタイム型 起動時にエージェントをアタッチして計装できる Goは静的リンクされたシングルバイナリ 起動時に割り込むランタイムフックがない コンパイル時に割り込む 8
9. ビルドコマンドの頭に otelc を付けるだけ otelcのインストール go install go.opentelemetry.io/otelc/tool/cmd/otelc@latest ビルド otelc go build -o myapp main.go 内部的には以下と同等 otelc setup go build -toolexec=otelc toolexec ... 9
10. otelcは -toolexec でビルドに割り込む でコンパイルをインターセプト 対象関数にトランポリン呼び出し(軽量なフックポイント)を注入 go:linkname でフックと計装コードを自動生成・リンク -toolexec This approach provides dynamic instrumentation without runtime overhead or invasive code modifications. https://github.com/open-telemetry/opentelemetry-go-compileinstrumentation/blob/main/docs/getting-started.md#how-it-works 10
11. 何が注入されたかは確認できる $ ls -1F .otelc-build/debug/main/ go.mod otel.instrumentation.go # otelc.init_otelsdk.go # SDK otelc.runtime.go # 適用された計装の一覧 初期化コード(注入) 計装パッケージのインポート(注入) 11
12. otelc.init_otelsdk.go: SDK初期化のinit()を注入 main パッケージに直接注入 package main import "go.opentelemetry.io/otelc/pkg/runtime" func init() { runtime.SetupOTelSDK() // TracerProvider / MeterProvider runtime.StartRuntimeMetrics() // } ランタイムメトリクスの収集を開始 を初期化 12
13. otelc.runtime.go: 計装パッケージをブランクインポート はリンク時に対象シンボルがバイナリ内にないと解決できない 計装パッケージはユーザーコードから import されず、そのままではバイナリに入らな い ブランクインポート( import _ ) で計装パッケージをビルドに組み込み、フック実装を リンク可能にする go:linkname import _ "go.opentelemetry.io/otelc/instrumentation/google.golang.org/grpc/server" import _ "go.opentelemetry.io/otelc/instrumentation/log/slog" import _ "go.opentelemetry.io/otelc/instrumentation/net/http/server" ... 13
14. 対応ライブラリ ライブラリレベルで対応が必要 対応ライブラリ net/http、database/sql、log/slog (標準ライブラリ) grpc、go-redis、openai-go、etc. Goランタイムメトリクスも自動収集 14
15. 起動すると自動計装されたログが流れる $ ./myapp {"time":"2026-07-20T14:48:38.603039+09:00","level":"INFO", "msg":"trace provider initialized with auto-export"} {"time":"2026-07-20T14:48:38.603241+09:00","level":"INFO", "msg":"meter provider initialized with auto-export"} {"time":"2026-07-20T14:48:38.603645+09:00","level":"INFO", "msg":"logger provider initialized with auto-export"} {"time":"2026-07-20T14:48:38.603664+09:00","level":"INFO", "msg":"OpenTelemetry initialized", "instrumentation_name":"go.opentelemetry.io/otelc", "instrumentation_version":"dev"} {"time":"2026-07-20T14:48:38.603931+09:00","level":"INFO", "msg":"runtime metrics enabled"} 2026/07/20 14:48:38 INFO gRPC server listening on :50051 15
16. 要検証:動作確認で気になったこと net/http : トレースは出るがメトリクスは送信されない? instrumentation/net/http/semconv/server.go に RecordMetrics() は実 装されている 実行時のフック （ net/http/server/server_hook.go 、 .../client/client_hook.go ）はス パンの生成のみ? ログはtrace_idの相関付けにとどまる？ slog計装は slog.Record に trace_id / span_id を付与するだけ ログ本体をOTel LoggerProviderへ渡す処理がない slog のデフォルトロガーを差し替え ( slog.SetDefault(otelslog.NewLogger("myapp-grpc")) )が必要? 16
17. まとめ GoがOpenTelemetryのゼロコードなコンパイル時計装に対応 ビルド時に otelc オプションをつけるだけ 対応状況はライブラリ依存 17
18. 詳細はZennで。OpenTelemetryキャンペーンも開催中 https://zenn.dev/quiver/articles/d7bdf991d562e5 18