v1.0.0-rc.1

Schema

• Standardize container, host, process, and service resource detectors (#199)

Tooling

• Add mark down link checking build step (#196, #198)
• Add ossf-scorecard scanning workflow (#194)
• Update validator-release.yml to use ubuntu-latest (#200)
• Add Renovate configuration (#202)
• [StepSecurity] ci: Harden GitHub Actions (#206)

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)

v0.3.0

What's Changed

• Add metric producers to meter_provider configuration by @dashpole in #90
• Document what configuration options are covered in the schema by @jack-berg in #92
• Remove unnecessary MetricProducer in pull metric reader by @dashpole in #93
• Add modeling rule for property name case by @jack-berg in #96
• adding instrumentation configuration by @brettmc in #91
• Add sdk-config.yaml starter template w/ references to env vars by @jack-berg in #76
• [SCHEMA] The MetricExporter schema is unsafe by @marcalff in #110
• Define modeling guidance for mismatches with standard env vars, add resource.attribute_list by @jack-berg in #106
• fix: update attribute_keys to include type by @codeboten in #111
• add tool for config file validation and envvar replacement by @tsloughter in #94
• add headers_list support, similar to attributes_list by @codeboten in #122
• Prefer arrays of name value pairs over objects by @jack-berg in #115
• stream: update stream configuration to include/exclude by @codeboten in #118
• Project tooling to generate example property descriptions by @jack-berg in #104

Repository maintenance

• [chore] update changelog to include link for 0.2.0 by @codeboten in #95
• Fix build by @jack-berg in #116
• add codeql workflow by @codeboten in #123
• Update CODEOWNERS to include configuration-approvers by @jack-berg in #124
• Add brettmc to approvers by @jack-berg in #113
• Add marcalff to approvers by @jack-berg in #114

New Contributors

• @dashpole made their first contribution in #90
• @brettmc made their first contribution in #91
• @marcalff made their first contribution in #110
• @tsloughter made their first contribution in #94

Full Changelog: v0.2.0...v0.3.0

v0.2.0

What's Changed

• Post release v0.1.0 by @jack-berg in #48
• Document time value units in kitchen-sink example by @jaydeluca in #51
• add resource schema_url by @codeboten in #50
• add prometheus without units & type suffix options by @codeboten in #61
• add without_scope_info to prometheus exporter by @codeboten in #63
• add insecure field by @codeboten in #30
• add comments for each prom exporter config option by @codeboten in #66
• remove specification for service.name by @codeboten in #68
• add console definition for log record exporter by @codeboten in #84
• Define resource.detectors.attributes.included/excluded by @jack-berg in #64
• [exporter/prometheus] add with_resource_constant_labels by @codeboten in #67
• Add schema modeling guidance to use wildcard syntax instead of regex by @jack-berg in #71

New Contributors

• @jaydeluca made their first contribution in #51

Full Changelog: v0.1.0...v0.2.0

v0.1.0

Initial configuration schema release, including:

• Resource
• Attribute limits
• Enabled
• Propagators
• Tracer provider
  • Span processors (and exporters)
  • Span limits
  • Sampler
• Meter provider
  • Metric readers (and exporters)
  • Views
• Logger provider
  • Log record processors (and exporters)
  • Log limits