Registry / observability / lumigo-tracer

lumigo-tracer

library1.1.257pypypi✓ verified 85d ago

A Python tracing library for serverless and distributed applications, providing automatic instrumentation for AWS Lambda and other runtimes. Version 1.1.257, updated frequently. It wraps AWS SDK calls, HTTP requests, and other libraries to send telemetry to the Lumigo observability platform.

observability aws http-networking

pip install lumigo-tracer

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · LUMIGO-TRACER

lumigo-tracer

observabilitypythonv1.1.257

Install

1.7s avg

Import

228ms

Disk

17MB

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.1.257 · 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.240s · 18.8MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.7s · import 0.216s · 19MB

17MB installed

● package 17MB

Code

Verified usage

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

lumigo_tracer

✓ from lumigo_tracer import lumigo_tracer

✗ from lumigo import lumigo_tracer

Package name is lumigo_tracer, not lumigo

Decorate your Lambda handler with @lumigo_tracer and set the LUMIGO_TOKEN environment variable.

import os from lumigo_tracer import lumigo_tracer @lumigo_tracer(token=os.environ.get('LUMIGO_TOKEN', '')) def lambda_handler(event, context): return {'statusCode': 200, 'body': 'Hello from Lumigo!'}

Debug

Known issues

breakingThe import from `lumigo` (without `_tracer`) is deprecated and will be removed. Use `from lumigo_tracer import lumigo_tracer`.

fix

Change import statement to `from lumigo_tracer import lumigo_tracer`.

affects: >=1.0.0

deprecatedThe `lumigo_tracer` decorator no longer supports `timeout_seconds` parameter. It now infers timeout from Lambda configuration.

fix

Remove `timeout_seconds` argument from the decorator.

affects: >=1.1.0

gotchaIf you don't set `LUMIGO_TOKEN` environment variable, tracing will silently fail. The token must be present at startup.

fix

Set the `LUMIGO_TOKEN` environment variable with your Lumigo token.

affects: All

gotchaThe tracer wraps many common libraries (requests, boto3, pymongo, etc.) automatically. If you use an unsupported library, you must manually create spans.

fix

Check the Lumigo docs for supported libraries; use `lumigo_tracer.add_execution_tag()` for manual instrumentation.

affects: All

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'lumigo_tracer'

Library not installed or environment missing it.

fix

Install with `pip install lumigo-tracer` and ensure the Lambda layer includes it.

AttributeError: module 'lumigo_tracer' has no attribute 'lumigo_tracer'

Incorrect import path: probably used `from lumigo_tracer import lumigo_tracer` but the package is installed as `lumigo-tracer` vs `lumigo_tracer`? Or installed wrong package.

fix

Use `from lumigo_tracer import lumigo_tracer` and ensure the correct package is installed.

TypeError: lumigo_tracer() got an unexpected keyword argument 'timeout_seconds'

Using old API where timeout_seconds was allowed; removed in newer versions.

fix

Remove `timeout_seconds` argument; the tracer now uses Lambda's configured timeout.

Upgrade

Version history

1.1.257latest on PyPI · released Jun 26, 2025

Audit

Dependencies

boto3optionalAWS Lambda environment usually includes boto3; needed for certain instrumentations

Agent activity

24 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/lumigo-io/python_tracer.git ↗

packagehttps://pypi.org/project/lumigo-tracer/ ↗

homepagehttps://lumigo.io ↗