Gotcha

Первые шаги

Gotcha — платформа наблюдаемости: ошибки, производительность, метрики, аптайм и оповещения в одном месте. Она говорит на протоколе приёма Sentry, поэтому подключение сводится к тому, чтобы поставить обычный Sentry SDK вашего языка и указать ему DSN вашего проекта Gotcha. Эта страница — сквозной путь от регистрации до первого события и первого оповещения; каждый шаг короткий и ссылается на более подробную страницу.

Если вы ещё не подняли саму Gotcha (это отдельный self-hosted сервис — Docker-образ + PostgreSQL + ClickHouse), начните со страницы установки: Установка и эксплуатация. Всё ниже написано с точки зрения человека, который уже открыл рабочий инстанс в браузере.

1. Зарегистрируйтесь

Откройте /register на вашем инстансе и создайте пользователя (email + пароль). На свежем инстансе первый зарегистрированный пользователь всегда проходит регистрацию — вне зависимости от режима регистрации — и автоматически получает права администратора инстанса. Все следующие пользователи регистрируются по правилам, которые задал администратор (открытая регистрация, только по инвайтам или полностью закрытая).

2. Создайте организацию и первый проект

Сразу после первого входа вас перенаправит на /onboarding — это одна форма, где сразу создаются и организация, и первый проект:

  • Организация — слаг (короткий идентификатор в URL, например my-team) и человекочитаемое имя. Организация объединяет проекты и участников; в неё вы будете приглашать команду.
  • Проект — слаг, имя и платформа (Go / PHP / JavaScript / Python / другое — это просто подсказка для сниппетов на следующем шаге, на приём данных она не влияет). Проект — это отдельное приложение или сервис: события, транзакции и метрики всегда привязаны к конкретному проекту, а не к организации в целом.

Подробнее о том, что чем является: Термины.

3. Найдите DSN проекта

После создания проекта вас автоматически перенаправит на страницу «Подключение» конкретного проекта — URL вида /projects/<id>/setup. На ней сразу виден DSN и готовые сниппеты для Go/PHP/JavaScript. Вернуться на эту страницу позже можно двумя путями:

  • со страницы «Проекты» — у каждого проекта в таблице есть кнопка «Подключение SDK»;
  • со страницы «Настройки проекта» (пункт «Настройки проекта» в меню проекта) — там же, в блоке «DSN-ключи», показан DSN текущего живого ключа, а также таблица всех ключей с возможностью выпустить новый или отозвать старый.

DSN выглядит как обычная ссылка вида https://<public_key>@<адрес_gotcha>/<id_проекта> — это open-key DSN без секретной части, точно такого формата, какой ждут официальные Sentry SDK.

4. Подключите SDK

Возьмите DSN из шага 3, установите официальный Sentry SDK своего языка и передайте DSN при инициализации — больше ничего специфичного для Gotcha в коде не нужно. Полный список языков, готовые команды установки, минимальная инициализация, отправка тестовой ошибки, настройка environment/release, включение трейсинга производительности и ссылки на приём метрик (OTLP) и профилей (pprof) — всё на странице SDK и интеграции. Если у вас PHP-проект (в том числе на Laravel) — там есть отдельные сниппеты именно под ваш случай.

5. Получите первое событие

Вызовите в приложении необработанную ошибку (или явно отправьте тестовое событие способом, описанным в SDK и интеграции для вашего языка). В течение нескольких секунд событие появится в разделе «Проблемы» проекта. Одинаковые ошибки (по типу, сообщению и месту в коде) группируются в одну «проблему» — счётчик растёт, а не плодятся дубликаты. Подробнее о списке, фильтрах и группировке: Проблемы.

Если событие не появилось — не паникуйте, в конце страницы SDK и интеграции есть раздел «Если событие не доходит» с разбором самых частых причин (неверный DSN, сеть/файрвол, квота, SDK не успел отправить данные до завершения процесса).

6. Настройте оповещения

Чтобы не проверять «Проблемы» вручную, откройте раздел «Оповещения» проекта:

  1. В блоке «Каналы доставки» нажмите «Добавить канал» и укажите тип (email, webhook или Telegram) и получателя.
  2. В блоке «Правила» включите нужные условия — новая проблема, регрессия (проблема снова открылась), всплеск ошибок — и привяжите к ним канал.

С этого момента команда будет узнавать о новых проблемах и всплесках без постоянного мониторинга дашборда. Подробнее о троттлинге повторных уведомлений и истории доставок: Оповещения.

Что дальше