Judoscale for Express.js

Official Judoscale adapter package for Express.js applications.

Set up your Express app for autoscaling

1. Install the judoscale-express package:

npm install judoscale-express --save

2. Import and use the provided middleware:

Judoscale should be one of the first middlewares for your app.

// ESM
import { Judoscale, middleware as judoscaleMiddleware } from 'judoscale-express'

// CommonJS
const { Judoscale, middleware: judoscaleMiddleware } = require('judoscale-express')

// Initialize Judoscale with default configuration
const judoscale = new Judoscale()

// custom configuration (see config options below)
const judoscale = new Judoscale({
  log_level: 'debug',
})

// Inject the middleware (this should be the first middleware)
app.use(judoscaleMiddleware(judoscale))

Configuration

Most Judoscale settings are handled via the Judoscale dashboard, but there are a few ways you can configure the adapter in code:

new Judoscale({
  // Use a custom logger instance
  // Default: Winston logger instance (simple format)
  logger: myLogger,

  // Override the log level of the default logger (ignored if logger is overridden)
  // Default: process.env.JUDOSCALE_LOG_LEVEL || 'info'
  log_level: 'debug',
})

Troubleshooting

Once installed, you should see something like this in your development log:

[Judoscale] Reporter not started: JUDOSCALE_URL is not set

In your production app where you've installed Judoscale, you should see this in your logs:

[Judoscale] Reporter starting, will report every 10 seconds

If you don't see either of these, ensure "judoscale-express" is in your Package.lock file, and restart your app.

You can see more detailed (debug) logging by setting the environment variable JUDOSCALE_LOG_LEVEL=debug on your deployed application. Here's how you would do that on Heroku:

heroku config:set JUDOSCALE_LOG_LEVEL=debug

Reach out to [email protected] if you run into any other problems.