Logging bridge for Zap

[khushijain21]

Part of #5191

Some Notes:
Basic Structure - Zapcore implements
- Check - determines whether the supplied Entry should be logged
- Write
- Enabled
- Sync - we don't use buffer to write - so no code here
- With - returns a child core with provided context

This also implements zapcore.ObjectEncoder and zapcore.ArrayEncoder which decides how we would encode provided fields to log attrs - (the user can also pass their custom encoder)
Some Notes about type mapping:

• All Uint types are converted to Int64
• All complex types are converted to equiv string
• Everything else which uses zap.Any to pass context and if does not match supported primitive types - is handled by AddReflected method which converts the field to JSON

[codecov]

Codecov Report

Attention: Patch coverage is 71.92982% with 80 lines in your changes are missing coverage. Please review.

Project coverage is 62.1%. Comparing base (30ed923) to head (2989fcf).
Report is 8 commits behind head on main.

❗ Current head 2989fcf differs from pull request most recent head f60e0c3. Consider uploading reports for the commit f60e0c3 to get more accurate results

Additional details and impacted files

@@           Coverage Diff           @@
##            main   #5279     +/-   ##
=======================================
- Coverage   62.3%   62.1%   -0.3%     
=======================================
  Files        189     190      +1     
  Lines      11575   11673     +98     
=======================================
+ Hits        7221    7256     +35     
- Misses      4145    4205     +60     
- Partials     209     212      +3     

Files	Coverage Δ
bridges/otelzap/config.go	76.6% <76.6%> (ø)
bridges/otelzap/core.go	89.0% <89.0%> (ø)
bridges/otelzap/test_helper.go	73.7% <73.7%> (ø)
bridges/otelzap/encoder.go	61.5% <61.5%> (ø)

... and 7 files with indirect coverage changes

[MrAlias]

Good start

[MrAlias]

This module will need to be added to the project versions.yaml under the unreleased section.

[pellared]

https://github.com/open-telemetry/opentelemetry-go-contrib/actions/runs/8595139722/job/23549314101?pr=5279

Please run make to check for CI build errors.

[pellared]

Why do we even need to implement the encoders if the only think we have to provide is a zapcore.Core?

[pellared]

Can you use https://pkg.go.dev/go.opentelemetry.io/otel/log@v0.1.0-alpha.0.20240409140646-648b40eae158/logtest instead?

You can get it via go get go.opentelemetry.io/otel/log@v0.1.0-alpha.0.20240409140646-648b40eae158.

[pellared]

Changing this to a draft PR as I assume this is a "reference/design PR".