lumigo-tracer 1.1.7

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

How To Use

• install with pip install lumigo_tracer
  or with Lambda layer with ARN `arn:aws:lambda:YOUR-REGION:724777057400:layer:lumigo-python-tracer:41
• 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.