monetdb-pystethoscope 0.3.0

Introduction

pystethoscope is a command line tool to filter and format the events coming from the MonetDB profiler. The profiler is part of the MonetDB server and works by emitting two JSON objects: one at the start and one at the end of every MAL instruction executed. pystethoscope connects to a MonetDB server process, reads the objects emitted by the profiler and performs various transformations specified by the user.

Installation

Installation is done via pip:

pip install monetdb-pystethoscope

This project is compatible with Python 3.5 or later and with MonetDB server version Jun2020 or later.

We recommend the use of virtual environments (see this primer if you are unfamiliar) for installing and using monetdb-pystethoscope.

Developer notes

pystethoscope is developed using Poetry, for dependency management and packaging.

pip3 install --user poetry
PYTHON_BIN_PATH="$(python3 -m site --user-base)/bin"
export PATH="$PATH:$PYTHON_BIN_PATH"

git clone git@github.com:MonetDBSolutions/monetdb-pystethoscope.git
cd monetdb-pystethoscope
poetry install
poetry run pystethoscope --help

Documentation

For more detailed documentation please see the documentation on readthedocs.