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.