sentry-cli について
sentry-cliは、コーディングエージェントが`sentry`コマンドラインからSentryを操作するためのガイドスキルです。Issueやトレースの調査、ドキュメントとAPIスキーマの検索に加え、対象の自動判定や破壊的操作の確認手順を説明します。
主な機能
- 01Sentryコマンドラインの操作ガイド
- 02組織とプロジェクトの自動判定
- 03Issueとトレースの調査手順
- 04JSON出力とフィールド選択
- 05破壊的操作の安全ガイド
活用シーン
- 01特定のSentry Issueを確認
- 02トレースとパフォーマンスデータを調査
- 03SentryドキュメントやAPIスキーマを検索
- 04ログとサービス状態を確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ sentry/ dev --skill sentry-cliインストール後、Claude Code で/sentry-cliを入力して読み込まれたか確認します。
詳細
Sentry CLI 使用ガイド
sentry CLI を使用して、コマンドラインから Sentry を操作します。
エージェント向けの基本ルール:コマンドを実行するだけです。
sentryCLI は組織とプロジェクトを自動検出します(.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を使用します — 特定の問題(例:CLI-G5、PROJECT-123)について尋ねられた場合は、sentry issue viewを直接使用してください。複数の ID を1回の呼び出しで渡せます。sentry issue view A B C --jsonは、同じオブジェクトの配列を返します。 - 機械可読な出力には
--jsonを使用します — 絞り込みにはjqを介してください。人間向けの出力には解析しにくい書式が含まれます。 - CLI は組織/プロジェクトを自動検出します。自分で調べないでください — ほとんどのコマンドは、
.sentryclirc設定ファイルの確認、.envファイルやソースコード内の DSN の検索、ディレクトリ名との照合によって、対象を明示しなくても動作します。このチェックアウトがどのプロジェクトに属するかを調べるために、sentry org listを実行してからsentry project listを実行しないでください。その手動での一連の調査は、CLI が各コマンドの実行時にすでに行っている検出処理を繰り返すだけです。CLI から対象を検出できない、または誤った対象を検出したと報告された場合に限り、<org>/<project>を指定してください。
設計原則
sentry CLI は、広く知られたツールの規約に従っています。それらのツールに慣れていれば、その知識をそのまま活用できます。
gh(GitHub CLI)の規約:sentryCLI は、同じ<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を優先します - ID ごとに
issue viewを繰り返すのではなく、1 回の呼び出しで複数の課題 ID を渡します(sentry issue view A B C --json) - ID ごとに
issue explainを繰り返すのではなく、1 回の呼び出しで複数の課題を分析します(sentry issue explain A B C --json) - 専用コマンドで対応していないエンドポイントには
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 を確認 |
全項目については、終了コードを参照してください。
ワークフローのパターン
課題を調査する
# 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 は、エージェントが課題の状況を素早く把握するための最短の方法です。ペイロード全体を取得するのではなく、--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にフォールバックします。
エージェントの会話を表示する
# List recent agent conversations (org auto-detected)
sentry agent-conversation list
# Explicit org, last 24 hours
sentry agent-conversation list my-org --period 24h
# View a conversation transcript
sentry agent-conversation view my-org/conv-123
# JSON output for programmatic access
sentry agent-conversation view conv-123 --json
WebAssembly モジュールを処理する
# Add a build id to a wasm module (no auth required)
sentry wasm-split app.wasm
# Capture the build id for a later debug-files upload
BUILD_ID=$(sentry wasm-split app.wasm)
# Split debug data into a companion and strip the shipped binary
sentry wasm-split app.wasm --debug-out app.debug.wasm --strip
任意の 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 | 怒りクリック/デッドクリックの可視化 |
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を使用してください。 - 不要な場合に org/project を指定している:自動検出では、
.sentryclirc設定ファイル、DSN、環境変数、ディレクトリ名から org/project を解決します。まずは自動検出に任せてください。CLI が対象を検出できない、または誤った対象を検出したと伝えた場合にのみ、<org>/<project>を追加してください。 - コマンド実行前にプロジェクトを手動で特定している:所属する org の一覧を表示し、それぞれの org についてすべてのプロジェクトを一覧表示して、ローカルのチェックアウトに対応するプロジェクトを探す必要はありません。CLI は各コマンドの実行時に、内部でまったく同じ解決処理を行います。こうした手間を省いてコマンドを直接実行し、出力に誤った org/project が表示された場合にのみ、後から対象を修正してください。
--queryの構文を誤解している:--queryフラグでは、自由形式のテキスト検索ではなく、Sentry の検索構文(例:is:unresolved、assigned:me)を使用します。--webを使用していない:表示コマンドでは-w/--webを指定すると、ブラウザーでリソースを開けます。リンクの共有に便利です。- CLI を使わずに API スキーマを取得している:API の確認には
sentry schemaを、リクエストの実行にはsentry apiを使用してください。CLI が認証とエンドポイントの解決を処理するため、OpenAPI 仕様を別途ダウンロードする必要はほとんどありません。 - Sentry のドキュメントを外部から取得している:CLI から Sentry のドキュメントを検索するには、
sentry docs "your question"を使用してください。ドキュメントページを取得したり解析したりする必要なく、ソースへのリンク付きで簡潔な回答が返されます。 - リリースバージョンの指定が間違っている:位置引数の
org/versionは<org-slug>/<version>です。org/は org であり、バージョンの一部ではありません。sentry release create sentry/1.0.0は、orgsentryにバージョン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より前にfetch-depth: 0を指定したactions/checkoutが実行されるようにしてください。 - CLI コマンドで十分な場合に
sentry apiを使用している:sentry issue list --jsonとsentry issue view --jsonには、shortId、title、count、userCount、priority、level、status、permalinkなどのフィールドがすでにトップレベルに含まれています。countやuserCountなど特定のフィールドを選択するために--fieldsを使用すると、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— 現在認証されているユーザーを表示します
→ フラグと使用例の詳細:references/auth.md
Org
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
Issue
Sentry の Issue を管理します
sentry issue list <org/project>— プロジェクト内の Issue の一覧を表示しますsentry issue events <issue>— 特定の Issue のイベント一覧を表示しますsentry issue explain <issue...>— Seer AI を使って 1 つ以上の Issue を分析しますsentry issue plan <issue>— Seer AI を使って解決策を生成しますsentry issue view <issue...>— 1 つ以上の Issue の詳細を表示しますsentry issue resolve <issue>— Issue を解決済みとしてマークしますsentry issue unresolve <issue>— 解決済みの Issue を再オープンしますsentry issue archive <issue>— Issue をアーカイブします(無視します)sentry issue merge <issue...>— 2 つ以上の Issue を 1 つの正規グループに統合します
→ フラグと使用例の詳細:references/issue.md
イベント
Sentry イベントを表示、一覧表示、送信します
sentry event view <org/project/event-id...>— 1 つ以上のイベントの詳細を表示しますsentry event list <issue>— Issue のイベント一覧を表示しますsentry event send <target-or-file...>— Sentry イベントを送信します
→ フラグと使用例の詳細:references/event.md
API
認証済み API リクエストを実行します
sentry api <endpoint>— 認証済み API リクエストを実行します
→ フラグと使用例の詳細:references/api.md
アラート
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 <target>— メトリックアラートルールを作成します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
コードマッピング
スタックトレースとのリンクに使用するコードマッピングを管理します
sentry code-mappings upload <path>— スタックトレースとのリンクに使用するコードマッピングをアップロードします
→ フラグと使用例の詳細:references/code-mappings.md
エージェント会話
エージェントとの会話を一覧表示、閲覧します
sentry agent-conversation list <org>— 最近のエージェントとの会話を一覧表示しますsentry agent-conversation view <org/conversation-id>— エージェントとの会話のトランスクリプトを表示します
→ フラグと使用例の詳細:references/agent-conversation.md
Dart シンボルマップ
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
Release
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
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
フィードバック
ユーザーフィードバックを検索して確認します
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
Wasm-split
WebAssembly モジュールにビルド ID を追加し、デバッグデータを分割します
sentry wasm-split <input>— WebAssembly モジュールにビルド ID を追加し、デバッグデータを分割します
→ すべてのフラグと使用例:references/wasm-split.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