---
id: lumigo-tracer
version: "1.1.257"
license: Apache License 2.0
license_treatment: permissive
maintenance: active
---

# lumigo-tracer — Lumigo Tracer for Python v3.6 / 3.7 / 3.8 / 3.9 / 3.10 runtimes

License: permissive · Maintenance: active · Downloads: 104.1K/mo

## What it is and what it does

Lumigo-tracer is a Python agent that wraps AWS Lambda functions to automatically capture execution traces, HTTP requests, errors, and performance metrics, then sends them to Lumigo's observability platform. It supports three deployment modes: as a Lambda Layer (zero-code instrumentation), via the Serverless Framework plugin, or through manual decorator-based wrapping of your handler function.

The tracer collects distributed trace context, supports W3C TraceContext headers for cross-service tracing, and includes features like Step Functions tracking, secret masking via regex patterns, and domain scrubbing to prevent sensitive data leakage. Configuration is primarily environment-variable driven, making it suitable for infrastructure-as-code deployments. It depends on lumigo-core for its core functionality.

Use it for:

- Instrument Lambda functions to trace HTTP calls and database queries across a microservices architecture without modifying application code.
- Debug production Lambda failures by capturing full request/response payloads, errors, and execution context in a centralized platform.
- Track Step Functions workflows as single transactions to visualize state transitions and identify bottlenecks across multi-step processes.
- Mask sensitive data (passwords, API keys, credentials) in traces using configurable regex patterns to meet compliance requirements.
- Monitor performance metrics and latency across Lambda invocations to identify cold starts and optimization opportunities.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Lumigo-tracer instruments Python Lambda functions to automatically collect distributed traces, metrics, and performance data, sending them to the Lumigo platform for observability and debugging.

Yes, if you run Python Lambda functions on AWS and need observability. The tracer is actively maintained, has low install friction, carries a permissive license, and integrates cleanly via decorator or Lambda Layer. Requires a Lumigo account and API token; evaluate whether the platform's pricing and feature set align with your observability needs before committing.

## Install

pip install lumigo-tracer
uv add lumigo-tracer
poetry add lumigo-tracer

## Installing lumigo-tracer

Before you install: Low install friction with a single runtime dependency (lumigo-core). Actively maintained with recent commits and releases; last release was 2025-06-26 and the repository shows ongoing activity.

License in practice: Licensed under Apache License 2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions—suitable for most commercial and open-source projects.

Quickstart:

pip install lumigo_tracer

from lumigo_tracer import lumigo_tracer

@lumigo_tracer(token='YOUR-TOKEN-HERE')
def my_lambda(event, context):
    return 'traced'

Requires a Lumigo API token to send traces to the Lumigo platform; without it, the tracer will not transmit data.

Verify before relying:

- Whether lumigo-core has its own dependencies that could add install friction beyond what the wheel distribution suggests.
- Performance overhead of the tracer on cold-start and warm-start Lambda execution times.
- Compatibility with Python 3.6 and 3.7 support claims given those versions reached end-of-life.

## Package facts

- License: Apache License 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 104.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

lambda function tracing, distributed tracing python, aws lambda monitoring, performance observability, serverless debugging, lambda instrumentation, application performance monitoring, aws-lambda, distributed-tracing, observability

[View on SkillFed](https://skillfed.io/packages/lumigo-tracer) · [View on PyPI](https://pypi.org/project/lumigo-tracer/)