Publish opentelemetry-instrumentation-api to maven central and add marker base interface for SemanticConvention's

[as-polyakov]

Hello folks

we intend to use TypedSpans in our instrumentations and would like to:

1. Have "io.opentelemetry.instrumentation:opentelemetry-instrumentation-api" available on maven central
2. Have all typed spans implement some marker interface, I would propose having a "BaseSemanticConversion" interface to be extended by all *SemanticConversion interfaces implemented by typed spans. This way I can demand in our instrumentation code that we use an instance of typed span

I can submit PR for both

[trask]

Hi @parallelstream, we aren't using the TypedSpans (yet?), and considering moving them to https://github.com/open-telemetry/opentelemetry-java/tree/master/extensions

@iNikem what do you think?

[iNikem]

I don't think typed spans are ready for wide adoption yet. We haven't used them ourselves, so we cannot guarantee anything about them: will they live, where will they live, what's their API etc etc.

[as-polyakov]

hey, understood. Is there anything I can do to help moving this forward? Seems natural for me that they need to be available as an implementation of semantic convention in some form. All I am trying to achieve currently - enforce semantic convention usage in our code (hence the need for marker interface) and give a "starter pack" for typical scenarios (hence the need for artifact)

[iNikem]

Is there anything I can do to help moving this forward?

You can try to submit a PR or two where some instrumentation tracers use those typed spans. We need a proof-of-concept/example usage to iron out all rough edges.

enforce semantic convention usage in our code

Do you have any ideas how to achieve that?

[as-polyakov]

You can try to submit a PR or two where some instrumentation tracers use those typed spans. We need a proof-of-concept/example usage to iron out all rough edges.

sure, I can do that

Do you have any ideas how to achieve that?

yes, hence the need for the marker interface. I was thinking of doing smith like this:

public interface HttpSemanticConvention extends BaseSemanticConvention {
...
}

public interface MySpanLogic <T extends BaseSemanticConvention> {
   public T createMySpan();
...
}

[trask]

Closing, opentelemetry-instrumentation-api is in maven central now. TypedSpans were not being used so have been removed. Implementation of the new instrumenter API is being tracked in #2713.