Fast and lightweight errors tracking service.
Hawk.so is a clever and easy-to-use errors tracker. It collects all your code exceptions and errors and helps you to improve applications.
Please, welcome to the simple user guide.
Integration scheme contains a three steps. Your need to register, add a domain and install one of the Catchers.
Follow /join link to access registration form. Leave working email, and we will send you a password. You can change it at any time later.
After that you'll be entranced by internal section. We call it the Garage.
Now, look at the Sidebar. There will appear all your registered domains. Touch «Add domain» button to create your first.
Fill domain's name and submit a form. Now you have an Integration Token.
All registration procedures passed, next step is an installation of the some error Catchers. They're simple scripts that collect exceptions and deliver them to the Garage.
Currently, we provide Catchers for the next technologies:
This list will be expanded soon. If you can code, you can implement your own Catcher.
To deliver JavaScript errors we provide the fast and non-blocking Socket-based Catcher.
How to use. Include <script> tag loaded from the CDN or local cloned exemplar.
<script src="hawk.js" async></script>Next, initialize the module with your Integration Token.
<script>
hawk.init({token: “INTEGRATION_TOKEN”});
</script>Hawk supports JS SourceMaps for showing more useful information from your minified bundle. There a few conditions:
- Bundle ends with line contains anchor to the source map, like
//# sourceMappingURL=all.min.js.map. It can be absolute or relative (relatively the bundle) path. - Source map are publicly available by its URL.
- On every rebuilding you are updating the revision and pass it with `init` method. It can be heximal-hash or simply file's modification timestamp.
hawk.init({token: 'INTEGRATION_TOKEN', revision: 12345654345})You can get notifications about catched errors to the Email, Telegram or Slack. For the last two types, we use Webhooks, so you free to use an any webhook bot, for example, our — @codex_bot.
Note about Webhook's query format. It is a POST-request with the message field contains notification's text.
To setup Notifications, open the Settings page, find a Project and click on the «Configure Webhooks» button. Then add Webhook endpoints for the Slack or Telegram and press «Save». Don't forget to activate checkboxes for the selected types.
Hawk now in a public beta stage. So we allow to collect up to {{ eventsLimit|counter }} events of different types by a Project. You can have a several Projects at one account.
CodeX is a small team of enthusiasts. We love web-development, build social and media services and trying to grow ourselves.
Please, leave a feedback on the our email team@ifmo.su. We REALLY appreciate this. And thanks for reading.