Hawk.so
Fast and lightweight errors tracking service.
Platform documentation
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.
Getting Started
Integration scheme contains a three steps. Your need to register, add a domain and install one of the Catchers.
Create an account
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.
Register domains
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.
Integration
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.
Add the Server Handler
Currently, we provide Catchers for the next technologies:
This list will be expanded soon. If you can code, you can implement your own Catcher.
Add the Client Handler
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>Source map support
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})Notifications
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.
Archiving
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.
Our team
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 [email protected]. We REALLY appreciate this. And thanks for reading.