# Better Stack

Better Stack: uptime-мониторы, инциденты, heartbeats, статус-страницы, on-call

## Scenarios

### What is down right now
The agent walks every monitor and names the ones currently down, pending or paused, with the time of the last check.

### Incidents in your work chat
The agent posts to chat the moment an incident is created, acknowledged or resolved, with no waiting for an email or an escalation call.

### Night outage review
The agent puts together a morning summary: what went down overnight, for how long and which monitors were left switched off.

### On-call rota and status page
The agent shows who is on call right now per the on-call schedule and what customers see on the status page at that moment.

## How to connect

### Sign in with the Admin role
In Better Stack only the Admin role can manage API tokens. Team lead, Responder, Billing admin and Member cannot create one, so ask your team owner to raise your role first.

### Open the API tokens page
In the Better Stack dashboard go to Better Stack → «API tokens». It has two blocks: «Global API tokens» works across all your teams, «Team-based tokens» is scoped to a single team.

### Pick the team under Team-based tokens
In «Team-based tokens» select the team whose monitors you need and find the «Uptime API tokens» block. Such a token only sees that team's monitors and incidents; for several teams take a «Global API token» instead.

### Copy the token from Uptime API tokens
Copy the existing token or create a new one. It is a Bearer token for https://uptime.betterstack.com/api/v2 — a working token answers GET /monitors with your monitors instead of a 401.

## FAQ

### How do I connect Better Stack?
With an API token: open API tokens in the dashboard, a section available to the Admin role only. Under Team-based tokens pick a team and take the value from Uptime API tokens: it sees that team monitors only, and covering several teams needs a Global API token.

### What does the agent see in Better Stack?
Uptime monitors and their state, incidents and their history, heartbeats, status pages and on-call schedules of the team whose token is connected.

### How do incidents arrive?
Over a webhook: the agent receives incident created, acknowledged and resolved events immediately and can post about them in your work chat without polling on a schedule.

### Does the agent write to Better Stack?
Not by default: the agent reads monitors and incidents and reports in chat. It will not create or change monitors without an explicit request from you.

[Open Better Stack](https://uptime.betterstack.com)