feat(logger): add CtxLogger interface for OpenTelemetry trace integration

[MrSibe]

Summary

Implements context-aware logging with automatic OpenTelemetry trace correlation for distributed tracing.

Related issue: #3182

What's New

• CtxLogger interface: Extends Logger with context-aware methods (CtxInfof, CtxErrorf, etc.)
• Automatic trace injection: Logs automatically include trace_id, span_id, trace_flags from context
• Dual logger support: Works with both Zap and Logrus
• Optional error recording: Can record error logs to OpenTelemetry spans
• Backward compatible: Existing code works without changes
• Opt-in: Disabled by default, enabled via configuration

Configuration

dubbo:
  logger:
    driver: zap
    level: info
    format: json
    trace-integration:
      enabled: true
      record-error-to-span: true

[codecov-commenter]

Codecov Report

❌ Patch coverage is 73.93162% with 61 lines in your changes missing coverage. Please review.
✅ Project coverage is 47.96%. Comparing base (60d1c2a) to head (52048eb).
⚠️ Report is 728 commits behind head on develop.

Files with missing lines	Patch %	Lines
logger/core/logrus/ctx_logger.go	68.11%	11 Missing and 11 partials ⚠️
logger/core/zap/ctx_logger.go	68.11%	11 Missing and 11 partials ⚠️
config/logger_config.go	53.33%	5 Missing and 2 partials ⚠️
logger/trace_extractor.go	73.33%	2 Missing and 2 partials ⚠️
logger/core/logrus/logrus.go	50.00%	2 Missing and 1 partial ⚠️
logger/core/zap/zap.go	50.00%	2 Missing and 1 partial ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #3195      +/-   ##
===========================================
+ Coverage    46.76%   47.96%   +1.20%     
===========================================
  Files          295      464     +169     
  Lines        17172    33659   +16487     
===========================================
+ Hits          8031    16146    +8115     
- Misses        8287    16210    +7923     
- Partials       854     1303     +449     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Rinai-R]

合并之后可以在samples里面加个示例

[Copilot]

Pull request overview

This PR implements context-aware logging with automatic OpenTelemetry trace correlation to enable distributed tracing support in Dubbo-Go. The implementation adds a new CtxLogger interface that extends the base Logger interface with context-aware methods, allowing logs to automatically include trace_id, span_id, and trace_flags from the OpenTelemetry context.

Changes:

• Added CtxLogger interface with context-aware logging methods (CtxDebug, CtxInfo, CtxWarn, CtxError and their formatted variants)
• Implemented trace extraction utilities to extract OpenTelemetry trace information from context
• Provided implementations for both Zap and Logrus logging frameworks with optional error recording to spans
• Added configuration support for trace integration via YAML with opt-in enablement

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
logger/base.go	Added CtxLogger interface extending Logger with context-aware methods
logger/trace_extractor.go	Implemented trace field extraction from OpenTelemetry context
logger/trace_extractor_test.go	Comprehensive tests for trace extraction and validation logic
logger/core/zap/ctx_logger.go	Zap implementation of CtxLogger with trace field injection and optional span error recording
logger/core/zap/ctx_logger_test.go	Tests for Zap context logger covering various logging scenarios
logger/core/zap/zap.go	Integration of CtxLogger into Zap logger instantiation based on configuration
logger/core/logrus/ctx_logger.go	Logrus implementation of CtxLogger with trace field injection and optional span error recording
logger/core/logrus/ctx_logger_test.go	Tests for Logrus context logger covering various logging scenarios
logger/core/logrus/logrus.go	Integration of CtxLogger into Logrus logger instantiation based on configuration
config/logger_config.go	Added TraceIntegrationConfig structure and configuration mapping to URL parameters
common/constant/key.go	Added configuration keys for trace integration settings

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Alanxtl]

1. 这个新的api兼容new api吗
2. dubbo-website 里面写一下文档，介绍一下使用方式
3. 写 samples

[MrSibe]

1. 这个新的api兼容new api吗
2. dubbo-website 里面写一下文档，介绍一下使用方式
3. 写 samples

目前仅支持 Old API, 我把 New API 的加上

[Alanxtl]

现在还是没有new api的使用接口呀

[sonarqubecloud]

Quality Gate passed

Issues
30 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
22.2% Duplication on New Code

See analysis details on SonarQube Cloud

[MrSibe]

Usage

Old API

config.NewLoggerConfigBuilder().
    SetDriver("zap").
    SetTraceIntegrationEnabled(true).
    SetRecordErrorToSpan(true).
    Build()

New API

logger.NewOptions(
    logger.WithZap(),
    logger.WithTraceIntegration(true),
    logger.WithRecordErrorToSpan(true),
)

YAML config

dubbo:
  logger:
    driver: zap
    trace-integration:
      enabled: true
      record-error-to-span: true

Logging with CtxLogger

// get logger
log := logger.GetLogger().(logger.CtxLogger)

// log with context
log.CtxInfo(ctx, "message")
log.CtxInfof(ctx, "user: %s", name)
log.CtxError(ctx, "error")
log.CtxErrorf(ctx, "failed: %v", err)

[Alanxtl]

cool work lgtm
don't forget to write doc in dubbo-website