Implementation for OTel Span API

[bidetofevil]

Goal

Create EmbSpan, a wrapper implementation of the OTel Span API object that will call into EmbraceSpan in order to do span operations.

The current architecture is not ideal, as we have an Embrace OTel API implementation that wraps an Embrace Span API implementation that in turn wraps the official Java SDK Span API implementation. Ideally, all the Embrace-specific logic exists in Embrace OTel API implementation, and the Embrace Span API implementation just wraps around that. But that is a much bigger change, and will likely require refactoring the builder objects as well, so I just want to get this to work first before doing that heavy lifting.

Note: I did not implement the ability to add SpanLinks and a status description , as those are features that are not surfaced in the Embrace implementation. We can look to implement this in the future.

Testing

Unit test on EmbSpan to test the entire API surface.

[bidetofevil]

• Expose OTel Tracer API through Embrace SDK #911
• Flesh out synchronization of EmbraceSpan functionality #938
• Synchronize status setting of EmbSpan #944
• Implementation for Tracer, TracerBuilder, and TracerProvider OTel APIs #910
• Implementation of OTel SpanBuilder API #930
• Store and use EmbraceSpan in an OTel Context object  #925
• Propagate full parent context in EmbraceSpanBuilder #909
• Add ability to reset parent and add SpanKind to EmbraceSpanBuilder #919
• Change storage and application of start time on wrappers #918
• Refactor attribute storage in EmbraceSpan and EmbraceSpanBuilder #917
• Create Span with EmbraceSpanBuilder in SpanService #908
• Create a span with EmbraceSpanBuilder from factory #907
• Implementation for OTel Span API #906 👈
• Add ability to rename spans that have not ended #903 : 1 other dependent PR (#867 )
• Add extension function to turn OTel Attributes into a map of strings #902
• Record exception happening during a span as a SpanEvent #897
• Move EmbraceSerializer to InitModule #896
• master

This stack of pull requests is managed by Graphite. Learn more about stacking.

Join @bidetofevil and the rest of your teammates on Graphite

[fractalwrench]

LGTM

[codecov]

Codecov Report

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

Project coverage is 80.92%. Comparing base (e944cba) to head (4a3f045).

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #906      +/-   ##
==========================================
+ Coverage   80.86%   80.92%   +0.05%     
==========================================
  Files         437      438       +1     
  Lines       11660    11689      +29     
  Branches     1784     1787       +3     
==========================================
+ Hits         9429     9459      +30     
+ Misses       1445     1443       -2     
- Partials      786      787       +1     

Files	Coverage Δ
...droid/embracesdk/internal/spans/EmbraceSpanImpl.kt	86.99% <100.00%> (+1.74%)	⬆️
...io/embrace/android/embracesdk/spans/EmbraceSpan.kt	85.71% <ø> (ø)
...mbrace/android/embracesdk/opentelemetry/EmbSpan.kt	96.42% <96.42%> (ø)

... and 2 files with indirect coverage changes