ComposioHQ/sentry-triage

Sentry Triage

Composio CLI を介してSentryのイシュー、イベント、および疑わしいコミットをエージェントに直接取り込みます。スタックトレースのコピペ作業は不要です。

使用すべきタイミング

• 新しいSentryアラートが届き、件名だけでなくエージェントに詳細を調査させたい場合。
• 回帰の診断：リリース、疑わしいコミット、影響を受けるファイルを特定する場合。
• 再現ヒントを含む「未解決トップ10イシュー」のダイジェストを作成する場合。

前提条件

curl -fsSL https://composio.dev/install | bash
composio login
composio link sentry        # event:read および project:read 権限を持つ認証トークン

ツールの確認

composio search "get sentry issue" --toolkits sentry
composio search "list events for issue" --toolkits sentry
composio tools list sentry

よく使うスラッグ（--get-schema で確認してください）：

• SENTRY_GET_AN_ISSUE
• SENTRY_LIST_AN_ISSUES_EVENTS
• SENTRY_RETRIEVE_AN_EVENT_FOR_A_PROJECT
• SENTRY_LIST_A_PROJECTS_ISSUES
• SENTRY_UPDATE_AN_ISSUE

単一イシューの診断

1. イシューを取得（ショートID（PROJ-1F4など）または数値IDを使用）：

   composio execute SENTRY_GET_AN_ISSUE -d '{"issue_id":"PROJ-1F4"}'
   

2. 最新のイベントを取得（完全なスタックトレースとブレッドクラムを含む）：

   composio execute SENTRY_LIST_AN_ISSUES_EVENTS \
     -d '{"issue_id":"PROJ-1F4","full":true,"limit":1}'
   

3. 各フレームをローカルソースにマッピング。 スタック内の各 filename + lineno に対して、エージェントがファイルを開き、前後±20行を読み取ります。手動でのコピペは不要です。
4. 疑わしいコミットを確認（リリース追跡が設定されている場合、Sentryがこれらのコミットを添付します）— ローカルで git show <sha> を使用して開きます。
5. 修正を提案（差分付き）、テストを実行し、すべてが正常になったらイシューを解決済みにマーク：

   composio execute SENTRY_UPDATE_AN_ISSUE \
     -d '{"issue_id":"PROJ-1F4","status":"resolved","statusDetails":{"inNextRelease":true}}'
   

バッチ処理

composio execute SENTRY_LIST_A_PROJECTS_ISSUES -d '{
  "organization_slug":"acme",
  "project_slug":"api",
  "query":"is:unresolved age:-24h",
  "sort":"freq",
  "limit":20
}'

ランキングサマリーとして jq にパイプ：

composio execute SENTRY_LIST_A_PROJECTS_ISSUES -d '{"organization_slug":"acme","project_slug":"api","query":"is:unresolved"}' \
  | jq -r '.[] | "\(.count)\t\(.shortId)\t\(.title)"' | sort -rn | head

ワークフローファイル

scripts/sentry-diag.ts、実行方法： composio run --file scripts/sentry-diag.ts -- --id PROJ-1F4

const id = process.argv[process.argv.indexOf("--id") + 1];

const issue = await execute("SENTRY_GET_AN_ISSUE", { issue_id: id });
const [event] = await execute("SENTRY_LIST_AN_ISSUES_EVENTS", {
  issue_id: id, full: true, limit: 1
});

const frames = (event?.entries ?? [])
  .filter(e => e.type === "exception")
  .flatMap(e => e.data.values.flatMap(v => v.stacktrace?.frames ?? []))
  .filter(f => f.inApp)
  .map(f => ({ file: f.filename, line: f.lineno, fn: f.function }));

console.log(JSON.stringify({ title: issue.title, culprit: issue.culprit, frames }, null, 2));

その後、エージェントは各 file の line ± 20 を読み取り、パッチを作成します。

Linear / Slack へのルーティング

ツールを連鎖させて、未解決のトップイシューのチケットを開く：

composio run '
  const [top] = await execute("SENTRY_LIST_A_PROJECTS_ISSUES", {
    organization_slug: "acme", project_slug: "api",
    query: "is:unresolved", sort: "freq", limit: 1
  });
  await execute("LINEAR_CREATE_ISSUE", {
    teamId: "TEAM_ID",
    title: `[Sentry] ${top.title}`,
    description: `Short ID: ${top.shortId}\nPermalink: ${top.permalink}\nCount: ${top.count}`
  });
'

トラブルシューティング

• issue_id で 404 エラー → URLスラッグではなく、ショートID（PROJ-1F4）を使用してください。
• 空のイベント → イシューが解決済み/アーカイブされている可能性があります。query:"is:resolved" でクエリするか、limit を増やしてください。
• 疑わしいコミットがない → Sentryでリリース追跡が設定されていません。CIで sentry-cli releases を設定してください。
• inApp フレームがない → ソースマップがアップロードされていません。スタックにはベンダーコードのみが表示されます。

CLIの完全なリファレンス: docs.composio.dev/docs/cli