README.md

SDK File Configuration

This package implements OpenTelemetry file-based configuration.

Files

• schema.json — vendored copy of the OpenTelemetry configuration JSON schema
• models.py — Python dataclasses generated from schema.json by datamodel-code-generator, using a custom template from opentelemetry-sdk/codegen/ (see that directory's README for details)

Updating the schema

1. Download the new schema from the opentelemetry-configuration releases:

   curl -o opentelemetry-sdk/src/opentelemetry/sdk/_configuration/schema.json \
     https://raw.githubusercontent.com/open-telemetry/opentelemetry-configuration/refs/tags/vX.Y.Z/opentelemetry_configuration.json

2. Regenerate models.py:

   tox -e generate-config-from-jsonschema

3. Update any version string references in tests and source:

   grep -r "OLD_VERSION" opentelemetry-sdk/