From 3fce9384c33d1e341d5bebd311004c59f3a29a42 Mon Sep 17 00:00:00 2001 From: Matthew Wear Date: Wed, 5 Aug 2020 09:30:02 -0700 Subject: [PATCH] add initial env var draft specification (#666) --- specification/sdk-environment-variables.md | 58 ++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 specification/sdk-environment-variables.md diff --git a/specification/sdk-environment-variables.md b/specification/sdk-environment-variables.md new file mode 100644 index 00000000000..60a5bf52c65 --- /dev/null +++ b/specification/sdk-environment-variables.md @@ -0,0 +1,58 @@ +# OpenTelemetry Environment Variable Specification + +The goal of this specification is to unify the environment variable names between different OpenTelemetry SDK implementations. SDKs MAY choose to allow configuration via the environment variables in this specification, but are not required to. If they do, they SHOULD use the names listed in this document. + +## General SDK Configuration + +| Name | Description | Default | Notes | +| -------------------- | ------------------------------------------------ | --------------------------------- | ------------------------------------------------------------------------------------------- | +| OTEL_RESOURCE_LABELS | Key-value pairs to be used as resource labels | | Spec details TBD. Proposal in [OTEP-111](https://github.com/open-telemetry/oteps/pull/111). | +| OTEL_LOG_LEVEL | Log level used by the SDK logger | "info" | | +| OTEL_PROPAGATORS | Propagators to be used as a comma separated list | "tracecontext,correlationcontext" | | + +## Batch Span Processor + +| Name | Description | Default | Notes | +| ------------------------------ | ---------------------------------------------- | ------- | ----------------------------------------------------- | +| OTEL_BSP_SCHEDULE_DELAY_MILLIS | Delay interval between two consecutive exports | 5000 | | +| OTEL_BSP_EXPORT_TIMEOUT_MILLIS | Maximum allowed time to export data | 30000 | | +| OTEL_BSP_MAX_QUEUE_SIZE | Maximum queue size | 2048 | | +| OTEL_BSP_MAX_EXPORT_BATCH_SIZE | Maximum batch size | 512 | Must be less than or equal to OTEL_BSP_MAX_QUEUE_SIZE | + +## OTLP Span Exporter + +| Name | Description | Default | +| -------------------------------- | ------------------------------------------ | ------- | +| OTEL_EXPORTER_OTLP_SPAN_TIMEOUT | Max waiting time to export each span batch | - | +| OTEL_EXPORTER_OTLP_SPAN_ENDPOINT | Ingest endpoint for OTLP spans | - | + +## OTLP Metric Exporter + +| Name | Description | Default | +| ---------------------------------- | -------------------------------------------- | ------- | +| OTEL_EXPORTER_OTLP_METRIC_TIMEOUT | Max waiting time to export each metric batch | - | +| OTEL_EXPORTER_OTLP_METRIC_ENDPOINT | Ingest endpoint for OTLP metrics | - | + +## Jaeger Exporter + +| Name | Description | Default | +| ------------------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------ | +| OTEL_EXPORTER_JAEGER_AGENT_HOST | Hostname for the Jaeger agent | "localhost" | +| OTEL_EXPORTER_JAEGER_AGENT_PORT | Port for the Jaeger agent | 6832 | +| OTEL_EXPORTER_JAEGER_ENDPOINT | HTTP endpoint for Jaeger traces | "http://localhost:14250" | +| OTEL_EXPORTER_JAEGER_USER | Username to be used for HTTP basic authentication | - | +| OTEL_EXPORTER_JAEGER_PASSWORD | Password to be used for HTTP basic authentication | - | + +## Zipkin Exporter + +| Name | Description | Default | +| ----------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------ | +| OTEL_EXPORTER_ZIPKIN_ENDPOINT | Endpoint for Zipkin traces | "http://localhost:9411/api/v2/spans" | + +## Language Specific Environment Variables + +To ensure consistent naming across projects, this specification recommends that language specific environment variables are formed using the following convention: + +``` +OTEL_{LANGUAGE}_{FEATURE} +```