API VEGA

Summary

Командная строка для запроса и управления проблемами Sentry, проектами, организациями и распределенными трассами.

  • Поддерживает более 15 категорий команд: аутентификация, организации, проекты, проблемы, события, панели мониторинга, репозитории, команды, логи, отрезки, трассы и вызовы API

  • Включает анализ проблем с использованием ИИ через sentry issue explain и sentry issue plan с использованием Seer AI

  • Предлагает вывод JSON для всех основных команд, обеспечивая простую интеграцию с скриптами и инструментами

  • Обеспечивает гибкую настройку целевого проекта: авто-распознавание из DSN, явные пути org/project, или поиск по доступным организациям

Sentry CLI Usage Guide

Помогает пользователям взаимодействовать с Sentry через командную строку с использованием sentry CLI.

Agent Guidance

Best practices and operational guidance for AI coding agents using the Sentry CLI.

Key Principles

  • Просто запустите команду — CLI автоматически обрабатывает аутентификацию и обнаружение org/project. Не выполняйте предварительную аутентификацию или поиск org/project до выполнения команд. Если аутентификация требуется, CLI запрашивает интерактивно.

  • Предпочитайте команды CLI вместо сырых вызовов API — CLI имеет специальные команды для большинства задач. Обращайтесь к sentry issue view, sentry issue list, sentry trace view и т. п. перед тем как вручную формировать вызовы API или запрашивать внешнюю документацию.

  • Используйте sentry schema для исследования API — если вам нужно обнаружить конечные точки API, запустите sentry schema для интерактивного просмотра или sentry schema <resource> для поиска. Это быстрее, чем внешняя загрузка спецификаций OpenAPI.

  • Используйте sentry issue view <id> для исследования проблем — когда спрашивают о конкретной проблеме (например, CLI-G5, PROJECT-123), используйте sentry issue view напрямую.

  • Используйте --json для машинно-читаемого вывода — перенаправляйте через jq для фильтрации. Человеко-читаемый вывод включает форматирование, которое трудно разобрать.

  • CLI автоматически определяет org/project — большинство команд работают без явных целей, проверяя файлы конфигурации .sentryclirc, сканируя DSN в .env файлах и исходном коде, и сопоставляя имена каталогов. Указывайте <org>/<project> только тогда, когда CLI сообщает, что не может определить цель или определяет неверную.

Design Principles