open-telemetry / open-telemetry/opentelemetry-ruby

OTEL_EXPORTER_OTLP_TIMEOUT is in seconds instead of milliseconds, not following semantic conventions

Open
#1,838 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

keep
Dominant language
Ruby
Stars
606
Forks
301
Avg merge
3d 19h
Merged PRs (30d)
42

Description

It seems that the OTEL_EXPORTER_OTLP_TIMEOUT environment variable in the OpenTelemetry Ruby SDK is interpreted in seconds, rather than milliseconds as specified in the official semantic conventions.

This inconsistency can create problems in polyglot environments, where the same environment variable is injected across services written in different languages.

For example, setting OTEL_EXPORTER_OTLP_TIMEOUT=10000 (expecting 10 seconds) would result in a very large timeout in Ruby (10,000 seconds) but the correct timeout in other languages.

I understand that changing this behavior would be a breaking change, but I wanted to check if there are any plans to bring this in line with the semantic convention in the near future. Even an opt-in behavior or deprecation warning could help reduce confusion.

Let me know your thoughts — just trying to align things on our end and avoid unexpected issues.

Thanks in advance !

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by tracing how the OpenTelemetry Ruby SDK handles OTEL_EXPORTER_OTLP_TIMEOUT and compare its unit with the linked semantic convention. Determine the appropriate compatibility or migration behavior, then verify that a value such as 10000 is handled consistently with the documented milliseconds convention.

Written by the indexing model from the issue text.

Assessment

Tech stack
ruby
Domain
observability
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.