pyramid-elasticapm

elastic-apm integration for the Pyramid framework

This package is inspired by https://www.elastic.co/de/blog/creating-custom-framework-integrations-with-the-elastic-apm-python-agent

This fork is using pyramid 1.10 and python 3.8 https://docs.pylonsproject.org/projects/pyramid/en/1.10-branch/

Since it is not published as a package, you have to install it from source, e.g. by adding the following to requirements.in/requirements.txt:

pyramid_elasticapm @ git+https://github.com/betermarks/pyramid_elasticapm.git

Installation

Install with pip:

$ pip install git+https://github.com/betermarks/pyramid_elasticapm.git

Then include it in your pyramid application via config:

[app:main]
...
pyramid.includes = pyramid_elasticapm

or programmatically in your application:

config.include('pyramid_elasticapm')

Settings

Settings for the elasticapm client can be specified via the elasticapm namespace, e.g.:

• `elasticapm.server_url`: Specify the apm server url.
• `elasticapm.secret_token`: Your secret authentication token for the server.
• `elasticapm.service_name`: The service name
• `elasticapm.environment`: The environment (e.g. testing, production, …)
• `elasticapm.service_distribution`: The name of the package your are deploying. pyramid_elasticapm will retrieve the version number of this package and put it into the metadata of every transaction.
• `elasticapm.transactions_ignore_patterns`: Whitespace separated list of ignore patterns.
• `elasticapm.transaction_sample_rate`: Transaction sample rate
• `elasticapm.collect_local_variables`: Possible values: errors (default), transactions, all, off Keep in mind that those things can contain data that is covered by GDPR policies

All possible configuration options are supported, see https://www.elastic.co/guide/en/apm/agent/python/current/configuration.html

Contributing

1. install direnv: https://direnv.net/docs/installation.html
2. hook direnv: https://direnv.net/docs/hook.html

3. create a new file called .envrc with the following content:

   # https://github.com/direnv/direnv/wiki/Python#venv-stdlib-module
   export VIRTUAL_ENV=venv
   layout python python3.8

4. use direnv allow so direnv creates and activates the virtual env when entering the directory
5. use pip install -e . -r requirements.lock to install the dependencies
6. run the tests pytest
7. use pre-commit install before your first commit, see https://github.com/bettermarks/.github#git-hooks
8. use pip freeze --local > requirements.lock to update the lock file, after the input changed