> For the complete documentation index, see [llms.txt](https://docs.devland.is/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devland.is/technical-overview/adr/0005-error-tracking-and-monitoring.md).

# Error Tracking and Monitoring

* Status: accepted
* Deciders: devs, devops
* Date: 12.06.2020

## Context and Problem Statement

Know it before they do! We need a tool to discover, triage, and prioritize errors in real-time.

## Considered Options

* [Bugsnag](https://www.bugsnag.com/)
* [Sentry](https://sentry.io/)

## Decision Outcome

Chosen option: `Sentry`, because it ranks higher in a community survey regarding our stack (Javascript). It's also much cheaper and offers the choice to be completely free if we self-host it.

## Pros and Cons of the Options

### Bugsnag

* Good, because it offers a Slack integration for faster feedback.
* Good, because it offers a Github integration to link to possible commits and PRs.
* Good, because it offers bot front-side/server-side/serverless error tracking.
* OK, because it was ranked the **#5** as the best Javascript (client-side) error logging service in a community survey.
* Bad, because it's expensive. (**$199/mo** for **450k events** and **15 collaborators**)
* Bad, because it's pricing includes a fixed set of collaborators.

### Sentry

* Good, because it offers a Slack integration for faster feedback.
* Good, because it offers a Github integration to link to possible commits and PRs.
* Good, because it offers bot front-side/server-side/serverless error tracking.
* Good, because it was ranked the **#1** as the best Javascript (client-side) error logging service in a community survey.
* Good, because it's cheaper than most error logging services out there (half the price of Bugsnag).
* Good, because it offers the possibility of being completely free with a self-hosted solution (since Sentry is open-source).
* Good, because you only pay for the number of events, regardless of how many collaborators.
* Bad, because it costs (since we won't go with the self-hosted solution at first). (**$89/mo** for **500k events** and **∞ collaborators**)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devland.is/technical-overview/adr/0005-error-tracking-and-monitoring.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
