Усунення несправностей

Увімкнення налагоджувального логування

Щоб побачити, що робить інструмент під час збірки, увімкніть режим налагодження:

otelc --debug go build -o myapp .

Налагоджувальний вивід, включаючи файл debug.log, записується до робочої теки інструменту (зазвичай тека .otelc-build у вашому модулі). Перевірте його, щоб побачити, які правила спрацювали та яке інструментування було впроваджено.

Телеметрія не продукується

1. Переконайтеся, що бінарний файл було зібрано через otelc, а не звичайним go build.
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 для запитань
• Канал #otel-go-compt-instr-sig у CNCF Slack