# Heartbeat мониторинг

Входящие запросы от ваших задач или сервисов

> Индекс всей документации в markdown: https://statuser.cloud/llms.txt — там перечислены остальные статьи. Всё одним файлом: https://statuser.cloud/llms-full.txt. Документация API: https://statuser.cloud/api-reference.md

## Доступность по тарифам

Доступно в тарифах Pro и Team

| Функция | Free | Pro | Team |
| --- | --- | --- | --- |
| Heartbeat мониторинг | нет | да | да |

Сравнение тарифов: https://statuser.cloud/pricing

## Через API и MCP

Описанное в статье можно сделать программно — запросом к публичному API или через MCP-сервер Statuser, который работает поверх того же API. Понадобится API-ключ, создать его можно на любом тарифе; ограничения тарифа в API те же, что в интерфейсе.

- Документация API: https://statuser.cloud/api-reference (машиночитаемо: https://statuser.cloud/api-reference.md)
- MCP-сервер: https://github.com/statuser-cloud/mcp

---

Heartbeat — это мониторинг для задач и фоновых процессов без публичного HTTP/TCP‑эндпоинта. Вместо активных проверок из локаций Statuser вы **сами отправляете сигнал (heartbeat)** по расписанию. Если сигнал не пришёл вовремя, создаётся инцидент.

Heartbeat подходит для cron‑задач, бэкапов, ETL‑процессов, CI/CD‑шагов и любых периодических скриптов.

## Как это работает

После создания сервера с типом мониторинга **Heartbeat** Statuser выдаёт уникальный `heartbeat_token` и URL.

- задача выполняется и отправляет heartbeat
- если heartbeat не пришёл в ожидаемый интервал — создаётся инцидент
- следующий успешный heartbeat автоматически закрывает инцидент

> Поддерживаются методы **GET**, **POST** и **HEAD**. Успешный запрос возвращает
> **204 No Content**. Endpoint `/fail` используется для явного сообщения об
> ошибке выполнения задачи.

## Пример: cron‑задача

Пример ежедневного бэкапа с использованием Heartbeat:

```bash
#!/bin/bash

set -e

# выполняем задачу
pg_dump mydb > backup.sql

# сообщаем об успехе
curl -fsS -X POST "https://hb.statuser.cloud/<token>"
```

Если задача завершилась с ошибкой:

```bash
curl -fsS -X POST "https://hb.statuser.cloud/<token>/fail"
```

Инциденты не создаются до получения первого heartbeat.
Рекомендуется отправить первый запрос сразу после настройки мониторинга, чтобы Statuser начал отслеживание интервалов.

---

Источник: https://statuser.cloud/docs/heartbeat