sentry

Sentry（読み取り専用のオブザーバビリティ）

クイックスタート

• まだ認証していない場合は、sentry auth login を実行するか、環境変数として SENTRY_AUTH_TOKEN を設定するようユーザーに依頼してください。
• CLI は .env ファイル、ソースコード、設定のデフォルト値、ディレクトリ名に含まれる DSN から組織／プロジェクトを自動検出します。自動検出に失敗した場合、または誤った対象が選択された場合にのみ、<org>/<project> を指定してください。
• デフォルト値：期間は 24h、環境は production、上限は 20 件です。
• 出力をプログラムで処理する場合は、必ず --json を使用してください。特定のフィールドを選択して出力サイズを抑えるには、--json --fields を使用してください。
• API エンドポイントをすばやく確認するには、sentry schema <resource> を使用してください。

CLI がインストールされていない場合は、次の手順を案内してください。

1. Sentry CLI をインストールします：curl https://cli.sentry.dev/install -fsS | bash
2. 認証します：sentry auth login
3. 認証を確認します：sentry auth status

• チャットにトークン全体を貼り付けるよう、ユーザーに依頼してはいけません。ローカルでトークンを設定し、準備ができたら知らせるよう依頼してください。

主なタスク（Sentry CLI を使用）

すべてのクエリには sentry CLI を使用してください。認証、組織／プロジェクトの検出、ページネーション、再試行は自動的に処理されます。機械可読な出力には --json を使用してください。

1）イシューの一覧表示（最新のものから順に）

sentry issue list \
  --query "is:unresolved environment:production" \
  --period 24h \
  --limit 20 \
  --json --fields shortId,title,priority,level,status

自動検出で組織／プロジェクトを特定できない場合は、明示的に指定してください。

sentry issue list {your-org}/{your-project} \
  --query "is:unresolved environment:production" \
  --period 24h \
  --limit 20 \
  --json

2）イシューの短縮 ID から詳細を取得

sentry issue view {ABC-123} --json

数値 ID ではなく、短縮 ID の形式（例：ABC-123）を使用してください。

3）イシューの詳細

sentry issue view {ABC-123}

4）イシューのイベント

sentry issue events {ABC-123} --limit 20 --json

5）イベントの詳細

sentry event view {your-org}/{your-project}/{event_id} --json

6）AI による根本原因分析

sentry issue explain {ABC-123}

7）AI による修正計画

sentry issue plan {ABC-123}

フォールバック：任意の API へのアクセス

専用の CLI コマンドで対応していないエンドポイントには、sentry api を使用してください。

sentry api /api/0/organizations/{your-org}/ --method GET

利用可能な API エンドポイントを確認するには、sentry schema を使用してください。

sentry schema issues

入力とデフォルト値

• org_slug、project_slug：DSN、環境変数、ディレクトリ名から CLI が自動検出します。自動検出に失敗した場合は、位置引数 {your-org}/{your-project} で上書きしてください。
• time_range：デフォルトは 24h です（--period 24h として指定します）。
• environment：デフォルトは prod です（例：environment:production のように、--query の一部として指定します）。
• limit：デフォルトは 20 件です（--limit として指定します）。
• search_query：省略可能な --query パラメーターです。Sentry の検索構文を使用します（例：is:unresolved、assigned:me）。
• issue_short_id：sentry issue view で直接使用します。

出力形式のルール

• イシュー一覧：タイトル、short_id、ステータス、初回検出日時、最終検出日時、件数、環境、主なタグを表示します。最新のものから順に並べます。
• イベントの詳細：culprit、タイムスタンプ、環境、リリース、URL を含めます。
• 結果がない場合は、その旨を明示します。
• 出力内の PII（メールアドレス、IP アドレス）をマスキングしてください。生のスタックトレースは表示しないでください。
• 認証トークンをそのまま出力してはいけません。

ゴールデンテスト入力

• 組織：{your-org}
• プロジェクト：{your-project}
• イシューの短縮 ID：{ABC-123}

プロンプトの例：「過去 24 時間の prod における未解決イシューの上位 10 件を一覧表示してください。」 期待される結果：タイトル、短縮 ID、件数、最終検出日時を含む、順序付きの一覧。