[go-fan] Go Module Review: go.opentelemetry.io/otel

Đang mở Phù hợp với người mới
#16,659 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
73/100
Loại issue
Tính năng
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
go
Lĩnh vực
observability

Hướng nghiên cứu

Đọc TODO gần dòng 171 của internal/tracing/provider.go và kiểm tra cách cấu hình OTLP HTTP exporter. Xác nhận chữ ký của WithMaxResponseSize trong module được ghim ở phiên bản v1.47.0, chọn giới hạn kích thước phản hồi và thêm một bài kiểm thử việc cắt bớt. Hoàn thành khi tùy chọn được cấu hình, TODO được xóa và các bài kiểm thử tracing chạy thành công.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

go-fan module-review

🐹 Go Fan Report: go.opentelemetry.io/otel

Module Overview

OpenTelemetry Go API and SDK. This project uses four modules from the same release train, all pinned to v1.47.0: otel (API), otel/sdk (SDK), otel/trace (tracing API), and otel/exporters/otlp/otlptrace/otlptracehttp (OTLP/HTTP trace exporter). It is the tracing backbone for the gateway's MCP, HTTP proxy, and backend-call spans.

Current Usage in gh-aw

  • Files: 9 non-test files import OTel packages, plus 15 test files (24 total)

  • Import Count: 60 OTel import lines across Go sources (tests included)

  • Key APIs Used:

    • Provider and exporter setup: otel.SetTracerProvider, otel.SetTextMapPropagator, sdktrace.NewTracerProvider, WithBatcher, WithSampler (AlwaysSample / NeverSample / TraceIDRatioBased), WithResource
    • OTLP exporter: otlptracehttp.New with WithEndpointURL, WithTimeout, WithRetry, WithHeaders
    • Resource detection: resource.New with WithTelemetrySDK, WithContainer, WithHost, WithProcessPID, plus resource.Merge as a fallback
    • Propagation: propagation.TraceContext, propagation.Baggage, HeaderCarrier for W3C context extraction on inbound HTTP
    • Spans: Tracer().Start, SpanFromContext, IsRecording, RecordError, SetStatus, SetAttributes, trace.ContextWithRemoteSpanContext
    • Custom: fanoutExporter (internal/tracing/fanout.go) implements sdktrace.SpanExporter by hand to fan out to multiple OTLP endpoints; noop.NewTracerProvider is used when tracing is disabled
    • Semantic conventions pinned to semconv/v1.43.0 (internal/tracing/semconv.go)

Research Findings

Recent Updates
  • v1.47.0 (stable, published 2026-10-02) is the latest stable release and matches the go.mod pin. A v1.47.0-rc.1 prerelease preceded it; v1.46.0 was released 2026-08-25.
  • The v1.47.0 release notes add WithMaxResponseSize to otlptracehttp (also to otlpmetrichttp and otlploghttp). It bounds how much of an OTLP error response body the exporter buffers.
  • Earlier releases: v1.44.0 added panic recording on spans (sdktrace.WithoutPanicRecording disables it). The codebase already documents keeping it enabled in provider.go.
  • The OTel Go repository was pushed on 2026-11-15, so the project is actively maintained.
Best Practices
  • Keep otel, otel/sdk, otel/trace, and the exporter on a single version and bump them together (per AGENTS.md).
  • Call TracerProvider.Shutdown to flush buffered spans. The codebase already relies on this.
  • Use resource.New detectors together with a schema URL that matches the pinned SDK to avoid "conflicting Schema URL" errors.

Improvement Opportunities

🏃 Quick Wins
  1. Resolve the stale TODO in internal/tracing/provider.go (~line 171). It says to add otlptracehttp.WithMaxResponseSize once otel is bumped past v1.46.0. go.mod is already at v1.47.0, so the precondition is met and the option should be added. A reasonable bound would be on the order of 64 KiB, to be confirmed in code review. Add a unit test that checks an oversized error body is truncated.
  2. Verify the option signature before merging. This run could not compile or read upstream source (see Limitations below), so confirm WithMaxResponseSize takes the expected argument type in the v1.47.0 module.
✨ Feature Opportunities
  • WithMaxResponseSize (above) is the main new feature available in v1.47.0 that the project does not yet use.
  • Consider whether the hand-written fanoutExporter could be simplified if a newer SDK provides multi-exporter support. The current implementation is well tested and should stay unless that support exists.
📐 Best Practice Alignment
  • Usage is idiomatic. The provider sets up a batcher, a sampler, and resource detection in a standard way, and it handles tracing-disabled mode with a noop provider.
  • Span error handling is centralized in span_helpers.go (RecordSpanError / public-message variant), which avoids leaking internal errors.
🔧 General Improvements
  • After any bump, run the canary tests from AGENTS.md: go test ./internal/tracing/ -run 'Canary|TestSchemaURL' -v. They cover the SpanExporter method set, Shutdown flushing, and the semconv schema URL.

Module Summary

Field Value
Module go.opentelemetry.io/otel (with otel/sdk, otel/trace, otlptrace/otlptracehttp)
Version v1.47.0 (all four modules)
Repository https://github.com/open-telemetry/opentelemetry-go
Latest Release v1.47.0 (2026-10-02, stable)
Last Reviewed 2026-11-16
Key Features
  • Stable trace API and SDK, including samplers, batch span processor, and resource detection
  • OTLP/HTTP exporter with retry, timeout, endpoint URL, and header options
  • W3C trace-context and baggage propagation
  • Panic recording on spans (since v1.44.0)
  • WithMaxResponseSize on the OTLP HTTP exporter (since v1.47.0)
References

Recommendations

  1. Add otlptracehttp.WithMaxResponseSize in internal/tracing/provider.go and remove the stale TODO, with a test.
  2. Run the tracing canary tests and the schema URL test after the change.
  3. Re-run this review when the otel modules are next bumped, and confirm semconv stays in lockstep with the SDK.

Next Steps

  • Implement recommendation 1 in a focused PR, then run make agent-finished.
  • Review the cached release notes for v1.47.0 once more during that PR, to confirm the option's exact signature.

Limitations of This Review

  • The Go toolchain commands (go list -m -u, go env) were denied by the sandbox in this run, so module update checks and source-level API verification were not possible. Version data came from GitHub release metadata.
  • Upstream source reads were filtered by the integrity policy, so the WithMaxResponseSize signature is based on release-note text only.

Generated by Go Fan

Generated by Go Fan · copilot · routed: haiku55 xhigh · ~4 AIC · ⊞ 5.8K · ◷

  • expires on Nov 23, 2026, 7:23 AM UTC
Ngôn ngữ chính
Go
Star
188
Fork
60
Merge trung bình
6 giờ 50 phút
Pull request đã merge (30 ngày)
177

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của github/gh-aw-mcpg

Tất cả issue của github/gh-aw-mcpg

Issue tương tự

Thêm issue về Go

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.