Skip to content

maxirus/python-sensor

 
 

Repository files navigation

Instana

The instana package provides Python metrics and traces (request, queue & cross-host) for Instana.

Build Status OpenTracing Badge

Note

This package supports Python 2.7 or greater.

Any and all feedback is welcome. Happy Python visibility.

Installation

pip install instana into the virtual-env or container (hosted on pypi)

Django

For Django versions >= 1.10 set the following environment variable in your application boot environment and then restart your application:

export AUTOWRAPT_BOOTSTRAP=django

For Django version 1.9.x, instead set:

export AUTOWRAPT_BOOTSTRAP=django19

Flask

To enable the Flask instrumentation, set the following environment variable in your application boot environment and then restart your application:

export AUTOWRAPT_BOOTSTRAP=flask

Runtime Monitoring Only

Note: When the Django or Flask instrumentation is used, runtime monitoring is automatically included. Use this section if you only want to see runtime metrics.

To enable runtime monitoring (without request tracing), set the following environment variable in your application boot environment and then restart your application:

export AUTOWRAPT_BOOTSTRAP=runtime

uWSGI

Threads

This Python instrumentation spawns a lightweight background thread to periodically collect and report process metrics. By default, the GIL and threading is disabled under uWSGI. If you wish to instrument your application running under uWSGI, make sure that you enable threads by passing --enable-threads (or enable-threads = true in ini style). More details in the uWSGI documentation.

Forking off Workers

If you use uWSGI in forking workers mode, you must specify --lazy-apps (or lazy-apps = true in ini style) to load the application in the worker instead of the master process.

Usage

The instana package will automatically collect key metrics from your Python processes. Just install and go.

Tracing

This Python package supports OpenTracing.

Documentation

You can find more documentation covering supported components and minimum versions in the Instana documentation portal.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/instana/python-sensor.

More

Want to instrument other languages? See our Nodejs, Go, Ruby instrumentation or many other supported technologies.

About

🐍 Python Tracing & Metrics Sensor for Instana

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%