From 393591962c99407ad3720b9f8b1b99f179200e5d Mon Sep 17 00:00:00 2001 From: Reiley Yang Date: Tue, 19 Oct 2021 09:33:56 -0700 Subject: [PATCH 1/5] add environment variables for Periodic exporting MetricReader --- specification/sdk-environment-variables.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/specification/sdk-environment-variables.md b/specification/sdk-environment-variables.md index 2e360272810..499487a040c 100644 --- a/specification/sdk-environment-variables.md +++ b/specification/sdk-environment-variables.md @@ -192,6 +192,13 @@ Known values for `OTEL_METRICS_EXEMPLAR_FILTER` are: - `"all"`: All measurements are eligible for exemplar sampling. - `"with_sampled_trace"`: Only allow measurements with a sampled parent span in context. +### Periodic exporting MetricReader + +| Name | Description | Default | Notes | +| --------------------------- | -------------------------------------------------------------------- | ---------------------- | ----- | +| `OTEL_PEMR_EXPORT_INTERVAL` | The time interval (in milliseconds) between two consecutive exports. | 60000 | | +| `OTEL_PEMR_EXPORT_TIMEOUT` | Maximum allowed time (in milliseconds) to export data. | 30000 | | + ## Language Specific Environment Variables To ensure consistent naming across projects, this specification recommends that language specific environment variables are formed using the following convention: From ada0aea34305c37f0d8df3502d0020857002f6ee Mon Sep 17 00:00:00 2001 From: Reiley Yang Date: Tue, 19 Oct 2021 13:32:53 -0700 Subject: [PATCH 2/5] adjust format --- specification/sdk-environment-variables.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/specification/sdk-environment-variables.md b/specification/sdk-environment-variables.md index 499487a040c..fa9d5bd99ae 100644 --- a/specification/sdk-environment-variables.md +++ b/specification/sdk-environment-variables.md @@ -194,10 +194,10 @@ Known values for `OTEL_METRICS_EXEMPLAR_FILTER` are: ### Periodic exporting MetricReader -| Name | Description | Default | Notes | -| --------------------------- | -------------------------------------------------------------------- | ---------------------- | ----- | -| `OTEL_PEMR_EXPORT_INTERVAL` | The time interval (in milliseconds) between two consecutive exports. | 60000 | | -| `OTEL_PEMR_EXPORT_TIMEOUT` | Maximum allowed time (in milliseconds) to export data. | 30000 | | +| Name | Description | Default | Notes | +| --------------------------- | -------------------------------------------------------------------- | ------- | ----- | +| `OTEL_PEMR_EXPORT_INTERVAL` | The time interval (in milliseconds) between two consecutive exports. | 60000 | | +| `OTEL_PEMR_EXPORT_TIMEOUT` | Maximum allowed time (in milliseconds) to export data. | 30000 | | ## Language Specific Environment Variables From 40682cbc50a46314e7728292e842d1891a1c5dae Mon Sep 17 00:00:00 2001 From: Reiley Yang Date: Tue, 19 Oct 2021 13:36:49 -0700 Subject: [PATCH 3/5] update changelog --- CHANGELOG.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1e0720246bc..583f4a847f3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -19,6 +19,8 @@ release. ([#1935](https://github.com/open-telemetry/opentelemetry-specification/pull/1935)) - Add clarifications on how to handle numerical limits. ([#2007](https://github.com/open-telemetry/opentelemetry-specification/pull/2007)) +- Add environment variables for Periodic exporting MetricReader. + ([#2038](https://github.com/open-telemetry/opentelemetry-specification/pull/2038)) ### Logs From 6cc052195f0a37647f280cc20c01c08df34b3476 Mon Sep 17 00:00:00 2001 From: Reiley Yang Date: Thu, 21 Oct 2021 18:32:41 -0700 Subject: [PATCH 4/5] use user friendly name based on SIG discussion --- specification/sdk-environment-variables.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/specification/sdk-environment-variables.md b/specification/sdk-environment-variables.md index fa9d5bd99ae..2953f593edf 100644 --- a/specification/sdk-environment-variables.md +++ b/specification/sdk-environment-variables.md @@ -194,10 +194,10 @@ Known values for `OTEL_METRICS_EXEMPLAR_FILTER` are: ### Periodic exporting MetricReader -| Name | Description | Default | Notes | -| --------------------------- | -------------------------------------------------------------------- | ------- | ----- | -| `OTEL_PEMR_EXPORT_INTERVAL` | The time interval (in milliseconds) between two consecutive exports. | 60000 | | -| `OTEL_PEMR_EXPORT_TIMEOUT` | Maximum allowed time (in milliseconds) to export data. | 30000 | | +| Name | Description | Default | Notes | +| ----------------------------- | -------------------------------------------------------------------- | ------- | ----- | +| `OTEL_METRIC_EXPORT_INTERVAL` | The time interval (in milliseconds) between two consecutive exports. | 60000 | | +| `OTEL_METRIC_EXPORT_TIMEOUT` | Maximum allowed time (in milliseconds) to export data. | 30000 | | ## Language Specific Environment Variables From f96ada103ef3bb3be98af9e99a424e7b4da5a8d5 Mon Sep 17 00:00:00 2001 From: Reiley Yang Date: Sun, 24 Oct 2021 16:13:49 -0700 Subject: [PATCH 5/5] update wording --- specification/sdk-environment-variables.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/specification/sdk-environment-variables.md b/specification/sdk-environment-variables.md index 2953f593edf..2e1a9bfe57f 100644 --- a/specification/sdk-environment-variables.md +++ b/specification/sdk-environment-variables.md @@ -194,10 +194,10 @@ Known values for `OTEL_METRICS_EXEMPLAR_FILTER` are: ### Periodic exporting MetricReader -| Name | Description | Default | Notes | -| ----------------------------- | -------------------------------------------------------------------- | ------- | ----- | -| `OTEL_METRIC_EXPORT_INTERVAL` | The time interval (in milliseconds) between two consecutive exports. | 60000 | | -| `OTEL_METRIC_EXPORT_TIMEOUT` | Maximum allowed time (in milliseconds) to export data. | 30000 | | +| Name | Description | Default | Notes | +| ----------------------------- | ----------------------------------------------------------------------------- | ------- | ----- | +| `OTEL_METRIC_EXPORT_INTERVAL` | The time interval (in milliseconds) between the start of two export attempts. | 60000 | | +| `OTEL_METRIC_EXPORT_TIMEOUT` | Maximum allowed time (in milliseconds) to export data. | 30000 | | ## Language Specific Environment Variables