mcpField
S
sentry-cli

sentry-cli

sentryセキュリティ0175.7k 回インストール
リポジトリ

sentry-cli について

sentry-cliは、コーディングエージェントが`sentry`コマンドラインからSentryを操作するためのガイドスキルです。Issueやトレースの調査、ドキュメントとAPIスキーマの検索に加え、対象の自動判定や破壊的操作の確認手順を説明します。

主な機能

  1. 01Sentryコマンドラインの操作ガイド
  2. 02組織とプロジェクトの自動判定
  3. 03Issueとトレースの調査手順
  4. 04JSON出力とフィールド選択
  5. 05破壊的操作の安全ガイド

活用シーン

  1. 01特定のSentry Issueを確認
  2. 02トレースとパフォーマンスデータを調査
  3. 03SentryドキュメントやAPIスキーマを検索
  4. 04ログとサービス状態を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sentry/dev --skill sentry-cli

インストール後、Claude Code で/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 を使用します — 特定の問題(例: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)の規約: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 を優先します
  • 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–39API エラー再試行するか、ユーザーに報告
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_number21commonコンパクトな KPI — 1行に3つ配置します(2+2+2=6)
line32common幅の半分を占めるグラフ — 1行に2つ配置します(3+3=6)
area32common幅の半分を占めるグラフ — 1行に2つ配置します
bar32common幅の半分を占めるグラフ — 1行に2つ配置します
table62common全幅 — 常に1行を占有します
stacked_area32specialized積み上げ面グラフ
top_n32specialized上位N件のランキングリスト
categorical_bar32specializedカテゴリ別棒グラフ
text32specialized静的なテキスト/Markdown ウィジェット
details32internal詳細ビュー
wheel32internal円グラフ/ホイールチャート
rage_and_dead_clicks32internal怒りクリック/デッドクリックの可視化
server_tree32internal階層ツリー表示
agents_traces_table32internalエージェントのトレーステーブル

一般的なダッシュボードには 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 は、org 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 より前に 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

コメント