Lightstep will be EOLing ls-trace tracers in the near future.

• All new users are recommended to use OpenTelemetry, specifically the OpenTelemetry launcher for python (Quickstart docs, github)
• For those currently using these tracers, we will be reaching out in Q3 2021 to ensure you have a smooth transition to OpenTelemetry. If for any reason you find a gap with OpenTelemetry for your use case, please reach out to your Customer Success representative to discuss and set up time with our Data Onboarding team.

Datadog has generously announced the donation of their tracer libraries to the OpenTelemetry project. Auto-instrumentation is a core feature of these libraries, making it possible to create and collect telemetry data without needing to change your code. LightStep wants you to be able to use these libraries now! We've forked the Datadog libraries into the LightStep repo as agents. You can install and use these agents to take advantage of auto-instrumentation without waiting for OpenTelemetry. Each LightStep agent is "pinned" to a Datadog release and is fully supported by LightStep’s Customer Success team.

Simply install the agent, configure it to communicate with LightStep Satellites, run your app, and then any frameworks, data stores, and libraries included in your app will send data to LightStep as distributed traces.

• Python: 2.7, 3.4, 3.5, 3.6, 3.7

pip install ls-trace

The following app.py makes a web request:

#!/usr/bin/env python3
import requests

def get_url(url):
    response = requests.get(url)
    print(response)

if __name__ == "__main__":
    get_url("https://en.wikipedia.org/wiki/Duck")

Now let's run the application using ls-trace-run

# export configuration options
export DD_TRACE_AGENT_URL=https://collector.lightstep.com:443
# replace <service_name> with your service's name
# replace <access_token> with your LightStep access token
export DD_TRACE_GLOBAL_TAGS="lightstep.service_name:<service_name>,lightstep.access_token:<access_token>"

# run the application
chmod +x ./app.py
ls-trace-run ./app.py

A trace from the application should be available in your LightStep dashboard

Check out https://docs.lightstep.com/docs/python-auto-instrumentation for more information

ls-trace follows its own versioning scheme. The table below shows the corresponding dd-trace-py versions.

Contact [email protected] for additional questions and resources, or to be added to our community slack channel.

This is a fork of dd-trace-py and retains the original Datadog license and copyright. See the license for more details.