REST based URL hook scheduler
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Naptime is an application that calls http endpoints at fixed intervals.


  1. Install and run mongod.
  2. cd into the naptime directory.
  3. lein deps && lein swank.
  4. Connect w/ slime and load the namespace. This will start the web process and 1 worker.
  5. Visit http://localhost:8080.


  1. heroku create --stack cedar
  2. git push heorku master
  3. Add the required env vars through heroku config:add. You can use MongoHQ for a free 16 meg mongo database.
  4. Visit http://<your-app-name>


Naptime's configured (dev and production) through several environment variables.

  • MONGO_DB -- Mongo db name.
  • MONGO_USER (if appicable)
  • MONGO_PASSWORD (if applicable)
  • WORKER_MAX_CAPACITY -- Max number of concurrent http requests per worker.
  • WEB_MAX_THREADS -- Max number of threads used to serve HTTP requests to the web interface.
  • WEB_WORKER_MAX_CAPACITY -- The web process also runs a worker, set the web process' worker max capacity here.
  • WORKER_SLEEP_TIME -- Sleep time per worker run loop iteration.


  • Clojure
  • Heroku
  • MongoDB


endpoints overview

endpoint detail


Scheduling Endpoints

The endpoint and period are recieved from the user, and a next-update absolute time value is calculated based on currrent time and period:

next execution time = current time + period

This information is then stored like so in the :jobs collection:

{:endpoint ""
 :period 5000 ; (ms)
 :next-update 1316480549459}

Running Endpoints

A worker continuously pulls the next job to be executed (where current time > next update), atomically locks the entry so that no other workers can grab it, and makes an http request against the endpoint.

The next execution time is calculated at the beginning of this process. The next execution time is then updated on the job, and the job is unlocked, available for another worker to process.

Updating / Deleting Endpoints

Standard operations against the database.

Scaling Naptime

Naptime should scale nicely. Simply add more workers when load gets too high (see load charts on naptime webapp index page).


  • Set timeout on http request.
  • Using an async http client should allow a higher request cap.
  • Human readable input format (10 seconds / 10 s vs 10000).
  • Log data should be cleaned on input (ie don't log a start lag of 1 bil ms).
  • Cleaner separation between presentation / persistence.
  • Human readable worker names.
  • Make database interaction less brittle (have to remember to :upsert? false).
  • Allow view of historical data for deleted endpoints.
  • Better error handling (even though heroku will restart crashed workers).
  • Refactor for testing.


Copyright (C) 2011 Zachary Kim

Distributed under the Eclipse Public License, the same as Clojure.