.. raw:: html

.. image:: https://s3.amazonaws.com/auklet/static/auklet_python.png :target: https://auklet.io :align: center :width: 1000 :alt: Auklet - Problem Solving Software for Python

.. raw:: html

</p>

Auklet for Python

.. image:: https://img.shields.io/pypi/v/auklet.svg :target: https://pypi.python.org/pypi/auklet :alt: PyPi page link -- version

.. image:: https://img.shields.io/pypi/l/auklet.svg :target: https://pypi.python.org/pypi/auklet :alt: PyPi page link -- Apache 2.0 License

.. image:: https://img.shields.io/pypi/pyversions/auklet.svg :target: https://pypi.python.org/pypi/auklet :alt: PyPi page link -- Python Versions

.. image:: https://api.codeclimate.com/v1/badges/7c2cd3bc63a70ac7fd73/maintainability :target: https://codeclimate.com/repos/5a54e10be3d6cb4d7d0007a8/maintainability :alt: Code Climate Maintainability

.. image:: https://api.codeclimate.com/v1/badges/7c2cd3bc63a70ac7fd73/test_coverage :target: https://codeclimate.com/repos/5a54e10be3d6cb4d7d0007a8/test_coverage :alt: Test Coverage

This is the official Python agent for Auklet_, official supports 2.7.9+ and 3.4-3.7, and runs on most posix based operating systems (Debian, Ubuntu Core, Raspbian, QNX, etc).

Features

• Automatic report of unhandled exceptions
• Automatic Function performance issue reporting
• Location, system architecture, and system metrics identification for all issues
• Ability to define data usage restriction

Compliance

Auklet is an edge first application performance monitor and as such after 1.0 releases of our packages we maintain the following compliance levels:

• Automotive Safety Integrity Level B (ASIL B)

If there are additional compliances that your industry requires please contact the team at hello@auklet.io_.

Quickstart

To install the agent with pip::

pip install auklet

To setup Auklet monitoring for you application:

.. sourcecode:: python

from auklet.monitoring import Monitoring
auklet_monitoring = Monitoring(
    api_key="<API_KEY>", app_id="<APP_ID>", release="<CURRENT_COMMIT_HASH>"
)

auklet_monitoring.start()
# Call your main function
main()
auklet_monitoring.stop()

Authorization ^^^^^^^^^^^^^ To authorize your application you need to provide both an API key and app id. These values are available in the connection settings of your application as well as during initial setup.

Release Tracking ^^^^^^^^^^^^^^^^ To track releases and identify which devices are running what version of code we currently require that you provide the commit hash of your deployed code. This value needs to be passed into the constructor through release. The value needs to be the commit hash that represents the deployed version of your application. There are a couple ways for which to set this based upon the style of deployment of your application.

Get Release via Subprocess """""""""""""""""""""""""" In the case that you deploy your entire packaged github repository and have git installed on the device you can get it via a subprocess:

.. sourcecode:: python

git_commit_hash = subprocess.check_output(
    ['git', 'rev-parse', 'HEAD']).strip("\n")

Get Release via Environment Variable """""""""""""""""""""""""""""""""""" If you package your app and deploy it without access to git and the repo's commit history you can include it via environment variable:

.. sourcecode:: python

git_commit_hash = os.environ.get("APPLICATION_GIT_COMMIT_HASH")

Get Release via File """""""""""""""""""" Lastly if it is difficult or impossible to set an environment variable via your deployment platform you can include a new file in your packaged deployment which holds the release which you can read from and supply to the constructor.

Write the commit hash to a file and then package it into your deployment:

.. sourcecode:: shell

git rev-parse HEAD > path/to/git_commit_hash.txt

This can then be read by adding the following to your python code.

.. sourcecode:: python

my_file = open("git_commit_hash.txt", "r")
git_commit_hash = my_file.read()

Resources

• Auklet_
• Python Documentation_
• Issue Tracker_

.. _Auklet: https://auklet.io .. _hello@auklet.io: mailto:hello@auklet.io .. _ESG-USA: https://github.com/ESG-USA .. _ESG Organization: https://github.com/ESG-USA .. _Python Documentation: https://docs.auklet.io/docs/python-integration .. _Issue Tracker: https://github.com/aukletio/Auklet-Agent-Python/issues