Cron monitoring tool. It works well with cronitor.io & sentry.io Cronitor.io can help you know if the tool doesn't start or end correctly. Or if it takes an abnormally long time to complete. Sentry.io helps debugging by giving stack traces when your cron code fails.
This tool currently requires Python 3.6 or higher. There's a current issue to add Python 2 support.
If you're on a Mac, it's as simple as running
brew install python3
Or using whatever package manager for your system.
To get the benefit of Cronitor.io integration. You'll need to sign up for an account with them and setup a new "Cron job" monitor. When you setup your monitor, you'll receive a link like
https://cronitor.link/6gVGE7/{ENDPOINT}
The alphanumeric string after "https://cronitor.link/" and before the endpoint is your Cronitor
unique identifier. You'll need to pass that to crony
with --cronitor to integrate the cron
monitoring with cronitor.io.
To integration crony with Sentry.io for debugging & error tracking, you'll need to create an
account at Sentry.io. After creating an account, you can setup a project
for your crons. Sentry will give you a DSN url that you'll need to integration with crony.
You can then specify your DSN when calling crony
with --dsn
, or with a SENTRY_DSN
environment variable, or by placing it inside a config file.
Simply install with
pip install crony
To get a list of options use
crony --help
Crony can wrap any shell command, try this
crony echo "hello world"
View the wiki for environment variables and configuration file options.
There's a current issue to write unit tests.
New commits must pass pep8 & flake8 standards. The only allowed exception is pep8 line length is allowed to be up to 99 characters.
pep8 . --max-line-length=99
Should yield 0 errors.
flake8 .
Should also yield 0 errors.
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests.
Ideally we'll use SemVer for versioning. For the versions available, see the tags on this repository.
- Brad Belyeu - Initial work - bbelyeu
This project is licensed under the MIT License - see the LICENSE.md file for details.
- Thanks to PurpleBooth for the README template
- Thanks to Jan-Philip for the great blog post.