[Core] Tracing updates

[pvaneck]

This introduces native OpenTelemetry tracing to Azure Core. This is intended to be an alternative/replacement to the azure-core-tracing-opentelemetry plugin.

• opentelemetry-api is added as an optional dependency, and is needed to enable native tracing.
• A new TracerProvider class was added, and SDK developers can use this to set tracer metadata for their libraries.

  from azure.core.tracing import TracerProvider
  
  sdk_tracer_provider = TracerProvider(
      library_name="my-library",
      library_version="1.0.0",
     schema_url="https://opentelemetry.io/schemas/1.23.1",
     attributes={"namespace": "Sample.Namespace"},
  )

  • Instances of TracerProvider can be passed to the distributed_trace decorators and DistributedTracingPolicy.
• Added OpenTelemetryTracer and OpenTelemetrySpan classes to the azure.core.tracing namespace.
• settings.tracing_enabled is now the global setting for enabling/disabling tracing.
  • If settings.tracing_implementation is set, it will take precedence over the native core tracing.
• DistributedTracingPolicy updates
  • Now uses stable HTTP semantic conventions.
  • Span name updated to just be the HTTP method without the URL path (per OTel Semconv guidelines).
• A TracingOptions TypedDict was added for containing possible per-operation tracing configurations.
  • This includes enabled, attributes, and record_exception.
  • Sample usage: client.method(..., tracing_options={'enabled': True, 'attributes': {'key': 'value'}})
  • These will be propagated to both the distributed_trace decorators and DistributedTracingPolicy.

[azure-sdk]

API change check

APIView has identified API level changes in this PR and created following API reviews.

azure-core