Release v1.17.0

v1.17.0 (2023-01-17)

Context

• No changes.

Traces

• Clarify that the BatchSpanProcessor should export batches when the queue reaches the batch size
  (#3024)
• Deprecate jaeger exporter, scheduled for spec removal in July 2023.
  #2858

Metrics

• Rename built-in ExemplarFilters to AlwaysOn, AlwaysOff and TraceBased.
  (#2919)
• Add MaxScale config option to Exponential Bucket Histogram Aggregation.
  (#3017)
• Rename exponential bucket histogram aggregation to base 2 exponential histogram
  aggregation. Rename OTEL_EXPORTER_OTLP_METRICS_DEFAULT_HISTOGRAM_AGGREGATION
  value from exponential_bucket_histogram to
  base2_exponential_bucket_histogram.
  Mark exponential histogram data model and base2 exponential histogram aggregation as stable.
  (#3041)

Logs

• Clarify usage of log body for structured logs
  (#3023)

Resource

• No changes.

Semantic Conventions

• Clarify common HTTP attributes apply to both clients and servers
  (#3044)
• Add code.lineno source code attribute
  (#3029)
• Add ClickHouse to db.system semantic conventions
  (#3011)
• Refactor messaging attributes and per-message attributes in batching scenarios.
  (#2957).
  BREAKING: rename messaging.consumer_id to messaging.consumer.id,
  messaging.destination to messaging.destination.name,
  messaging.temp_destination to messaging.destination.temporary,
  messaging.destination_kind to messaging.destination.kind,
  messaging.message_id to messaging.message.id,
  messaging.protocol to net.app.protocol.name,
  messaging.protocol_version, net.app.protocol.version,
  messaging.conversation_id to messaging.message.conversation_id,
  messaging.message_payload_size_bytes to messaging.message.payload_size_bytes,
  messaging.message_payload_compressed_size_bytes to messaging.message.payload_compressed_size_bytes,
  messaging.rabbitmq.routing_key: messaging.rabbitmq.destination.routing_key,
  messaging.kafka.message_key to messaging.kafka.message.key,
  messaging.kafka.consumer_group to messaging.kafka.consumer.group,
  messaging.kafka.partition to messaging.kafka.destination.partition,
  messaging.kafka.tombstone to messaging.kafka.message.tombstone,
  messaging.rocketmq.message_type to messaging.rocketmq.message.type,
  messaging.rocketmq.message_tag to messaging.rocketmq.message.tag,
  messaging.rocketmq.message_keys to messaging.rocketmq.message.keys;
  Removed messaging.url;
  Renamed send operation to publish;
  Split destination and source namespaces and clarify per-message attributes in batching scenarios.

Compatibility

• Add Tracer.Close() to the OpenTracing Shim layer (#3048).
• Add OpenCensus migration guide and add BinaryPropagation as an option to gRPC
  instrumentation for OpenCensus compatibility
  (#3015).

OpenTelemetry Protocol

• Add table for OTLP/HTTP response code and client retry recommendation
  (#3028)
• Remove spaces from example exporter User-Agent header to conform to RFC7231 & RFC7230.
  (#3052)

SDK Configuration

• Rename knowns values for OTEL_METRICS_EXEMPLAR_FILTER to always_on,
  always_off and trace_based.
  (#2919)

Telemetry Schemas

• No changes.

Common

• No changes.

New Contributors

• @utezduyar made their first contribution in #3020
• @newly12 made their first contribution in #3028
• @jordigh made their first contribution in #3029
• @v-electrolux made their first contribution in #3011
• @robbkidd made their first contribution in #3052
• @martincostello made their first contribution in #3108

Full Changelog: v1.16.0...v1.17.0