トラブルシューティング

デバッグログの有効化

ビルド中にツールが何を行っているかを確認するには、デバッグモードを有効にします。

otelc --debug go build -o myapp .

debug.log ファイルを含むデバッグ出力は、ツールの作業ディレクトリ（デフォルトではモジュール内の .otelc-build ディレクトリ）に書き込まれます。 どのルールがマッチし、どの計装が注入されたかを確認するために、このファイルを調べてください。

テレメトリーが生成されない

1. バイナリが通常の go build ではなく otelc を通してビルドされたことを確認してください。
2. アプリケーションが実際にサポートされているライブラリを使用していること、 そして依存しているバージョンが計装ルールで宣言されたサポート範囲内であることを確認してください。
3. エクスポーターの設定を確認してください。 OTEL_EXPORTER_OTLP_ENDPOINT が未設定または誤っている場合、テレメトリーの送信先がありません。 エクスポートエラーを表示するには OTEL_LOG_LEVEL=debug を設定してください。
4. OTEL_GO_ENABLED_INSTRUMENTATIONS または OTEL_GO_DISABLED_INSTRUMENTATIONS によって計装が無効化されていないことを確認してください。

ビルドアーティファクトのクリーンアップ

ビルドが予期しない動作をする場合、以前のセットアップおよびビルドフェーズで作成されたアーティファクトを削除し、クリーンな状態からリビルドしてください。

otelc cleanup

ヘルプの入手

• バグについては GitHub issues
• 質問については GitHub discussions
• CNCF Slack の #otel-go-compt-instr-sig チャンネル