Skip to main content

A Flask web application to monitor rq jobs, with a preference for monitoring histograms using d3.plotable.

This base package allows you to quickly get a robust submit-poll loop up on running on the client side, with the server handling job submission and results retrieval.

See example-monitoring-app for an example application that uses jobmonitor to display histograms from a ROOT file, including example deployment scripts in a Vagrant virtual machine.

Installing

Pip is the recommend way of installing the jobmonitor module. As the latest release is available on PyPI, installing it is simple.

$ pip install jobmonitor

The latest development version, the head of the master branch, can be installed instead, if desired.

$ pip install "git+https://github.com/alexpearce/jobmonitor.git#egg=jobmonitor"

Either option will automatically install the monitor’s dependencies.

Running

The job monitor doesn’t do much user-facing stuff by itself, instead it is expected that you will want to create a ‘child’ application that uses jobmonitor. You can run the application if you like though, once it is installed, by creating and running a script to start Flask’s development server.

import jobmonitor
app = jobmonitor.create_app()
app.run(debug=True)

The rq workers can be started with a separate script. An example is included. A Redis database is expected to be running when the workers start.

Testing

Build status

Tox is recommended to run the test suite for the jobmonitor module.

$ git clone https://github.com/alexpearce/jobmonitor.git
$ cd jobmonitor
$ pip install tox
$ tox

This will run the test suite under the Python environments defined in the tox.ini file.

Metadata

Release files for jobmonitor 0.0.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jobmonitor 0.0.5
File Size Uploaded
jobmonitor-0.0.5.tar.gz 136.3 kB Details

Release files / jobmonitor-0.0.5.tar.gz

Download URL jobmonitor-0.0.5.tar.gz
Size 136.3 kB
Tags Source
SHA-256 checksum
How to use checksums
cfd6fda5c463b4b516575d77b120c809383887694125f690cb0c88c17245ff31
BLAKE2b-256 checksum
How to use checksums
7509a568051355029b6f30526d676d991b2aa905d1aa76ee50628a857fef5250
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.0.5 This release

1 release file

0.0.4

1 release file

0.0.3

1 release file

0.0.2

1 release file

0.0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page