Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update file-based configuration to allow for multiple inputs #4151

Closed
wants to merge 1 commit into from
Closed

update file-based configuration to allow for multiple inputs #4151

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 7 additions & 5 deletions specification/configuration/file-configuration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -278,12 +278,14 @@ with OpAmp

#### Parse

Parse and validate a [configuration file](#configuration-file).
Parse and validate one or more [configuration file](#configuration-file)s.

**Parameters:**

* `file`: The [configuration file](#configuration-file) to parse. This MAY be a
* `file`: The [configuration file](#configuration-file)(s) to parse. This MAY be a
file path, or language specific file data structure, or a stream of a file's content.
If multiple configuration files are provided, implementations SHOULD merge them into
one YAML document prior to parsing and validation.
* `file_format`: The file format of the `file` (e.g. [yaml](#yaml-file-format)).
Implementations MAY accept a `file_format` parameter, or infer it from
the `file` extension, or include file format specific overloads of `parse`,
Expand Down Expand Up @@ -429,13 +431,13 @@ ContextPropagators propagators = openTelemetry.getPropagators();
If an SDK
supports [OTEL_EXPERIMENTAL_CONFIG_FILE](./sdk-environment-variables.md#file-configuration),
then setting `OTEL_EXPERIMENTAL_CONFIG_FILE` provides a simple way to obtain an
SDK initialized from the specified config file. The pattern for accessing the
SDK initialized from the specified config file(s). The pattern for accessing the
configured SDK components and installing into instrumentation will vary by
language. For example, the usage in Java might resemble:

```shell
# Set the required env var to the location of the configuration file
export OTEL_EXPERIMENTAL_CONFIG_FILE="/app/sdk-config.yaml"
# Set the required env var to the location of the configuration files
export OTEL_EXPERIMENTAL_CONFIG_FILE="/app/sdk-config.yaml,/app/sdk-config.extra.yaml"
```

```java
Expand Down
Loading