LLogsy

Отдайте агенту то, что реально сломалось у пользователя

Обычный цикл: пользователь пишет «у меня не работает», вы пересказываете это агенту, агент гадает. С Logsy агент получает факты — стектрейс ошибки, упавший запрос с телом и заголовками, шаги посетителя до сбоя. Данные лежат за обычным HTTP-API с ключом проекта, поэтому подключается любой агент: Claude Code, Cursor, ваш собственный.

1. Подключите сайт

Заведите проект в панели и поставьте одну строку в <head> сайта — SDK начнёт писать ошибки, сетевые сбои и действия посетителей.

<script src="https://logsy.ru/api/logger/sdk" defer></script>

2. Возьмите ключ проекта

Ключ лежит в панели на вкладке «API». Положите его в переменную окружения — агент подхватит её из вашего окружения и не будет светить ключ в переписке.

export LOGSY_API_KEY="lg_…"
export LOGSY_URL="https://logsy.ru"

3. Дайте агенту адрес документации

Агенту достаточно одной ссылки: по ней он поймёт, какие есть методы и что они возвращают. Обвязку писать не нужно.

Документация: https://logsy.ru/llms.txt
OpenAPI: https://logsy.ru/api/v1/openapi.json

В Claude Code это выглядит как одна фраза в чате: «возьми ошибки за сегодня из Logsy — ключ в LOGSY_API_KEY, документация на logsy.ru/llms.txt».

Готовые запросы

Найти сессии с ошибками за сегодня, а потом развернуть проблемную целиком:

# сессии за сутки со счётчиками ошибок
curl -s -H "Authorization: Bearer $LOGSY_API_KEY" \
  "$LOGSY_URL/api/v1/sessions?date=$(date -u +%F)&limit=100" \
  | jq '.sessions[] | select(.events.errors > 0) | {id, startedAt, errors: .events.errors}'

# всё, что произошло в конкретной сессии
curl -s -H "Authorization: Bearer $LOGSY_API_KEY" \
  "$LOGSY_URL/api/v1/sessions/<id>" \
  | jq '.events[] | select(.type == "ERROR" or .type == "HTTP_ERROR")'

Что именно увидит агент

Ошибку с местом в коде

Сообщение и стектрейс: файл, строка, функция — сразу видно, куда смотреть.

Упавший запрос целиком

Метод, адрес, код ответа, время, тело запроса и ответа. Пароли маскируются на клиенте.

Шаги до сбоя

Переходы, клики и ввод перед ошибкой — готовые шаги воспроизведения.

Контекст посетителя

Браузер, устройство, страна, метки перехода — понятно, у кого именно ломается.

Про безопасность. Ключ проекта открывает доступ ко всем логам сайта. Держите его в переменной окружения, не коммитьте в репозиторий и не вставляйте в код, который выкатывается в браузер. Если ключ утёк — перевыпустите его в панели, старый перестанет работать сразу.

Подключить за пару минут

Бесплатный тариф навсегда: одна строка скрипта, ключ в панели — и агент видит прод глазами пользователя.

Подключить сайтДокументация API