Metadata-Version: 2.1
Name: epsagon
Version: 1.0.24
Summary: Epsagon Instrumentation for Python
Home-page: https://github.com/epsagon/epsagon-python
Author: Epsagon
Author-email: support@epsagon.com
License: MIT
Keywords: serverless,epsagon,tracing,distributed-tracing,lambda,aws-lambda,debugging,monitoring
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
Requires-Dist: wrapt (==1.10.11)
Requires-Dist: requests (==2.20.0)
Requires-Dist: boto3
Requires-Dist: simplejson (==3.13.2)
Requires-Dist: six (==1.11.0)
Requires-Dist: future (==0.16.0)

# Epsagon Instrumentation for Python
[![Build Status](https://travis-ci.com/epsagon/epsagon-python.svg?token=wsveVqcNtBtmq6jpZfSf&branch=master)](https://travis-ci.com/epsagon/epsagon-python)
[![Pyversions](https://img.shields.io/pypi/pyversions/epsagon.svg?style=flat)](https://pypi.org/project/epsagon/)
[![PypiVersions](https://img.shields.io/pypi/v/epsagon.svg)](https://pypi.org/project/epsagon/)

This package provides an instrumentation to Python code running on functions for collection of distributed tracing and performance monitoring.


## Installation

From your project directory:

```
$ pip install epsagon
```

More details about lambda deployments are available in the [AWS documentation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-python-how-to-create-deployment-package.html).

## Basic Usage

Simply use our decorator to report metrics:

```python
import epsagon
epsagon.init(
    token='my-secret-token',
    app_name='my-app-name',
    metadata_only=False,  # Optional, send more trace data
)

@epsagon.lambda_wrapper
def handler(event, context):
  pass
```

## Custom labels

You can add custom labels to your traces. Filters can later be used for filtering
traces that contains specific labels:
```python
@epsagon.lambda_wrapper
def handler(event, context):
  epsagon.label('first_label', 'value1')
  epsagon.label('second_label', 'value2')
  pass
```

## Copyright

Provided under the MIT license. See LICENSE for details.

Copyright 2018, Epsagon.


