[API/SDK] add WITH_LOG_FILTERING_PREVIEW option

[dbarker]

Follow up to #4079 (comment)

Changes

• adds WITH_LOG_FILTERING_PREVIEW option to guard the new log record filtering behavior
• updates tests to cover the option
• fixes some existing clang-tidy warnings in the impacted tests.

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 82.84%. Comparing base (e8c5f43) to head (3528600).

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4160      +/-   ##
==========================================
+ Coverage   82.82%   82.84%   +0.02%     
==========================================
  Files         406      406              
  Lines       16913    16909       -4     
==========================================
  Hits        14007    14007              
+ Misses       2906     2902       -4     

Files with missing lines	Coverage Δ
api/include/opentelemetry/logs/logger.h	81.12% <ø> (ø)
sdk/src/logs/logger.cc	90.30% <100.00%> (+0.58%)	⬆️

... and 2 files with indirect coverage changes

🚀 New features to boost your workflow:

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

[proost]

Thank you!

[lalitb]

Thanks.

[marcalff]

Thanks for the patch.

See questions, for my own understanding, I don't grasp the rationale behind it.

[dbarker]

In this case, the flag should be renamed to OPENTELEMETRY_ENABLE_LOG_FILTERING_PREVIEW to avoid polluting the user build, and how to do a build in the user application should be documented with clarity.

@marcalff since all these preview flags are set with INTERFACE they will transit publicly to any targets that link to the opentelemetry-cpp::api target. If we apply a prefix it likely should be applied to all public definitions. Could this be a follow up PR?

[marcalff]

LGTM