Drop-in Node.js admin endpoint to help you analyze production issues.
npm install adminDrop-in Node.js admin endpoint to help you analyze production issues.
Live Demo |
Usage |
FAQ |
Plugins |
Example project |
Changelog
---
Running apps in production can be challenging. Applications may crash, run into bugs or get slow. There are a variety of ways to approach such issues. Admin is a tool to help troubleshoot application issues. It is designed to provide detailed debugging information about running Node.js apps.
Admin provides debugging endpoints via an HTTP server. The functionality provided by this server is extensible as admin is a plugin system.
Instead of describing this at length, check out the live demo system on Heroku!
- Installation
- Usage
- FAQ
- How do I inspect the admin UI when it only binds to localhost?
``
npm install --save admin \
admin-plugin-config \
admin-plugin-healthcheck \
admin-plugin-environment \
admin-plugin-index \
admin-plugin-profile \
admin-plugin-report \
admin-plugin-terminate
`javascript
const admin = require('admin');
admin.configure({
http: { // optional
bindAddress: '127.0.0.1', // default
port: 2999 // default
},
plugins: [
require('admin-plugin-index')(),
require('admin-plugin-report')(),
require('admin-plugin-environment')(),
require('admin-plugin-profile')(),
require('admin-plugin-terminate')(),
require('admin-plugin-config')({
config: {
// An application config goes here. This config object will be
// visible in the admin UI and via the admin REST endpoints.
secret: '42',
port: 8080
}
}),
require('admin-plugin-healthcheck')({
checks: {
// Define multiple healthchecks which check critical components
// in the system. The following example shows valid return values.
random() {
const v = Math.random();
if (v > 0.8) {
throw new Error('Random value >0.8');
} else if (v > 0.3) {
return "Healthy like an application that isn't used.";
} else {
return Promise.reject('Something bad happened here…');
}
}
}
})
]
});
admin.start();
`
`
SSH_KEY="~/.ssh/
REMOTE_USER="
REMOTE_HOST="
ADMIN_PORT="
ssh -i "$SSH_KEY" -Nf -L "$ADMIN_PORT:localhost:$ADMIN_PORT" "$REMOTE_USER@$REMOTE_HOST"
curl "localhost:$ADMIN_PORT"
``