Sentry CLI について
Sentry CLI はコマンドラインから Sentry プロジェクトを管理します。アプリケーションリリースの作成、スタックトレースの可読性を向上させるソースマップのアップロード、ネイティブデバッグをサポートするデバッグ情報ファイルのアップロードが可能です。
主な機能
- 01アプリケーションリリースの作成と管理
- 02エラーレポートのミニファイ化されたコードを解決するソースマップのアップロード
- 03ネイティブデバッグをサポートするデバッグ情報ファイルのアップロード
活用シーン
- 01デプロイ後にソースマップをアップロードしてエラーレポートの可読性を向上させる
- 02アプリケーションリリースを追跡し関連するエラーを関連付ける
- 03CI/CD パイプラインでデバッグファイル管理を自動化する
インストール
OS またはパッケージマネージャーを選び、コマンドをターミナルで実行します。
インストール後にsentry-cli --versionを実行して確認します。
コマンド例
よく使うコマンドを使う順に並べています。
詳細
重要
このリポジトリは現在、積極的に開発されていません。新しい CLIがまもなくこの CLI に置き換わる予定です。
そのため、このリポジトリでは機能リクエストを受け付けていません。また、新しい CLI の導入を妨げる具体的な理由がある場合に限り、通常はこのリポジトリのバグを修正します。新しい課題は、新しい CLI を含む
getsentry/toolkitモノレポのpackages/cliディレクトリで報告してください。
Sentry CLI
これは、Sentry の公式コマンドラインインターフェイスである Sentry CLI のリポジトリです。
Sentry CLI は、デバッグシンボルやソースマップの Sentry へのアップロード、リリースの管理、イシューやログなどの Sentry データの表示など、さまざまな作業に使用できます。
インストールと使用方法
Sentry CLI のドキュメントページを参照してください。
互換性
Sentry CLI は、バージョン 24.11.1 以降のSentry SaaSおよびSentry Self-Hostedを公式にサポートしています。
セルフホスト版 Sentry
セルフホスト型のインストールでは、新機能にはサーバー側のサポートが必要となる場合があるため、該当するセルフホスト版のリリース時点で Sentry CLI で利用可能だった機能のみがサポートされます。また、sentry-cli buildコマンドなど、一部の機能は Sentry SaaS でのみ利用できます。
24.11.1 より古いバージョンの Sentry Self-Hosted を使用している場合は、Sentry CLI バージョン 3.0.0 以降を使用する前に、Sentry Self-Hosted のインストールをアップグレードすることをお勧めします。アップグレードできない場合は、以下の表に示すバージョンを使用してください。
| Sentry Self-Hosted のバージョン | 互換性のある最新の Sentry CLI バージョン |
|---|---|
| ≥ 24.11.1 | latest |
| < 24.11.1 | 2.58.6 |
公式にサポートされている Sentry Self-Hosted のバージョンのみをサポートできます。お使いのセルフホスト版と互換性がある場合でも、古い Sentry CLI バージョンへの修正のバックポートは行いません。
バージョン管理
Sentry CLI は、このバージョン管理ポリシーに従ってセマンティックバージョニングを採用しています。
コンパイル
自分でコンパイルする場合は、最低限、以下の依存関係をインストールする必要があります。
- Rust stable と Cargo
- Make、CMake、および C コンパイラー
cargo を使用してコンパイルします。
$ cargo build
また、sentry-cliを PATH に含む Alpine ベースの Docker イメージをビルドする Dockerfile もあります。ビルドして使用するには、次のコマンドを実行します。
docker build -t sentry-cli .
docker run --rm -v $(pwd):/work sentry-cli --help
内部ドキュメント
スナップショット：2026-01-29 時点の Sentry CLI 配布物。