Registry / observability / elastic-opentelemetry

elastic-opentelemetry

library1.13.0pypypiunverified

The Elastic Distribution of OpenTelemetry Python (EDOT Python) provides a pre-configured OpenTelemetry Python SDK and auto-instrumentation packages that are compatible with the Elastic Observability solution. It simplifies the process of instrumenting Python applications and sending telemetry data to Elastic. Currently at v1.12.0, active development with frequent minor releases.

observability

pip install elastic-opentelemetry

github ↗package ↗

INSTALL

IMPORT

SIG · ELASTIC-OPENTELEME

elastic-opentelemetry

observabilitypythonv1.13.0

Install

5.8s avg

Import

—

Disk

53MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.13.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 55.1MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 5.8s · import 0.000s · 53MB

53MB installed

● package 53MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ElasticOpenTelemetryConfigurator

✓ from elasticotel import ElasticOpenTelemetryConfigurator

✗ from elastic_opentelemetry import ElasticOpenTelemetryConfigurator

Initialize the Elastic OpenTelemetry distribution with environment variables for service name, endpoint, and API key.

import os os.environ['ELASTIC_OTEL_SERVICE_NAME'] = 'my-app' os.environ['ELASTIC_OTEL_ENDPOINT'] = 'https://my-elastic-cluster:443' os.environ['ELASTIC_OTEL_API_KEY'] = 'YOUR_API_KEY' from elastic_opentelemetry import ElasticOpenTelemetry # Initialize the Elastic OpenTelemetry configuration ElasticOpenTelemetry().setup()

opentelemetry --version

Debug

Known issues

breakingStarting from v1.5.0, the default sampler changed from `always_on` to `parentbased_traceidratio`. This may result in sampling decisions that drop some traces by default. To restore previous behavior, set `OTEL_TRACES_SAMPLER=always_on` explicitly.

fix

Set environment variable OTEL_TRACES_SAMPLER=always_on if you need to trace all requests.

affects: >=1.5.0

gotchaThe package `elastic-opentelemetry` is the distribution package; do not confuse it with `opentelemetry-distro` or `opentelemetry-sdk`. Installing `elastic-opentelemetry` automatically pulls in the correct OpenTelemetry SDK and instrumentation packages.

fix

Install only `elastic-opentelemetry` for Elastic-optimized configuration.

affects: all

gotchaEnvironment variables like `ELASTIC_OTEL_API_KEY` must be set before calling `ElasticOpenTelemetry().setup()`. Changing them afterward has no effect unless you reinitialize.

fix

Set all environment variables before any telemetry setup code runs.

affects: all

Upgrade

Version history

1.13.0latest on PyPI · released May 22, 2026

Audit

Dependencies

opentelemetry-sdkrequiredCore OpenTelemetry SDK dependency

opentelemetry-apirequiredRequired for telemetry API

Agent activity

16 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/elastic/elastic-otel-python ↗

packagehttps://pypi.org/project/elastic-opentelemetry/ ↗