Skip to main content

The Splunk distribution of OpenTelemetry Python Instrumentation provides a Python agent that automatically instruments your Python application to capture and report distributed traces to SignalFx APM.

Project description

Get Started   •   Get Involved   •   Migrating from SignalFx Python Tracing

OpenTelemetry Python Version GitHub release (latest SemVer) PyPI - Python Version Splunk GDI specification Codecov Build Status

Examples   •   Security   •   Supported Libraries   •   Troubleshooting

Splunk Distribution of OpenTelemetry Python

The Splunk distribution of OpenTelemetry Python provides multiple installable packages that automatically instrument your Python application to capture and report distributed traces to Splunk APM. Instrumentation works by patching supported libraries at runtime with an OpenTelemetry-compatible tracer to capture and export trace spans.

This distribution comes with the following defaults:

If you're currently using the SignalFx Tracing Library for Python and want to migrate to the Splunk Distribution of OpenTelemetry Python, see Migrate from the SignalFx Tracing Library for Python.


This Splunk Distribution of OpenTelemetry requires Python 3.7 or later.

Get started

To get started, install the splunk-opentelemetry[all] package, run the bootstrap script and wrap your run command with splunk-py-trace.

For example, if the runtime parameters were:

python --port=8000

Then the runtime parameters should be updated to:

$ pip install splunk-opentelemetry[all]
$ splunk-py-trace-bootstrap
$ OTEL_SERVICE_NAME=my-python-app \
    splunk-py-trace python --port=8000

To see the Python instrumentation in action with sample applications, see our examples.

Basic configuration

The service name resource attribute is the only configuration option that needs to be specified. You can set it by adding a attribute as shown in the example above.

A few other configuration options that may need to be changed or set are:

  • Trace propagation format if not sending to other applications using W3C trace-context. For example, if other applications are instrumented with signalfx-*-tracing instrumentation. See the trace propagation configuration documentation for more information.
  • Endpoint if not sending to a locally running Splunk OpenTelemetry Connector with default configuration. For example, if the SignalFx Smart Agent is used. See the exporters configuration documentation for more information.
  • Environment resource attribute deployment.environment to specify what environment the span originated from. For example:
  • Service version resource attribute service.version to specify the version of your instrumented application. For example:

The deployment.environment and service.version resource attributes are not strictly required, but recommended to be set if they are available.

The OTEL_RESOURCE_ATTRIBUTES syntax is described in detail in the trace configuration section.

Supported Python Versions

The instrumentation works with Python verion 3.7 or higher. Supported libraries are listed here.

Advanced Configuration

For the majority of users, the Getting Started section is all you need. Advanced configuration documentation can be found here. In addition, special cases for instrumentation are documented here.

Manually instrument an application

Documentation on how to manually instrument a Python application is available here.

To extend the instrumentation with the OpenTelemetry Instrumentation for Python, you have to use a compatible API version.

The Splunk Distribution of OpenTelemetry Python version 1.11.0 is compatible with:

  • OpenTelemetry API version 1.18.0
  • OpenTelemetry SDK version 1.18.0
  • OpenTelemetry Instrumentation for Python version 0.39b0

Correlating traces with logs

The Splunk Distribution of OpenTelemetry Python provides a way to correlate traces with logs. See Connect Python trace data with logs.


The Splunk distribution of OpenTelemetry Python Instrumentation is a distribution of OpenTelemetry Python. It is licensed under the terms of the Apache Software License version 2.0. See the license file for more details.

ℹ️  SignalFx was acquired by Splunk in October 2019. See Splunk SignalFx for more information.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

splunk-opentelemetry-1.11.0.tar.gz (18.9 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page