Skip to main content

Lumigo Tracer for Python v3.6 / v3.7 runtimes

Project description

CircleCI Version codecov

How To Use

  • install with pip install lumigo_tracer
    or with Lambda layer with ARN from this table
  • import using from lumigo_tracer import lumigo_tracer
  • wrap you lambda function using @lumigo_tracer or @lumigo_tracer(token='XXX'). As an example, your lambda should look like:
@lumigo_tracer(token='XXX')
def my_lambda(event, context):
    print('I can finally trubleshoot!')

Configuration

Enhanced print

In case you are using print() or python logging to log, then you can use the enhanced print capabilities that the tracer provides in order to view your logs in the platform view. Just add enhance_print=True to the tracer configuration and you are set.

@lumigo_tracer(token='XXX', enhance_print=True)
def my_lambda(event, context):
    print('I can view this line now')

Step Functions

If this function is part of a step function, you can add the flag step_function=True, and we will track the states in the step function as a single transaction.

@lumigo_tracer(token='XXX', step_function=True)
def my_lambda(event, context):
    print('Step function visibility!')

Note: we will add the key "_lumigo" to the return value of the function.

If you override the "Parameters" configuration, simply add "_lumigo.$": "$._lumigo".
For example:

"States": {
    "state1": {
      "Type": "Task",
      "Resource": "arn:aws:lambda:us-west-2:ACCOUNT:function:FUNCTION_NAME",
      "Parameters": {
          "Changed": "parameters",
          "_lumigo.$": "$._lumigo"
        },
      "Next": "state2"
    },
    "state2": {
      "Type": "pass",
      "End": true
    }
}

Frameworks

Chalice

  • In chalice, you should add the following lines to the your file:
from lumigo_tracer import LumigoChalice
...
app = Chalice(app_name='chalice')
app = LumigoChalice(app, token="XXX")
  • you can find more examples in the examples directory
  • In case of need, there is a kill switch, that stops all the interventions of lumigo immediately, without changing the code. Simply add an environment variable LUMIGO_SWITCH_OFF=true.
  • You can turn on the debug logs by setting the environment variable LUMIGO_DEBUG=true
  • You can change the timeout to send the trace information to the edge by setting LUMIGO_EDGE_TIMEOUT=<seconds>

Sentry/Raven Lambda Integration

Add our decorator beneath the Raven decorator

from lumigo_tracer import lumigo_tracer
...
@RavenLambdaWrapper()
@lumigo_tracer(token='XXX')
def lambda_handler (event, context):  return  {
 'statusCode' :  200,
 'body' : json.dumps( 'Hi!' ) }

How To Contribute

Prepare your machine

  • Create a virtualenv virtualenv venv -p python3
  • Activate the virtualenv by running . venv/bin/activate
  • Run pip install -r requirements.txt to install dependencies.
  • cd src and python setup.py develop.
  • If you use pycharm, make sure to change its virtualenv through the PyCharm -> Preferences -> Project -> Interpreter under the menu
  • Run pre-commit install in your repository to install pre-commits hooks.

Test

  • To run the unit tests, run py.test in the root folder.
  • To deploy the services for the component tests, move to the root test directory and run sls deploy. This can be performed only once if the resources doesn't change.
  • To run the component tests, run py.test --all.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

lumigo_tracer-1.1.46-py3-none-any.whl (37.5 kB view hashes)

Uploaded Python 3

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