sentry-cli

Sentry CLI 使用ガイド

sentry` CLI を使用して、コマンドラインから Sentry を操作する方法を説明します。

エージェント向けの基本ルール：コマンドを実行するだけです。 sentry CLI は組織とプロジェクトを自動検出します（.sentryclirc、.env／ソース内の DSN、ディレクトリ名から検出します）。そのため、このチェックアウトがどのプロジェクトに対応するかを特定する目的で、組織を一覧表示してからプロジェクトを一覧表示しないでください。その手動での確認は、CLI がコマンドごとにすでに行っている処理を重複させるだけです。CLI が対象を検出できない、または誤った対象を選択したと報告した場合に限り、明示的に <org>/<project> を指定してください。

エージェント向けガイダンス

Sentry CLI を使用する AI コーディングエージェント向けのベストプラクティスと運用ガイダンスです。

主な原則

• コマンドを実行するだけです — CLI は認証と組織／プロジェクトの検出を自動的に処理します。コマンドを実行する前に、事前認証や組織／プロジェクトの確認を行わないでください。必要な場合は、CLI がログインを求めます。
• 生の API 呼び出しより CLI コマンドを優先してください — CLI には、ほとんどのタスクに対応する専用コマンドがあります。API 呼び出しを手動で組み立てたり、外部のドキュメントを取得したりする前に、sentry issue view、sentry issue list、sentry trace view などを使用してください。
• セットアップに関する質問には sentry docs を使用してください — Sentry SDK や機能の設定方法を確認する必要がある場合は、sentry docs "your question" を実行して、ドキュメントを直接検索してください。これは外部からドキュメントを取得するより速く、正確です。
• API の調査には sentry schema を使用してください — API エンドポイントを調べる必要がある場合は、sentry schema を実行して対話形式で参照するか、sentry schema <resource> を実行して検索してください。外部から OpenAPI 仕様を取得するより速く済みます。
• 問題の調査には sentry issue view <id> を使用してください — 特定の問題（例：CLI-G5、PROJECT-123）について尋ねられた場合は、sentry issue view を直接使用してください。
• 機械可読な出力には --json を使用してください — 絞り込みには jq をパイプでつないでください。人間向けの出力には、解析が難しい書式が含まれます。
• CLI は組織／プロジェクトを自動検出します。自分で検出しないでください — 多くのコマンドは、.sentryclirc 設定ファイルの確認、.env ファイルとソースコード内の DSN の検索、ディレクトリ名との照合によって、対象を明示しなくても動作します。このチェックアウトがどのプロジェクトに属するかを特定するために、sentry org list を実行してから sentry project list を実行しないでください。このように手動で一覧をたどる方法は、CLI が各コマンドの実行時にすでに行っている検出を繰り返すだけです。CLI が対象を検出できない、または誤った対象を検出したと報告した場合に限り、<org>/<project> を指定してください。

設計原則

sentry` CLI は、広く知られているツールの慣習に従っています。これらに慣れていれば、その知識をそのまま活用できます。

• gh（GitHub CLI）の慣習：sentry CLI は同じ <noun> <verb> 形式のコマンドパターンを使用します（例：sentry issue list、sentry org view）。フラグも gh の慣習に従います。機械可読な出力には --json、特定のフィールドの選択には --fields、ブラウザーで開くには -w／--web、絞り込みには -q／--query、結果数の指定には -n／--limit を使用します。
• sentry api は curl を模倣します：sentry api コマンドは、curl のようなインターフェースで API に直接アクセスできます。HTTP メソッドには --method、リクエスト本文には --data、カスタムヘッダーには --header を使用します。認証は自動的に処理されます。curl で REST API を呼び出す方法を知っていれば、同じパターンを使用できます。

コンテキストウィンドウに関するヒント

• --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 はセマンティックな終了コードを使用します。エージェント向けの主な範囲は次のとおりです。

範囲	意味	エージェントの対応
0	成功	通常どおり続行
10–19	認証エラー	sentry auth login を実行するようユーザーに促す
20–29	入力エラー	コマンドの引数を確認して再試行
30–39	API エラー	再試行するか、ユーザーに報告
40–49	機能を利用できない	プラン／設定についてユーザーに知らせる
50–59	操作エラー	ユーザーに報告
60–69	コマンド固有	詳細を stderr で確認

完全なリファレンスについては、終了コードを参照してください。

ワークフローパターン

Issue を調査する

# 1. Find the issue (auto-detects org/project from DSN or config)
sentry issue list --query "is:unresolved" --limit 5

# 2. Get details. For agents, prefer --json — it includes the full issue plus
# the latest event under `event`, so you get everything in one call.
sentry issue view PROJECT-123 --json

# 3. Get AI root cause analysis
sentry issue explain PROJECT-123

# 4. Get a fix plan
sentry issue plan PROJECT-123

sentry issue view <SHORT-ID> --json は、エージェントが Issue の状況をすばやく把握するのに最適な方法です。ペイロード全体を取得するのではなく、--fields で必要なフィールドだけを選択してください。最新イベントの request エントリには、ライブセッションのデータ（Cookie、ヘッダー、本文）が含まれることがあるため、オブジェクト全体を出力せず、名前を指定してフィールドを抽出してください。

# Top-level issue fields
sentry issue view PROJECT-123 --json --fields shortId,title,culprit,count,userCount,permalink

# Named fields from the latest event — avoids pulling the full request/session blob
sentry issue view PROJECT-123 --json --fields event.id,event.title,event.dateCreated

# Just the request URL and method (not the whole request entry). Event data
# lives under event.entries[], each tagged with a `type` and `data` payload.
sentry issue view PROJECT-123 --json | jq '.event.entries[] | select(.type == "request") | .data | {url, method}'

トレースとパフォーマンスを調査する

# 1. List recent traces (auto-detects org/project)
sentry trace list --limit 5

# 2. View a specific trace with span tree
sentry trace view abc123def456...

# 3. View spans for a trace
sentry span list abc123def456...

# 4. View logs associated with a trace
sentry trace logs abc123def456...

ログをストリーミングする

# Stream logs in real-time (auto-detects org/project)
sentry log list --follow

# Filter logs by severity
sentry log list --query "severity:error"

イベントをローカルでキャプチャする（Spotlight）

# Run the app with the local server auto-enabled; tail errors/traces/logs.
# No DSN needed — with no DSN, events go ONLY to the local server (nothing
# reaches the user's Sentry org, no production quota). With a DSN set, the
# SDK sends to both.
sentry local run -- npm run dev          # or: python manage.py runserver, etc.

# From a CLI source checkout, run the Local UI in a second terminal, then open it.
pnpm --filter local dev
sentry local run --open -- npm run dev

# Watch only AI/agent (gen_ai, mcp) spans while iterating on an agent.
sentry local -f ai

# Server-side SDKs read SENTRY_SPOTLIGHT automatically. The CLI also injects
# the URL under every framework client prefix (NEXT_PUBLIC_, VITE_, PUBLIC_,
# NUXT_PUBLIC_, REACT_APP_, VUE_APP_, GATSBY_). Until the browser SDK reads
# these automatically (getsentry/sentry-javascript#18198), reference the var
# matching your framework in the client config:
# Sentry.init({ spotlight: process.env.NEXT_PUBLIC_SENTRY_SPOTLIGHT ?? false })

Sentry のドキュメントを検索する

# Ask a documentation question
sentry docs "How do I configure tracing in Next.js?"

# Search the documentation index
sentry docs list "source maps"

Sentry サービスのステータスを確認する

# Show current status of Sentry services
sentry status

# Machine-readable status
sentry status --json

API スキーマを調査する

# Browse all API resource categories
sentry schema

# Search for endpoints related to a resource
sentry schema issues

# Get details about a specific endpoint
sentry schema "GET /api/0/organizations/{organization_id_or_slug}/issues/"

リリースを管理する

# Create a release — version must match Sentry.init({ release }) exactly
sentry release create my-org/1.0.0 --project my-project

# Associate commits via repository integration (needs local git checkout)
sentry release set-commits my-org/1.0.0 --auto

# Or read commits from local git history (no integration needed)
sentry release set-commits my-org/1.0.0 --local

# Mark the release as finalized
sentry release finalize my-org/1.0.0

# Record a production deploy
sentry release deploy my-org/1.0.0 production

重要な詳細：

• 位置引数は <org-slug>/<version> です。sentry release create sentry/1.0.0 では、sentry が組織、1.0.0 がバージョンです。スラッシュは組織とバージョンを区切るものであり、バージョン文字列の一部ではありません。
• バージョンは Sentry.init() の release 値と一致している必要があります。SDK で "1.0.0" を使用している場合、コマンドでは org/1.0.0 を指定する必要があります。
• --auto を使用するには、Sentry のリポジトリ連携（GitHub/GitLab/Bitbucket）とローカルの git チェックアウトが必要です。origin リモートを Sentry のリポジトリ一覧と照合します。チェックアウトがない場合は、--local を使用してください。
• フラグを指定しない場合、set-commits はまず --auto を試し、失敗すると --local にフォールバックします。

任意の API にアクセスする

# GET request (default)
sentry api /api/0/organizations/my-org/

# POST request with data
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 — 1 行に 3 つ配置（2+2+2=6）
line	3	2	common	半幅のチャート — 1 行に 2 つ配置（3+3=6）
area	3	2	common	半幅のチャート — 1 行に 2 つ配置
bar	3	2	common	半幅のチャート — 1 行に 2 つ配置
table	6	2	common	全幅 — 常に単独で 1 行を使用
stacked_area	3	2	specialized	積み上げエリアチャート
top_n	3	2	specialized	上位 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 Click／Dead Click の可視化
server_tree	3	2	internal	階層ツリー表示
agents_traces_table	3	2	internal	エージェントのトレーステーブル

一般的なダッシュボードには common タイプを使用してください。specialized は明示的に依頼された場合にのみ使用してください。ユーザーから明示的に求められない限り、internal タイプは避けてください。

利用可能なデータセット：spans（デフォルト）、errors、metrics、issue、logs。データセットの説明、クエリ形式、例については、sentry dashboard widget --help を実行してください。

行を埋める例：

# 3 KPIs filling one row (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 charts filling one row (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

# Full-width table (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...

トレース内のスパンの一覧表示

トレース ID を span list の位置引数として渡します。

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

Events API のデータセット名

Events API に（直接、または sentry api 経由で）クエリを送信する場合、有効なデータセット値は spans、logs、errors、tracemetrics、profile_functions、uptime_results です。

よくある間違い

• Issue ID の形式が間違っている：数値 ID 123456789 ではなく、PROJECT-123（短縮 ID）を使用します。短縮 ID にはプロジェクトのプレフィックスが含まれます。
• 不要な事前認証：すべてのコマンドの前に sentry auth login を実行する必要はありません。CLI は認証がない場合や期限切れの場合に自動的に検出し、プロンプトを表示します。アカウントを切り替える必要がある場合にのみ、sentry auth login を実行します。
• パイプ処理時に --json を指定していない：人間が読みやすい形式の出力には書式設定が含まれます。出力をプログラムで解析する場合は、--json を使用します。
• 不要な場合に組織やプロジェクトを指定する：.sentryclirc 設定ファイル、DSN、環境変数、ディレクトリ名から、組織やプロジェクトが自動検出されます。まずは自動検出に任せ、CLI が対象を検出できない、または誤った対象を検出したと示した場合にのみ <org>/<project> を追加します。
• コマンド実行前にプロジェクトを手動で探す：所属する組織を一覧表示し、それぞれの組織の全プロジェクトを一覧表示して、ローカルのチェックアウトに一致するプロジェクトを探す必要はありません。CLI は各コマンドの実行時に、すでに同じ解決処理を内部で行っています。候補を一つずつ調べる手順は省略して、コマンドを直接実行します。出力に誤った組織やプロジェクトが表示された場合にのみ、対象を修正します。
• --query の構文を誤解している：--query フラグでは、自由入力のテキスト検索ではなく、Sentry の検索構文（例：is:unresolved、assigned:me）を使用します。
• --web を使用していない：表示コマンドでは -w／--web を指定して、リソースをブラウザーで開けます。リンクを共有する場合に便利です。
• CLI を使わずに API スキーマを取得する：API の参照には sentry schema、リクエストの送信には sentry api を優先して使用します。CLI が認証とエンドポイントの解決を処理するため、OpenAPI 仕様を別途ダウンロードする必要はほとんどありません。
• Sentry のドキュメントを外部から取得する：sentry docs "your question" を使用すると、CLI から Sentry のドキュメントを検索できます。ドキュメントページを取得したり解析したりしなくても、ソースリンク付きの簡潔な回答が返されます。
• リリースバージョンの不一致：位置引数 org/version は <org-slug>/<version> です。org/ は組織であり、バージョンの一部ではありません。sentry release create sentry/1.0.0 は、組織 sentry にバージョン 1.0.0 を作成します。Sentry.init() で release: "1.0.0" を使用している場合、これは正しい指定です。sentry/myapp/1.0.0 のようにプレフィックスを二重に付けないでください。
• Git チェックアウトがない状態で set-commits --auto を実行する：--auto では、origin のリモート URL と HEAD コミットを検出するために、ローカルの Git リポジトリが必要です。CI では、set-commits --auto の前に actions/checkout を fetch-depth: 0 で実行してください。
• CLI コマンドで十分な場合に sentry api を使用する：sentry issue list --json と sentry issue view --json には、shortId、title、count、userCount、priority、level、status、permalink などのフィールドがトップレベルに含まれています。--fields で count や userCount などのフィールドを選択すると、CLI は API レスポンスにこれらのフィールドが含まれるよう自動的に処理します。特定のフィールドを選択するには --fields を使用し、利用可能なすべてのフィールドを確認するには --help を使用します。CLI で公開されていないデータに限り、sentry api を使用します。

前提条件

CLI は、使用する前にインストールして認証する必要があります。

インストール

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

# Or install via npm/pnpm/bun
npm install -g sentry

認証

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

コマンドリファレンス

認証

Sentry で認証します

• sentry auth login — Sentry で認証します
• sentry auth logout — Sentry からログアウトします
• sentry auth refresh — OAuth アクセストークンを更新します
• sentry auth status — 認証状態を表示します
• sentry auth token — 保存されている認証トークンを出力します
• sentry auth whoami — 現在認証されている ID を表示します

→ フラグと使用例の詳細：references/auth.md

組織

Sentry の組織を操作します

• sentry org list — 組織の一覧を表示します
• sentry org view <org> — 組織の詳細を表示します

→ フラグと使用例の詳細：references/org.md

プロジェクト

Sentry のプロジェクトを操作します

• sentry project create [<org>/]<name>:<platform>... — 1 つ以上のプロジェクトを作成します
• sentry project delete <org/project> — プロジェクトを削除します
• sentry project list <org/project> — プロジェクトの一覧を表示します
• sentry project view <org/project> — プロジェクトの詳細を表示します

→ フラグと使用例の詳細：references/project.md

イシュー

Sentry のイシューを管理します

• sentry issue list <org/project> — プロジェクト内のイシューの一覧を表示します
• sentry issue events <issue> — 特定のイシューのイベント一覧を表示します
• sentry issue explain <issue> — Seer AI を使ってイシューの根本原因を分析します
• sentry issue plan <issue> — Seer AI を使って解決計画を生成します
• sentry issue view <issue> — 特定のイシューの詳細を表示します
• sentry issue resolve <issue> — イシューを解決済みとしてマークします
• sentry issue unresolve <issue> — 解決済みのイシューを再開します
• sentry issue archive <issue> — イシューをアーカイブ（無視）します
• sentry issue merge <issue...> — 2 件以上のイシューを 1 つの正規グループに統合します

→ フラグと使用例の詳細：references/issue.md

イベント

Sentry のイベントを表示、一覧表示、送信します

• sentry event view <org/project/event-id...> — 1 件以上のイベントの詳細を表示します
• sentry event list <issue> — イシューのイベント一覧を表示します
• sentry event send <args...> — Sentry イベントを送信します

→ フラグと使用例の詳細：references/event.md

API

認証済みの API リクエストを実行します

• sentry api <endpoint> — 認証済みの API リクエストを実行します

→ フラグと使用例の詳細：references/api.md

アラート

Sentry のアラートルールを管理します

• sentry alert issues list <org/project> — イシューアラートルールの一覧を表示します
• sentry alert issues view <org/project/rule-id-or-name> — イシューアラートルールを表示します
• sentry alert issues create <target> — イシューアラートルールを作成します
• sentry alert issues delete <org/project/rule-id-or-name> — イシューアラートルールを削除します
• sentry alert issues edit <org/project/rule-id-or-name> — イシューアラートルールを編集します
• 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

ビルド

モバイルビルドのアーティファクトを管理します

• 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

スタックトレースのリンク用コードマッピングを管理します

• sentry code-mappings upload <path> — スタックトレースのリンク用コードマッピングをアップロードします

→ フラグと使用例の詳細：references/code-mappings.md

Agent-conversation

エージェントの会話を一覧表示して確認します

• sentry agent-conversation list <org> — 最近のエージェントの会話を一覧表示します
• sentry agent-conversation view <org/conversation-id> — エージェントの会話のトランスクリプトを表示します

→ フラグと使用例の詳細：references/agent-conversation.md

Dart-symbol-map

Dart/Flutter のシンボルマップを操作します

• sentry dart-symbol-map upload <path> — Dart/Flutter のシンボルマップを 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> — ソースコンテキスト用にデバッグファイルのソースファイルをバンドルします
• sentry debug-files bundle-jvm <path> — ソースコンテキスト用の JVM ソースバンドルを作成します

→ フラグと使用例の詳細：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> — ProGuard のマッピングファイルの UUID を計算します

→ フラグと使用例の詳細：references/proguard.md

React-native

ビルド手順から React Native のソースマップをアップロードします

• sentry react-native gradle — React Native のバンドルとソースマップをアップロードします（Gradle のビルド手順）
• sentry react-native xcode <script-arg...> — React Native のソースマップをアップロードします（Xcode のビルド手順）

→ フラグと使用例の詳細：references/react-native.md

Replay

セッションリプレイを検索して調査します

• sentry replay list <org/project> — 最近のセッションリプレイを一覧表示します
• sentry replay view <replay-id-or-url...> — セッションリプレイを表示します

→ フラグと使用例の詳細：references/replay.md

リリース

Sentry のリリースを操作します

• sentry release list <org/project> — 採用状況と健全性の指標を含むリリース一覧を表示します
• sentry release view <org/version> — 健全性の指標を含むリリースの詳細を表示します
• 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

リポジトリ

Sentry のリポジトリを操作します

• sentry repo list <org/project> — リポジトリ一覧を表示します

→ すべてのフラグと例：references/repo.md

チーム

Sentry のチームを操作します

• sentry team list <org/project> — チーム一覧を表示します

→ すべてのフラグと例：references/team.md

Explore

イベントデータの集計をクエリします（Explore）

• sentry explore <target> — イベントデータの集計をクエリします（Explore）

→ すべてのフラグと例：references/explore.md

フィードバック

ユーザーフィードバックを検索、確認します

• sentry feedback list <org/project> — ユーザーフィードバックの一覧表示と検索を行います
• sentry feedback view <feedback> — ユーザーフィードバック項目を表示します

→ すべてのフラグと例：references/feedback.md

ログ

Sentry のログを表示します

• sentry log list <org/project-or-trace-id...> — プロジェクトのログ一覧を表示します
• sentry log view <org/project/log-id...> — 1 件以上のログエントリの詳細を表示します

→ すべてのフラグと例：references/log.md

モニター

Sentry の cron モニターを操作します

• sentry monitor run <monitor-slug command...> — cron モニターのチェックインでコマンドをラップします
• sentry monitor list <org/project> — cron モニター一覧を表示します

→ すべてのフラグと例：references/monitor.md

スナップショット

スナップショットを管理、比較します

• sentry snapshots diff <base-dir> <head-dir> — スナップショット画像を含む 2 つのディレクトリを比較します
• sentry snapshots download — ベースラインのスナップショット画像をダウンロードします
• sentry snapshots upload <path> — スナップショットをプロジェクトにアップロードします

→ すべてのフラグと例：references/snapshots.md

ソースマップ

ソースマップを管理します

• sentry sourcemap inject <directory> — JavaScript ファイルとソースマップにデバッグ ID を挿入します
• sentry sourcemap upload <directory> — ソースマップを Sentry にアップロードします
• sentry sourcemap resolve <directory> — JavaScript ファイルのソースマップとの関連付けを解決して報告します

→ すべてのフラグと例：references/sourcemap.md

スパン

プロジェクトまたはトレースのスパンを一覧表示、確認します

• sentry span list <org/project/trace-id...> — プロジェクトまたはトレースのスパン一覧を表示します
• sentry span view <trace-id/span-id...> — 指定したスパンの詳細を表示します

→ すべてのフラグと例：references/span.md

ステータス

Sentry サービスのステータスを確認します

• sentry status show — Sentry サービスのステータスを表示します

→ すべてのフラグと例：references/status.md

トレース

分散トレースを表示します

• sentry trace list <org/project> — プロジェクトの最近のトレース一覧を表示します
• sentry trace view <org/project/trace-id...> — 指定したトレースの詳細を表示します
• sentry trace logs <org/project/trace-id...> — トレースに関連付けられたログを表示します

→ すべてのフラグと例：references/trace.md

トライアル

製品トライアルを管理します

• sentry trial list <org> — 製品トライアル一覧を表示します
• sentry trial start <name> <org> — 製品トライアルを開始します

→ すべてのフラグと例：references/trial.md

初期化

プロジェクトで Sentry を初期化します（実験的機能）

• sentry init <target> <directory> — プロジェクトで Sentry を初期化します（実験的機能）

→ すべてのフラグと例：references/init.md

情報

設定を表示し、認証を確認します

• sentry info — 設定を表示し、認証を確認します

→ フラグと使用例の詳細：references/info.md

ローカル

ローカル開発向けの Sentry

• sentry local serve — ローカル開発サーバーを起動し、イベントをリアルタイムで表示します
• sentry local run <command...> — ローカル開発サーバーを有効にしてコマンドを実行します

→ フラグと使用例の詳細：references/local.md

スキーマ

Sentry API スキーマを参照します

• sentry schema <resource...> — Sentry API スキーマを参照します

→ フラグと使用例の詳細：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