v0.4.0

This release has a significant number of breaking changes, new additions and fixes. The breaking changes reflect a higher degree of scrutiny on consistency and correct data modeling as we approach a stable release (#161, #4374). We anticipate limited churn going forward. Additionally, once we do have a stable release, users can rely on the strong compatibility guarantees we'll conform to in versions 1.0.0+.

Schema

• BREAKING: Refactor otlp exporter to separate otlp_http and otlp_grpc exporters, add _file suffix to OTLP exporter certificate properties (#146, #166)

  Migration steps

  # Before
  tracer_provider:
    processors:
      - batch:
          exporter:
            otlp: 
              protocol: http/protobuf
              endpoint: http://localhost:4318/v1/traces
              certificate: /app/cert.pem
  ---
  # After
  tracer_provider:
    processors:
      - batch:
          exporter:
            otlp_http: 
              endpoint: http://localhost:4318/v1/traces
              certificate_file: /app/cert.pem

• BREAKING: Refactor propagator schema, add composite_list for compatibility with OTEL_PROPAGATORS. (#187)

  Migration steps

  # Before
  propagator:
    composite:
      - tracecontext
      - baggage
  ---
  # After
  propagator:
    composite:
      - tracecontext:
      - baggage:

• BREAKING: Refactor resource detection and mark experimental (#182, #188)

  Migration steps

  # Before
  resource:
    attributes: # ...omitted for brevity
    detectors:
      excluded:
        - process.command_args
  ---
  # After
  resource:
    attributes: # ...omitted for brevity
    detection/development:
      detectors:
        - container:
        - host:
        - os:
        - process:
      attributes:
        excluded:
          - process.command_args

• BREAKING: Mark prometheus exporter as experimental (#180)

  Migration steps

  # Before
  meter_provider:
    readers:
      - pull:
          prometheus: # ...omitted for brevity
  ---
  # After
  meter_provider:
    readers:
      - pull:
          prometheus/development: # ...omitted for brevity

• BREAKING: Mark .instrumentation as experimental (#179)

  Migration steps

  # Before
  instrumentation: # ...omitted for brevity
  ---
  # After
  instrumentation/development: # ...omitted for brevity

• BREAKING: Move metric producers from MetricReader to PullMetricReader, PeriodicMetricReader (#148)

  Migration steps

  # Before
  meter_provider:
    readers:
      - periodic: # ...omitted for brevity
        producers:
          - opencensus:
  ---
  # After
  meter_provider:
    readers:
      - periodic: # ...omitted for brevity
          producers:
            - opencensus:

• BREAKING: Change various usages of minimum to exclusiveMinimum (#151)

• Add .meter_provider.exemplar_filter property (#131)

• Don't require empty objects (#134)

• Improve .file_format documentation (#137)

• Fix periodic exporter interval default value in kitchen-sink.yaml (#143)

• Provide guidance on required and null properties. Update schema types to reflect guidance, including documenting behavior when properties are omitted or null. (#141, #192)

• Add guidance around use of polymorphic types (#147)

• Fix MetricProducer type descriptions (#150)

• Add otlp_file/development exporter (#154, #181)

• Object and enum types should be defined in $defs (#155)

• Add guidance around use of title and description keywords (#157)

• Add log_level configuration (#121)

• Add missing gauge value to InstrumentType enum (#186)

• Add cardinality limits configuration to PullMetricReader, PeriodicMetricReader (#185)

• Add scope configuration to disable loggers, tracers, meters (#140, #191)

Tooling

• chore: add govulncheck check for validator (#126)
• Drop anchors.yaml example (#130)
• Rebrand file configuration to declarative configuration (#135)
• Rework release process (#149, #167)
• Clarify JSON schema draft 2020-12 (#156)
• Move modeling rules to CONTRIBUTING.md (#170)
• Add FOSSA scanning workflow (#171)
• Add a variety of key definitions surrounding stability (#142)