mcpField
S
sentry

sentry

github.com/tech-leads-clubクラウド・DevOps7.1k200 回インストール今日更新
リポジトリ

sentry について

sentryは、Sentry APIを通じて問題やイベントを読み取り専用で調査するエージェントスキルです。付属スクリプトでAPIを呼び出し、結果の絞り込みと機密情報の保護を行います。

主な機能

  1. 01問題の一覧表示と検索
  2. 02問題とイベントの詳細取得
  3. 03読み取り専用APIリクエスト
  4. 04出力内の個人情報のマスキング

活用シーン

  1. 01最近の未解決な本番環境の問題確認
  2. 02特定の問題に関するイベント調査
  3. 03スタックトレースを表示せずにイベントを確認

インストール

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

$npx skills add https://github.com/tech-leads-club/agent-skills --skill sentry

インストール後、Claude Code で/sentryを入力して読み込まれたか確認します。

同梱ファイルLICENSE.txtscripts/sentry_api.py

詳細

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

クイックスタート

  • まだ認証されていない場合は、コマンドを実行する前に、有効な SENTRY_AUTH_TOKEN（project:read、event:read などの読み取り専用スコープ）を提供するか、ログインしてトークンを作成するようユーザーに依頼します。
  • SENTRY_AUTH_TOKEN を環境変数として設定します。
  • 任意のデフォルト値：SENTRY_ORG、SENTRY_PROJECT、SENTRY_BASE_URL。
  • デフォルト値：org/project は {your-org}／{your-project}、期間は 24h、環境は prod、件数は 20（最大 50）です。
  • 必ず Sentry API を呼び出します（推測による判断やキャッシュは使用しません）。

トークンがない場合は、次の手順を案内します。

  1. Sentry の認証トークンを作成します：https://sentry.io/settings/account/api/auth-tokens/
  2. project:read、event:read、org:read などの読み取り専用スコープを設定してトークンを作成します。
  3. システムの環境変数として SENTRY_AUTH_TOKEN を設定します。
  4. 必要に応じて、使用している OS／シェルでの環境変数の設定方法を案内します。
  • トークン全体をチャットに貼り付けるようユーザーに求めてはいけません。ローカルで設定し、完了したら知らせてもらいます。

主なタスク（同梱スクリプトを使用）

決定的な API 呼び出しには scripts/sentry_api.py を使用します。ページネーションを処理し、一時的なエラーが発生した場合は 1 回再試行します。

スキルのパス（一度設定）

export AGENT_SKILLS_HOME="${AGENT_SKILLS_HOME:-$HOME/.agent-skills}"
export SENTRY_API="$AGENT_SKILLS_HOME/skills/sentry/scripts/sentry_api.py"

ユーザー単位のスキルは $AGENT_SKILLS_HOME/skills（デフォルト：~/.agent-skills/skills）にインストールされます。

1）イシューを一覧表示（最新順）
python3 "$SENTRY_API" \
  list-issues \
  --org {your-org} \
  --project {your-project} \
  --environment prod \
  --time-range 24h \
  --limit 20 \
  --query "is:unresolved"
2）イシューのショート ID をイシュー ID に解決
python3 "$SENTRY_API" \
  list-issues \
  --org {your-org} \
  --project {your-project} \
  --query "ABC-123" \
  --limit 1

返された id をイシューの詳細またはイベントに使用します。

3）イシューの詳細
python3 "$SENTRY_API" \
  issue-detail \
  1234567890
4）イシューのイベント
python3 "$SENTRY_API" \
  issue-events \
  1234567890 \
  --limit 20
5）イベントの詳細（デフォルトではスタックトレースを含めない）
python3 "$SENTRY_API" \
  event-detail \
  --org {your-org} \
  --project {your-project} \
  abcdef1234567890

API の要件

必ず次のエンドポイントを使用します（GET のみ）。

  • イシュー一覧：/api/0/projects/{org_slug}/{project_slug}/issues/
  • イシューの詳細：/api/0/issues/{issue_id}/
  • イシューのイベント：/api/0/issues/{issue_id}/events/
  • イベントの詳細：/api/0/projects/{org_slug}/{project_slug}/events/{event_id}/

入力とデフォルト値

  • org_slug、project_slug：デフォルトは {your-org}／{your-project} です（本番環境以外の組織は避けます）。
  • time_range：デフォルトは 24h です（statsPeriod として渡します）。
  • environment：デフォルトは prod です。
  • limit：デフォルトは 20、最大 50 です（上限に達するまでページネーションします）。
  • search_query：任意の query パラメーターです。
  • issue_short_id：先にイシュー一覧のクエリで解決します。

出力形式のルール

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

ゴールデンテストの入力

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

プロンプト例：「直近 24 時間に prod で発生した、未解決の上位 10 件のイシューを一覧表示してください。」 期待される結果：タイトル、ショート ID、件数、最終検出日時を含む順序付きリスト。

コメント

Markdown 対応