# Atatus Destination

## Destination Info

* Accepts [Page](/docs/segment/connections/spec/page), [Identify](/docs/segment/connections/spec/identify) calls.
* Refer to it as **Atatus** in the [Integrations object.](/docs/segment/guides/filtering-data/#filtering-with-the-integrations-object)

### Components

* [Browser](https://github.com/segment-integrations/analytics.js-integration-atatus)

## Connection Modes

[Learn more about connection modes.](/docs/segment/connections/destinations/#connection-modes)

### Device-Mode

* web: yes
* mobile: no
* server: no

### Cloud-Mode

* web: no
* mobile: no
* server: no

[Atatus](https://www.atatus.com/) provides visibility into the performance of an application and its underlying infrastructure under a single dashboard. This visibility can help businesses identify and diagnose issues, and take corrective action to prevent or resolve application issues.

## Getting Started

Before you start, make sure Atatus supports the source type and connection mode you've chosen to implement. You can learn more about [connection modes here](/docs/segment/connections/destinations/#connection-modes).

1. From the destinations catalog page in the segment web app, click on **Destinations -> Add Destination**.
2. Search for "Atatus" in the destination catalog and select Atatus as the destination.
3. Click on **Configure Atatus**.
4. Choose which **Data Source** should send data to the Atatus destination and click Next.
5. Enter the desired destination and click Save. You will be navigated to the settings page where you will have to add the API key to start receiving insights.
6. You can find the API key in your browser project settings.
7. Enter the **API Key** in the Atatus destination settings in Segment.

## Supported Methods

### Identify

If you're not familiar with the Segment Specs, take a look to understand what the [Identify](/docs/segment/connections/spec/identify/) method does. An example call would look like this:

```javascript
analytics.identify('userid_123', {
name: "John Doe",
email: "johndoe@example.com"
});
```

When you call Identify, the Atatus SDK calls `atatus.setUser` by passing in the traits you provided. Atatus maps the userId you provide as `traits.id`, which you can use to track user activity and gain a specific user's performance insights.

## Settings

Segment lets you change these destination settings from the Segment app without having to touch any code.

| Field                             | Description                                                                                                                                     | Required | Type    |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- |
| Whitelist Urls                    | Captures the page views, AJAX and JS Errors from the given domains or URLs and ignores insights from all other URLs.                            | No       | array   |
| API Key                           | To find your API Key, create a project in your Atatus dashboard. The key should look something like this: \`16ae323d8b3244733a981215c9d66e67d\` | Yes      | string  |
| Disable AJAX Monitoring           | If you don't want to track the AJAX(XHR) requests in your app, then select this option.                                                         | No       | boolean |
| Disable Error Tracking            | Set this to true to disable error tracking.                                                                                                     | No       | boolean |
| Disable RUM                       | You can disable RUM metrics by setting this option to true.                                                                                     | No       | boolean |
| Disable Session                   | You can set this option to true if you want to disable reporting of session traces.                                                             | No       | boolean |
| Disable SPA                       | Set this option to true to disable SPA monitoring.                                                                                              | No       | boolean |
| Disable Transaction               | You can disable the collection of transactions by setting the option to true.                                                                   | No       | boolean |
| Enable Offline Errors and Metrics | Enable offline errors and metrics tracking when network connectivity is not available.                                                          | No       | boolean |
| Hash Routes                       | Atatus removes the hash from the URL and if you're using hash based routes you can set this option to true.                                     | No       | boolean |
| Ignore Errors                     | It is an array of unwanted error messages to be filtered out before being sent to Atatus as either array or regular expressions or strings.     | No       | array   |
| Ignore Urls                       | Ignore capturing insights from a given set of domains or URLs.                                                                                  | No       | array   |
| Report Unhandled Rejections       | This allows disabling or enabling the unhandled promise rejection errors.                                                                       | No       | boolean |
| Version                           | Helps you in filtering the errors from the dashboard using the version.                                                                         | No       | string  |
