Skip to main content

Physics-orientated job monitoring over HTTP with Flask.

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jobmonitor-0.0.1.tar.gz (136.2 kB view details)

Uploaded Source

File details

Details for the file jobmonitor-0.0.1.tar.gz.

File metadata

  • Download URL: jobmonitor-0.0.1.tar.gz
  • Upload date:
  • Size: 136.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for jobmonitor-0.0.1.tar.gz
Algorithm Hash digest
SHA256 8f24d1a1a5ffe957bc16a0bb837de0a56aca9a3cb2ccededbc54e2548778cf6e
MD5 0bf4a813508761ccbd8347ea1663a1e1
BLAKE2b-256 c410e3692c8d548ac46e722a7e2ae7ea063e78313148634f7c29bcab0b82ce99

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page