Why waste your time at yet-another-middleman-website to manage your errors. Deploy your own, free runtimeerror.js & upgrade your Github Issues to manage error tracking directly.
Clustered errors, full context & stacktrace in your email notifications, wontfix, direct email replies to @johnappleseed works as intended. What's not to like?
NOTE: integrations to trello, pivotal tracker or any other things should be added as a provider
- Use a generic error message to group errors, e.g.
Session#create: User id={N} not found - Create a new issue if the generic title is new (team will be notified via Github)
- Update occurrence
countif issue already exist (no notifications, keep issue fresh) Reopenissue if it wasclosed, and add fresh debug data in comments (notify team of regression)- Ignore if issue was labelled
wontfix(no notifications)
runtimeerror.js does exactly this.
The way github works is that the creator/commenter of an issue will not be notified. This is a correct logic, but does not suit our purpose.
We recommend using a separate bot github account instead of your own so that when errors happen, bot will create the issues and you'll get the github notifications.
- Create a separate
githubaccount, e.g.bot - Add
botto the repository you want to integrate with. - Go into
Github.com > Account > Applications > Personal Access Tokensand create a token forbotaccount, e.g.token - Optionally, turn off all
emailandwebnotifications forbotaccount
The easiest option is to deploy on Heroku
- Create a heroku app
git pushthis repository to your heroku app- Optionally, set your environment variables (aka
heroku config:add)
SECRET=<your token>
REPO=<your org>/<your repo> # e.g. rails/rails
PROVIDER=github # (optional, currently only supports github)
LABEL=bug # (optional)
This setup uses the web.js mechanism.
Setting environment variables is optional because you can also use per-request config (see next point).
runtimeerror.js parses the email address format to extract REPO, SECRET, PROVIDER in the format of "{repo}" <{secret}@{provider}.com>
For example:
"rails/rails" <aaabbccddeeff@github.com>
would configure the error to be posted to
REPO=rails/rails
SECRET=aaabbccddeeff
PROVIDER=github
This allows for multiple repo/secret/provider accounts to share the same instance of runtimeerror.js deployed
Upload an email as a bug report on Github Issues (email subject + email body). In production environment, we recommend setting environment variable HIDE_UPLOAD_FORM=1 to hide this form.
node web.js
The web application is compatible with these popular error reporting tools
- bugsnag
- rollbar
- runtimeerror_notifier gem (set the
email toas described inconfig via email addresssection above)
Pipe email file through stdin. Compatible as Postfix mailbox_command config or as procmail replacement.
node procmail.js < sample.eml
NOTE: email to is used as account config, see config via email address section above
Command line arguments
node cli.js "title of bug" "bug description body"
0.2.0Issue description now shows sparkline image, reflecting error trend of past 7 days
GPL v2
Brought to you by RuntimeError.net