Release 1.58.0

Context

• Clarify that environment variable propagation carriers normalize requested
  keys, carrier keys, and returned keys.
  (#5102)
• Specify that environment variable propagation carriers only read and return
  normalized environment variable names.
  (#5144)
• Specify that an empty environment variable propagation name is non-normalized
  and normalizes to _.
  (#5163)

Profiles

• Remove duplicate information from and extend Profiles documentation (README.md, pprof.md).
  (#4932)

Entities

• Add specification for communicating entity information as structured log events.
  (#4836)

Common

• Add an in-development SDK self-observability
  section, referenced from the Tracing, Metrics, and Logs SDK specs.
  (#5087)
• Clarify non-OTLP representation guidance for nested AnyValue values in
  arrays and maps.
  (#5053)
• Add in-development guidance recommending a JSON object as the string
  representation for an attribute in non-OTLP protocols.
  (#5028)
• Add in-development guidance recommending a JSON object as the string
  representation for an attribute collection in non-OTLP protocols.
  (#5110)

Compatibility

• Deprecate OpenCensus compatibility requirements in the specification.
  (#5138)
• Stabilize sections of Prometheus Metrics Exporter.
  • Clarify resource attributes configuration.
    (#5084)
  • Stabilize the conversion of OTLP Summaries into Prometheus Summaries.
    (#5107)
  • Stabilize client libs section.
    (#5106)
  • Stabilize Prometheus Metrics Exporter default aggregation configuration.
    (#5113)
• Stabilize sections of Prometheus and OpenMetrics Compatibility.
  • Stabilize OpenTelemetry Histogram to Prometheus Histogram transformation.
    (#5091)
• Add optional OpenTelemetry Histogram to Prometheus Native Histogram with Custom Buckets transformation.
  (#5091)

SDK Configuration

• Add link to declarative config IdGenerator type
  (#5133)

OTEPs

• Context-scoped Attributes.
  (#4931)

New Contributors

• @itssaharsh made their first contribution in #5112
• @christos68k made their first contribution in #4932
• @Krishnachaitanyakc made their first contribution in #5138