Обзор

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

Поддерживает более 15 категорий команд: аутентификация, организации, проекты, проблемы, события, дашборды, репозитории, команды, логи, спаны, трассировки и вызовы API
Включает анализ проблем с помощью AI через sentry issue explain и sentry issue plan с использованием Seer AI
Предоставляет вывод в формате JSON для всех основных команд, что упрощает интеграцию со скриптами и инструментами
Обеспечивает гибкое определение проекта: автоматическое обнаружение из DSN, явные пути организация/проект или поиск по доступным организациям

Руководство по использованию Sentry CLI

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

Основное правило для agent'ов: просто выполняйте команду. CLI sentry автоматически определяет вашу организацию и проект (из .sentryclirc, DSN в .env/исходном коде и имени директории), поэтому не запрашивайте список организаций, а затем их проекты, чтобы определить, какому проекту соответствует текущая рабочая копия — эта ручная диагностика только дублирует работу, которую CLI уже выполняет при каждой команде. Указывайте явный /<org>/<project> только когда CLI сообщает, что не может обнаружить цель или определяет её неправильно.

Руководство для agent'ов

Лучшие практики и операционные рекомендации для AI-кодинг agent'ов, использующих Sentry CLI.

Ключевые принципы

Просто выполняйте команду — CLI автоматически обрабатывает аутентификацию и определение организации/проекта. Не выполняйте предварительную аутентификацию и не ищите организацию/проект перед запуском команд. CLI запросит вход в систему при необходимости.
Предпочитайте команды CLI прямым вызовам API — в CLI есть выделенные команды для большинства задач. Используйте sentry issue view, sentry issue list, sentry trace view и т.д. вместо ручного построения API-запросов или получения внешней документации.
Используйте sentry docs для вопросов настройки — если нужно узнать, как настроить SDK или функцию Sentry, выполните sentry docs "ваш вопрос" для прямого запроса документации. Это быстрее и точнее, чем получение документации извне.
Используйте sentry schema для изучения API — если нужно обнаружить API-эндпоинты, выполните sentry schema для интерактивного просмотра или sentry schema <resource> для поиска. Это быстрее, чем получение OpenAPI-спецификаций извне.
Используйте sentry issue view <id> для исследования проблем — когда задают вопрос о конкретной проблеме (например, CLI-G5, PROJECT-123), используйте sentry issue view напрямую.
Используйте --json для вывода, удобного для машин — передавайте через jq для фильтрации. Вывод для человека включает форматирование, которое сложно разбирать программно.
CLI автоматически определяет организацию/проект — не ищите это вручную — большинство команд работают без явных целей, проверяя конфигурационные файлы .sentryclirc, сканируя DSN в файлах .env и исходном коде, а также сопоставляя имена директорий. Не выполняйте sentry org list и затем sentry project list для определения принадлежности проекта — это ручное распределение просто дублирует обнаружение, которое CLI уже выполняет при каждой команде. Указывайте <org>/<project> только когда CLI сообщает, что не может обнаружить цель или обнаруживает её неправильно.

Принципы проектирования

CLI sentry следует конвенциям известных инструментов — если вы знакомы с ними, это знание напрямую применимо:

Конвенции gh (GitHub CLI): CLI sentry использует тот же паттерн команд <существительное> <глагол> (например, sentry issue list, sentry org view). Флаги следуют конвенциям gh: --json для вывода, удобного для машин, --fields для выбора конкретных полей, -w/--web для открытия в браузере, -q/--query для фильтрации, -n/--limit для ограничения количества результатов.
sentry api имитирует curl: Команда sentry api предоставляет прямой доступ к API с интерфейсом, похожим на curl — --method для HTTP-метода, --data для тела запроса, --header для пользовательских заголовков. Аутентификация обрабатывается автоматически. Если вы умее вызывать REST API с помощью curl, те же паттерны применяются здесь.

Советы по работе с контекстным окном

Используйте --json --fields для выбора конкретных полей и уменьшения размера вывода. Выполните <command> --help для просмотра доступных полей. Пример: sentry issue list --json --fields shortId,title,priority,level,status
Используйте --json при передаче вывода между командами или программной обработке
Используйте --limit для ограничения количества результатов (по умолчанию обычно 10–100)
Предпочитайте sentry issue view PROJECT-123 ручной фильтрации списка
Используйте sentry api для эндпоинтов, не покрытых выделенными командами

Правила безопасности

Всегда подтверждайте с пользователем перед запуском деструктивных команд: project delete, trial start
Для мутаций убедитесь, что контекст организации/проекта в выводе команды выглядит корректно, прежде чем вносить дальнейшие изменения
Никогда не сохраняйте и не записывайте токены аутентификации — CLI управляет учётными данными автоматически
Если CLI указал неправильную организацию/проект, переопределите, указав явные аргументы <org>/<project>

Коды завершения

CLI использует семантические коды завершения. Ключевые диапазоны для agent'ов:

Диапазон	Значение	Действие agent'а
0	Успех	Продолжайте как обычно
10–19	Ошибка аутентификации	Попросите пользователя выполнить sentry auth login
20–29	Ошибка ввода	Проверьте аргументы команды и повторите
30–39	Ошибка API	Повторите или сообщите пользователю
40–49	Функция недоступна	Сообщите пользователю о плане/настройках
50–59	Ошибка операции	Сообщите пользователю
60–69	Специфичная ошибка команды	Проверьте stderr для подробностей

См. Коды завершения для полной справки.

Рабочие паттерны

Исследование проблемы

1. Найти проблему (автоматически определяет организацию/проект из DSN или конфигурации)

sentry issue list --query "is:unresolved" --limit 5

2. Получить подробности. Для agent'ов предпочтительнее --json — он включает полную проблему плюс

последнее событие в `event`, так что вы получаете всё за один вызов.

sentry issue view PROJECT-123 --json

3. Получить анализ корневой причины с помощью AI

sentry issue explain PROJECT-123

4. Получить план исправления

sentry issue plan PROJECT-123


`<SHORT-ID> <SHORT-ID> --json` — самый быстрый способ ознакомить agent'а с проблемой.
Выбирайте только нужные поля с помощью `--fields` вместо загрузки всего полезного
нагрузки — запись `request` последнего события может содержать данные живой сессии
(cookies, заголовки, тело), поэтому извлекайте именованные поля, а не выводите весь объект:

```bash
# Верхнеуровневые поля проблемы
sentry issue view PROJECT-123 --json --fields shortId,title,culprit,count,userCount,permalink

# Именованные поля из последнего события — избегает загрузки полного blob'а request/session
sentry issue view PROJECT-123 --json --fields event.id,event.title,event.dateCreated

# Только URL и метод запроса (не вся запись request). Данные события

# находятся под event.entries[], каждая помечена `type` и payload `data`.
sentry issue view PROJECT-123 --json | jq '.event.entries[] | select(.type == "request") | .data | {url, method}'

Изучение трассировок и производительности

# 1. Список недавних трассировок (автоматически определяет организацию/проект)
sentry trace list --limit 5

# 2. Просмотр конкретной трассировки с деревом спанов
sentry trace view abc123def456...

# 3. Просмотр спанов трассировки
sentry span list abc123def456...

# 4. Просмотр логов, связанных с трассировкой
sentry trace logs abc123def456...

Стриминг логов

# Стриминг логов в реальном времени (автоматически определяет организацию/проект)
sentry log list --follow

# Фильтрация логов по уровню важности
sentry log list --query "severity:error"

Захват событий локально (Spotlight)

# Запустите приложение с автоматически включённым локальным сервером; отслеживайте ошибки/трассировки/логи.

# DSN не требуется — без DSN события уходят ТОЛЬКО на локальный сервер (ничего

# не достигает организации Sentry пользователя, квота продакшена не расходуется). Если DSN задан, то

# SDK отправляет в оба места.
sentry local run -- npm run dev          # или: python manage.py runserver и т.д.

# Из исходного кода CLI запустите локальный UI во втором терминале, затем откройте его.
pnpm --filter local dev
sentry local run --open -- npm run dev

# Отслеживайте только AI/agent (gen_ai, mcp) спаны при разработке agent'а.
sentry local -f ai

# Серверные SDK автоматически читают SENTRY_SPOTLIGHT. CLI также вставляет

# URL под каждым префиксом клиента фреймворка (NEXT_PUBLIC_, VITE_, PUBLIC_,

# NUXT_PUBLIC_, REACT_APP_, VUE_APP_, GATSBY_). Пока браузерный SDK не будет читать

# эти переменные автоматически (getsentry/sentry-javascript#18198), укажите переменную,

# соответствующую вашему фреймворку, в конфигурации клиента:

# Sentry.init({ spotlight: process.env.NEXT_PUBLIC_SENTRY_SPOTLIGHT ?? false })

Запрос документации Sentry

# Задать вопрос по документации
sentry docs "How do I configure tracing in Next.js?"

# Поиск по индексу документации
sentry docs list "source maps"

Проверка статуса сервисов Sentry

# Показать текущий статус сервисов Sentry
sentry status

# Статус в формате для машин
sentry status --json

Изучение схемы API

# Просмотр всех категорий ресурсов API
sentry schema

# Поиск эндпоинтов, связанных с ресурсом
sentry schema issues

# Получение подробностей о конкретном эндпоинте
sentry schema "GET /api/0/organizations/{organization_id_or_slug}/issues/"

Управление релизами

# Создать релиз — версия должна точно совпадать с Sentry.init({ release })
sentry release create my-org/1.0.0 --project my-project

# Привязать коммиты через интеграцию с репозиторием (требуется локальная git-рабочая копия)
sentry release set-commits my-org/1.0.0 --auto

# Или прочитать коммиты из локальной git-истории (интеграция не требуется)
sentry release set-commits my-org/1.0.0 --local

# Пометить релиз как завершённый
sentry release finalize my-org/1.0.0

# Записать деплой в продакшен
sentry release deploy my-org/1.0.0 production

Ключевые детали:

Позиционный аргумент — это <org-slug>/<version>. В sentry release create sentry/1.0.0, sentry — это организация, а 1.0.0 — версия — слэш разделяет организацию и версию, он не является частью строки версии.
Версия должна совпадать со значением release в Sentry.init(). Если ваш SDK использует "1.0.0", команда должна использовать org/1.0.0.
--auto требует интеграции Sentry с репозиторием (GitHub/GitLab/Bitbucket) и локальной git-рабочей копии. Он сопоставляет ваш origin remote со списком репозиториев Sentry. Без рабочей копии используйте --local.
Без флага set-commits сначала пытается --auto и при неудаче переходит на --local.

Произвольный доступ к API

# GET-запрос (по умолчанию)
sentry api /api/0/organizations/my-org/

# POST-запрос с данными
sentry api /api/0/organizations/my-org/projects/ --method POST --data '{"name":"new-project","platform":"python"}'

Макет дашборда

Дашборды Sentry используют сетку из 6 колонок. При добавлении виджетов старайтесь заполнять полные строки (ширины должны в сумме давать 6).

Типы отображения с размерами по умолчанию:

Тип отображения	Ширина	Высота	Категория	Примечания
big_number	2	1	common	Компактный KPI — размещайте 3 в строке (2+2+2=6)
line	3	2	common	График на половину ширины — размещайте 2 в строке (3+3=6)
area	3	2	common	График на половину ширины — размещайте 2 в строке
bar	3	2	common	График на половину ширины — размещайте 2 в строке
table	6	2	common	Полная ширина — всегда занимает собственную строку
stacked_area	3	2	specialized	График с накоплением областей
top_n	3	2	specialized	Рейтинговый список Top N
categorical_bar	3	2	specialized	Столбчатый график с категориями
text	3	2	specialized	Статический текстовый/markdown-виджет
details	3	2	internal	Детальное представление
wheel	3	2	internal	Круговая/кольцевая диаграмма
rage_and_dead_clicks	3	2	internal	Визуализация rage/dead click
server_tree	3	2	internal	Иерархическое дерево
agents_traces_table	3	2	internal	Таблица трассировок agent'ов

Используйте типы common для общих дашбордов. Используйте specialized только при явном запросе. Избегайте типов internal, если пользователь не просит об этом.

Доступные наборы данных: spans (по умолчанию), errors, metrics, issue, logs. Выполните sentry dashboard widget --help для описания наборов данных, форматов запросов и примеров.

Примеры заполнения строк:

# 3 KPI, заполняющих одну строку (2+2+2 = 6)
sentry dashboard widget add <dashboard> "Error Count" --display big_number --query count
sentry dashboard widget add <dashboard> "P95 Duration" --display big_number --query p95:span.duration
sentry dashboard widget add <dashboard> "Throughput" --display big_number --query epm

# 2 графика, заполняющих одну строку (3+3 = 6)
sentry dashboard widget add <dashboard> "Errors Over Time" --display line --query count
sentry dashboard widget add <dashboard> "Latency Over Time" --display line --query p95:span.duration

Полноширинная таблица (6 = 6)

sentry dashboard widget add <dashboard> "Top Endpoints" --display table
--query count --query p95:span.duration
--group-by transaction --sort -count --limit 10


### Краткая справка

#### Фильтрация по времени

Используйте `--period` (синоним: `-t`) для фильтрации по временному окну:

sentry trace list --period 1h sentry span list --period 24h sentry span list -t 7d


#### Ограничение области организации или проекта

Организация и проект — это позиционные аргументы, следующие за конвенциями `gh` CLI:

sentry trace list my-org/my-project sentry issue list my-org/my-project sentry span list my-org/my-project/abc123def456...


#### Список span'ов в trace

Передайте идентификатор trace как позиционный аргумент в `span list`:

sentry span list abc123def456... sentry span list my-org/my-project/abc123def456...


#### Имена наборов данных для Events API

При запросе к Events API (напрямую или через `sentry api`) допустимые значения dataset: `spans`, `logs`, `errors`, `tracemetrics`, `profile_functions` и `uptime_results`.

### Частые ошибки

- **Неверный формат ID issue**: Используйте `PROJECT-123` (короткий ID), а не числовой ID `123456789`. Короткий ID включает префикс проекта.

- **Ненужная предварительная аутентификация**: Не запускайте `sentry auth login` перед каждой командой. CLI автоматически обнаруживает отсутствующую или истёкшую аутентификацию и запрашивает её. Запускайте `sentry auth login` только если нужно переключиться на другой аккаунт.

- **Отсутствие `--json` при пайпинге**: Человекочитаемый вывод содержит форматирование. Используйте `--json` при программном разборе вывода.

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

- **Ручное обнаружение проекта перед запуском команды**: Не перечисляйте все организации, к которым принадлежите, затем не перечисляйте все проекты в каждой, чтобы сопоставить локальный checkout с проектом — CLI уже выполняет это разрешение автоматически при каждой команде. Пропустите «веерный» запрос и запускайте команду напрямую; исправьте цель после, только если вывод показывает неверную организацию/проект.

- **Путаница с синтаксисом `--query`**: Флаг `--query` использует поисковый синтаксис Sentry (например, `is:unresolved`, `assigned:me`), а не текстовый поиск.

- **Неиспользование `--web`**: Команды просмотра поддерживают `-w`/`--web` для открытия ресурса в браузере — полезно для отправки ссылок.

- **Получение API-схем вместо использования CLI**: Предпочитайте `sentry schema` для просмотра API и `sentry api` для выполнения запросов — CLI обрабатывает аутентификацию и разрешение endpoint'ов, поэтому редко требуется отдельно скачивать спецификации OpenAPI.

- **Получение документации Sentry извне**: Используйте `sentry docs "your question"` для запроса документации Sentry из CLI — это возвращает краткие ответы со ссылками на источники, без необходимости загружать или парсить страницы документации.

- **Несовпадение версии релиза**: Позиционный аргумент `org/version` — это `<org-slug>/<version>`, где `org/` — это организация, а не часть версии. `sentry release create sentry/1.0.0` создаёт версию `1.0.0` в организации `sentry`. Если ваш `Sentry.init()` использует `release: "1.0.0"`, это корректно. Не добавляйте двойной префикс, вроде `sentry/myapp/1.0.0`.

- **Запуск `set-commits --auto` без git-репозитория**: `--auto` требует локальный git-репозиторий для обнаружения origin URL и HEAD-коммита. В CI убедитесь, что `actions/checkout` с `fetch-depth: 0` выполняется до `set-commits --auto`.

- **Использование `sentry api`, когда достаточно CLI-команд**: `sentry issue list --json` и `sentry issue view --json` уже содержат `shortId`, `title`, `count`, `userCount`, `priority`, `level`, `status`, `permalink` и другие поля на верхнем уровне. При использовании `--fields` для выбора конкретных полей, таких как `count` или `userCount`, CLI автоматически обеспечивает наличие этих полей в ответе API. Используйте `--fields` для выбора конкретных полей и `--help` для просмотра всех доступных полей. Переходите к `sentry api` только для данных, которые CLI не предоставляет.

## Предварительные требования

Перед использованием CLI необходимо установить и аутентифицироваться.

### Установка

curl https://cli.sentry.dev/install -fsS | bash curl https://cli.sentry.dev/install -fsS | bash -s -- --version nightly

Или установить через npm/pnpm/bun

npm install -g sentry


### Аутентификация

sentry auth sentry auth --token YOUR_SENTRY_API_TOKEN sentry auth status sentry auth logout


## Справочник команд

### Auth

Аутентификация с Sentry

- `sentry auth login` — Аутентифицироваться с Sentry

- `sentry auth logout` — Выйти из Sentry

- `sentry auth refresh` — Обновить OAuth access token

- `sentry auth status` — Просмотреть статус аутентификации

- `sentry auth token` — Вывести сохранённый токен аутентификации

- `sentry auth whoami` — Показать текущую аутентифицированную личность

→ Полные флаги и примеры: `references/auth.md`

### Org

Работа с организациями Sentry

- `sentry org list` — Список организаций

- `sentry org view <org>` — Просмотр деталей организации

→ Полные флаги и примеры: `references/org.md`

### Project

Работа с проектами Sentry

- `sentry project create [<org>/]<name>:<platform>...` — Создать один или несколько проектов

- `sentry project delete <org/project>` — Удалить проект

- `sentry project list <org/project>` — Список проектов

- `sentry project view <org/project>` — Просмотр деталей проекта

→ Полные флаги и примеры: `references/project.md`

### Issue

Управление issue в Sentry

- `sentry issue list <org/project>` — Список issue в проекте

- `sentry issue events <issue>` — Список событий для конкретной issue

- `sentry issue explain <issue>` — Проанализировать корневую причину issue с помощью Seer AI

- `sentry issue plan <issue>` — Сгенерировать план решения с помощью Seer AI

- `sentry issue view <issue>` — Просмотр деталей конкретной issue

- `sentry issue resolve <issue>` — Отметить issue как решённую

- `sentry issue unresolve <issue>` — Переоткрыть решённую issue

- `sentry issue archive <issue>` — Архивировать (игнорировать) issue

- `sentry issue merge <issue...>` — Объединить 2+ issue в одну каноническую группу

→ Полные флаги и примеры: `references/issue.md`

### Event

Просмотр, список и отправка событий Sentry

- `sentry event view <org/project/event-id...>` — Просмотр деталей одного или нескольких событий

- `sentry event list <issue>` — Список событий для issue

- `sentry event send <args...>` — Отправить событие Sentry

→ Полные флаги и примеры: `references/event.md`

### API

Выполнить аутентифицированный API-запрос

- `sentry api <endpoint>` — Выполнить аутентифицированный API-запрос

→ Полные флаги и примеры: `references/api.md`

### Alert

Управление правилами оповещений Sentry

- `sentry alert issues list <org/project>` — Список правил оповещений по issue

- `sentry alert issues view <org/project/rule-id-or-name>` — Просмотр правила оповещения по issue

- `sentry alert issues create <target>` — Создать правило оповещения по issue

- `sentry alert issues delete <org/project/rule-id-or-name>` — Удалить правило оповещения по issue

- `sentry alert issues edit <org/project/rule-id-or-name>` — Редактировать правило оповещения по issue

- `sentry alert metrics list <target>` — Список правил оповещений по метрикам

- `sentry alert metrics view <org/rule-id-or-name>` — Просмотр правила оповещения по метрикам

- `sentry alert metrics create <org>` — Создать правило оповещения по метрикам

- `sentry alert metrics delete <org/rule-id-or-name>` — Удалить правило оповещения по метрикам

- `sentry alert metrics edit <org/rule-id-or-name>` — Редактировать правило оповещения по метрикам

→ Полные флаги и примеры: `references/alert.md`

### Build

Управление артефактами мобильных сборок

- `sentry build upload <path...>` — Загрузить сборки в проект

- `sentry build download <build-id>` — Скачать артефакт сборки

→ Полные флаги и примеры: `references/build.md`

### CLI

Команды, связанные с CLI

- `sentry cli completion <shell>` — Вывести скрипт автодополнения оболочки

- `sentry cli defaults <key value...>` — Просмотреть и управлять настройками по умолчанию

- `sentry cli feedback <message...>` — Отправить отзыв о CLI

- `sentry cli fix` — Диагностировать и восстановить проблемы с базой данных CLI

- `sentry cli import` — Импортировать настройки из устаревших файлов .sentryclirc

- `sentry cli setup` — Настроить интеграцию с оболочкой

- `sentry cli uninstall` — Удалить Sentry CLI

- `sentry cli upgrade <version>` — Обновить Sentry CLI до последней версии

→ Полные флаги и примеры: `references/cli.md`

### Code-mappings

Управление code mappings для связывания стек-трейсов

- `sentry code-mappings upload <path>` — Загрузить code mappings для связывания стек-трейсов

→ Полные флаги и примеры: `references/code-mappings.md`

### Agent-conversation

Список и просмотр разговоров agent

- `sentry agent-conversation list <org>` — Список недавних разговоров agent

- `sentry agent-conversation view <org/conversation-id>` — Просмотр стенограммы разговора agent

→ Полные флаги и примеры: `references/agent-conversation.md`

### Dart-symbol-map

Работа с Dart/Flutter symbol map

- `sentry dart-symbol-map upload <path>` — Загрузить Dart/Flutter symbol map в Sentry

→ Полные флаги и примеры: `references/dart-symbol-map.md`

### Debug-files

Работа с файлами отладочной информации

- `sentry debug-files check <path>` — Проверить файл отладочной информации

- `sentry debug-files find <id...>` — Найти отладочные файлы по заданным отладочным идентификаторам

- `sentry debug-files upload <path...>` — Загрузить файлы отладочной информации в Sentry

- `sentry debug-files print-sources <path>` — Список исходных файлов, на которые ссылается отладочный файл

- `sentry debug-files bundle-sources <path>` — Объединить исходные файлы отладочного файла в пакет для source context

- `sentry debug-files bundle-jvm <path>` — Создать JVM source bundle для source context

→ Полные флаги и примеры: `references/debug-files.md`

### Dashboard

Управление дашбордами Sentry

- `sentry dashboard list <org/title-filter...>` — Список дашбордов

- `sentry dashboard view <org/project/dashboard...>` — Просмотр дашборда

- `sentry dashboard create <org/project/title...>` — Создать дашборд

- `sentry dashboard widget add <org/project/dashboard/title...>` — Добавить виджет к дашборду

- `sentry dashboard widget edit <org/project/dashboard...>` — Редактировать виджет на дашборде

- `sentry dashboard widget delete <org/project/dashboard...>` — Удалить виджет с дашборда

- `sentry dashboard revisions <org/dashboard...>` — Список ревизий дашборда

- `sentry dashboard restore <org/dashboard...>` — Восстановить ревизию дашборда

→ Полные флаги и примеры: `references/dashboard.md`

### Docs

Поиск и запрос текущей документации Sentry

- `sentry docs list <keywords...>` — Найти страницы документации Sentry по ключевому слову

- `sentry docs query <question...>` — Задать вопрос о документации Sentry с указанием источника

→ Полные флаги и примеры: `references/docs.md`

### Platform

Список допустимых идентификаторов платформ Sentry

- `sentry platform list` — Список всех допустимых идентификаторов платформ Sentry

→ Полные флаги и примеры: `references/platform.md`

### Proguard

Работа с файлами отображений ProGuard/R8

- `sentry proguard upload <path...>` — Загрузить файлы отображений ProGuard/R8 в Sentry

- `sentry proguard uuid <path>` — Вычислить UUID для файла отображения ProGuard

→ Полные флаги и примеры: `references/proguard.md`

### React-native

Загрузка sourcemap React Native из шагов сборки

- `sentry react-native gradle` — Загрузить React Native bundle + sourcemap (шаг сборки Gradle)

- `sentry react-native xcode <script-arg...>` — Загрузить sourcemap React Native (шаг сборки Xcode)

→ Полные флаги и примеры: `references/react-native.md`

### Replay

Поиск и просмотр Session Replays

- `sentry replay list <org/project>` — Список недавних Session Replays

- `sentry replay view <replay-id-or-url...>` — Просмотр Session Replay

→ Полные флаги и примеры: `references/replay.md`

### Release

Работа с релизами Sentry

- `sentry release list <org/project>` — Список релизов с метриками adoption и health

- `sentry release view <org/version>` — Просмотр деталей релиза с метриками health

- `sentry release create <org/version>` — Создать релиз

- `sentry release finalize <org/version>` — Финализировать релиз

- `sentry release delete <org/version>` — Удалить релиз

- `sentry release archive <org/version>` — Архивировать релиз

- `sentry release restore <org/version>` — Восстановить заархивированный релиз

- `sentry release deploy <org/version> <environment> <name>` — Создать деплой для релиза

- `sentry release deploys <org/version>` — Список деплоев для релиза

- `sentry release set-commits <org/version>` — Установить коммиты для релиза

- `sentry release propose-version` — Предложить версию релиза

→ Полные флаги и примеры: `references/release.md`

### Repo

Работа с репозиториями Sentry

- `sentry repo list <org/project>` — Список репозиториев

→ Полные флаги и примеры: `references/repo.md`

### Team

Работа с командами Sentry

- `sentry team list <org/project>` — Список команд

→ Полные флаги и примеры: `references/team.md`

### Explore

Запрос агрегированных данных о событиях (Explore)

- `sentry explore <target>` — Запрос агрегированных данных о событиях (Explore)

→ Полные флаги и примеры: `references/explore.md`

### Feedback

Поиск и просмотр User Feedback

- `sentry feedback list <org/project>` — Список и поиск User Feedback

- `sentry feedback view <feedback>` — Просмотр элемента User Feedback

→ Полные флаги и примеры: `references/feedback.md`

### Log

Просмотр логов Sentry

- `sentry log list <org/project-or-trace-id...>` — Список логов из проекта

- `sentry log view <org/project/log-id...>` — Просмотр деталей одной или нескольких записей лога

→ Полные флаги и примеры: `references/log.md`

### Monitor

Работа с cron-мониторами Sentry

- `sentry monitor run <monitor-slug command...>` — Обернуть команду с cron-мониторингом check-ins

- `sentry monitor list <org/project>` — Список cron-мониторов

→ Полные флаги и примеры: `references/monitor.md`

### Snapshots

Управление и сравнение снимков

- `sentry snapshots diff <base-dir> <head-dir>` — Сравнить два каталога снимков изображений

- `sentry snapshots download` — Скачать базовые снимки изображений

- `sentry snapshots upload <path>` — Загрузить снимки в проект

→ Полные флаги и примеры: `references/snapshots.md`

### Sourcemap

Управление sourcemaps

- `sentry sourcemap inject <directory>` — Внедрить debug ID в JavaScript-файлы и sourcemaps

- `sentry sourcemap upload <directory>` — Загрузить sourcemaps в Sentry

- `sentry sourcemap resolve <directory>` — Разрешить и сообщить о связях sourcemaps для JavaScript-файлов

→ Полные флаги и примеры: `references/sourcemap.md`

### Span

Список и просмотр span в проектах или trace

- `sentry span list <org/project/trace-id...>` — Список span в проекте или trace

- `sentry span view <trace-id/span-id...>` — Просмотр деталей конкретных span

→ Полные флаги и примеры: `references/span.md`

### Status

Проверка статуса сервиса Sentry

- `sentry status show` — Показать статус сервиса Sentry

→ Полные флаги и примеры: `references/status.md`

### Trace

Просмотр распределённых трассировок

- `sentry trace list <org/project>` — Список недавних trace в проекте

- `sentry trace view <org/project/trace-id...>` — Просмотр деталей конкретной trace

- `sentry trace logs <org/project/trace-id...>` — Просмотр логов, связанных с trace

→ Полные флаги и примеры: `references/trace.md`

### Trial

Управление пробными периодами продукта

- `sentry trial list <org>` — Список пробных периодов продукта

- `sentry trial start <name> <org>` — Начать пробный период продукта

→ Полные флаги и примеры: `references/trial.md`

### Init

Инициализация Sentry в вашем проекте (экспериментально)

- `sentry init <target> <directory>` — Инициализировать Sentry в вашем проекте (экспериментально)

→ Полные флаги и примеры: `references/init.md`

### Info

Вывести конфигурацию и проверить аутентификацию

- `sentry info` — Вывести конфигурацию и проверить аутентификацию

→ Полные флаги и примеры: `references/info.md`

### Local

Sentry для локальной разработки

- `sentry local serve` — Запустить локальный dev-сервер и отслеживать события

- `sentry local run <command...>` — Выполнить команду с включённым локальным dev-сервером

→ Полные флаги и примеры: `references/local.md`

### Schema

Просмотр схемы API Sentry

- `sentry schema <resource...>` — Просмотр схемы API Sentry

→ Полные флаги и примеры: `references/schema.md`

## Глобальные опции

Все команды поддерживают следующие глобальные опции:

- `--help` - Показать справку по команде

- `--version` - Показать версию CLI

- `--log-level <level>` - Установить детализацию логов (`error`, `warn`, `log`, `info`, `debug`, `trace`). Переопределяет `SENTRY_LOG_LEVEL`

- `--verbose` - Сокращение для `--log-level debug`

## Форматы вывода

### JSON-вывод

Большинство команд списка и просмотра поддерживают флаг `--json` для JSON-вывода, что упрощает интеграцию с другими инструментами:

sentry org list --json | jq '.[] | .slug'


### Открытие в браузере

Команды просмотра поддерживают флаг `-w` или `--web` для открытия ресурса в браузере:

sentry issue view PROJ-123 -w