# Better Stack

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

## Сценарии

### Что сейчас лежит
Агент пройдёт по всем мониторам и назовёт те, что сейчас down, pending или стоят на паузе, с временем последней проверки.

### Инциденты в рабочем чате
Агент напишет в чат, как только инцидент заведён, взят в работу или закрыт, — без ожидания письма и звонка эскалации.

### Разбор ночных сбоев
Агент соберёт утреннюю сводку: что падало за ночь, надолго ли и какие мониторы так и остались выключенными.

### Дежурства и статус-страница
Агент покажет, кто сейчас на дежурстве по расписанию on-call и что в этот момент видят клиенты на статус-странице.

## Как подключить

### Войдите под ролью «Admin»
Токенами в Better Stack распоряжается только роль «Admin». Под «Team lead», «Responder», «Billing admin» и «Member» создать токен не выйдет — сначала попросите владельца команды поднять вам роль.

### Откройте раздел «API tokens»
В дашборде Better Stack перейдите Better Stack → «API tokens». Там два блока: «Global API tokens» — токен на все ваши команды сразу, «Team-based tokens» — токен на одну выбранную команду.

### Выберите команду в «Team-based tokens»
В «Team-based tokens» выберите команду, чьи мониторы нужны, и найдите блок «Uptime API tokens». Такой токен видит только мониторы и инциденты этой команды; если мониторы разложены по нескольким командам, берите «Global API token».

### Скопируйте токен из «Uptime API tokens»
Скопируйте готовый токен или нажмите создать новый. Это Bearer-токен для https://uptime.betterstack.com/api/v2 — если он рабочий, запрос GET /monitors возвращает ваши мониторы, а не 401.

## Частые вопросы

### Как подключить Better Stack?
API-токеном: в дашборде откройте «API tokens» — раздел доступен только роли «Admin». В блоке «Team-based tokens» выберите команду и возьмите значение из «Uptime API tokens»: он видит мониторы только этой команды, на несколько команд нужен «Global API token».

### Что агент видит в Better Stack?
Uptime-мониторы и их состояние, инциденты и их историю, heartbeats, статус-страницы и расписания дежурств той команды, чей токен подключён.

### Как приходят инциденты?
Через вебхук: события создания, взятия в работу и закрытия инцидента агент получает сразу и может написать о них в рабочий чат без опроса по расписанию.

### Пишет ли агент в Better Stack?
По умолчанию нет: агент читает мониторы и инциденты и отчитывается в чате. Создавать и менять мониторы он не станет без вашего явного запроса.

[Открыть Better Stack](https://uptime.betterstack.com)