cronitor

library4.9.0pypypi✓ verified 87d ago

A lightweight Python client for Cronitor, providing monitoring and alerting for cron jobs, background jobs, and API endpoints. Current version 4.9.0, released May 2025. Active development with occasional minor releases.

devops observability

pip install cronitor

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CRONITOR

cronitor

devopspythonv4.9.0

Install

2.2s avg

Import

—

Disk

23MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v4.9.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 24.1MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.2s · import 0.000s · 25MB

23MB installed

● package 23MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Monitor

✓ from cronitor import Monitor

✗ from cronitor import Cronitor

State

✓ from cronitor import State

api_key

✓ from cronitor import api_key

Initialize the client with your API key, create a monitor, and send a run ping.

import os from cronitor import Cronitor api_key = os.environ.get('CRONITOR_API_KEY', '') if not api_key: raise ValueError('CRONITOR_API_KEY environment variable not set') cronitor = Cronitor(api_key=api_key) # Create a monitor monitor = cronitor.monitors.create(name='My Job', schedule='*/5 * * * *') # Ping the monitor cronitor.ping(monitor.key, state='run') print('Job started.')

Debug

Known issues

breakingIn v4.0, the client was rewritten. The old import pattern `from cronitor import Cronitor` still works, but the API for creating monitors changed: use `cronitor.monitors.create()` instead of `Cronitor(api_key).create_monitor()`.

fix

Use `cronitor.monitors.create(name, schedule)` instead of direct methods on the Cronitor class.

affects: >=4.0.0,<5.0.0

gotchaAPI key must be set via environment variable or passed explicitly. The client does not auto-read from .env files.

fix

Set CRONITOR_API_KEY environment variable or pass `api_key` argument to Cronitor() constructor.

affects: all

deprecatedThe `pings.create()` method is deprecated in favor of the module-level `ping()` function.

fix

Use `from cronitor import ping` and call `ping(monitor_key, state='...')` instead of `cronitor.pings.create(...)`.

affects: >=4.5.0

Upgrade

Version history

4.9.0latest on PyPI · released Oct 8, 2025

Audit

Dependencies

requestsrequiredHTTP client for API calls

Agent activity

24 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/cronitorio/cronitor-python ↗

packagehttps://pypi.org/project/cronitor/ ↗

homepagehttps://cronitor.io ↗