Skip to content

Quick Start

Every runtime uses the same HTTP receipt. First-class paths: curl, Node, Python, Sidekiq, and GitHub Actions. Laravel is the deep integration when you need schedule attach, queue depth, and Horizon.

1. Create an app

  1. Sign up at app.crontinel.com.
  2. Create an app and copy its ingest key. That key is not an MCP key.
  3. Put it in the job environment as CRONTINEL_INGEST_KEY.

2. Send a receipt

Pick one path. Full recipes: Check-in from any runtime.

curl

Terminal window
STARTED=$(date -u +%Y-%m-%dT%H:%M:%SZ)
curl -sS -X POST "https://app.crontinel.com/api/v1/ingest/cron" \
-H "Authorization: Bearer $CRONTINEL_INGEST_KEY" \
-H "Content-Type: application/json" \
-d "{\"request_key\":\"run-$(date +%s)\",\"command\":\"reports:generate\",\"status\":\"completed\",\"exit_code\":0,\"started_at\":\"$STARTED\",\"finished_at\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"outcomes\":{\"metrics\":{\"processed_records\":12}}}"

Python — download outcome_checkin.py (standard library only, no supported PyPI package on this path).

Node — fetch the same JSON body (no supported npm package on this path).

Sidekiq / Ruby — wrap the job with a Net::HTTP receipt that reports failed when it raises (no supported gem on this path).

GitHub Actions — repository secret + a final curl step with if: always(), so a failed workflow still reports.

3. Set the minimum

A receipt only fails when a rule says what counts as real work. After your first receipt, the dashboard shows “Set a minimum” next to the job. Follow it, or open the app and choose Outcome rules. Add a rule with the key processed_records, type Numeric minimum, threshold 1.

4. Verify

  1. Confirm the run appears on the dashboard.
  2. With a minimum rule of 1, processed_records: 0 should open an outcome alert even when exit code is 0.
  3. Send a later count that passes and confirm recovery.

Laravel deep integration

If you run Laravel and want scheduler attach, queue depth, and Horizon:

Terminal window
composer require crontinel/laravel
php artisan crontinel:install

See Installation and Laravel.

Next steps