[ltowarek]

[SDK] Clamp BatchSpanProcessor max_export_batch_size to max_queue_size

Changes

Since #4466, BatchSpanProcessor waits for a full batch before it exports. If max_export_batch_size is larger than max_queue_size, a full batch never arrives. Spans are then exported only when schedule_delay_millis expires, and new spans are dropped once the queue is full.

The specification says the batch size must be less than or equal to the queue size, so such values are invalid. They still worked before #4466, though. Since #4466, apps that use them lose spans, and nothing points at the configuration as the cause.

The fix is based on the Java and Python SDKs, which both refuse such values. Java clamps the batch size to the queue size and logs a warning (BatchSpanProcessorBuilder). Python raises a ValueError (BatchSpanProcessor). opentelemetry-cpp must also work without exceptions, so this PR does what Java does: it clamps and logs one warning at construction. A max_queue_size of 0 is left alone, because clamping to it would make the worker spin.

For significant contributions please make sure you have completed the following items:

• CHANGELOG.md updated for non-trivial changes
• Unit tests have been added
• Changes in public API reviewed

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 86.72%. Comparing base (ac7b87a) to head (8655fc2).

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4727      +/-   ##
==========================================
+ Coverage   86.69%   86.72%   +0.03%     
==========================================
  Files         527      528       +1     
  Lines       20902    20915      +13     
==========================================
+ Hits        18119    18136      +17     
+ Misses       2783     2779       -4     

Files with missing lines	Coverage Δ
sdk/src/trace/batch_span_processor.cc	92.35% <100.00%> (+3.59%)	⬆️

... and 1 file with indirect coverage changes

🚀 New features to boost your workflow:

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