ComposioHQ/sentry-triage

Sentry Triage

Puxe issues, eventos e commits suspeitos do Sentry diretamente para o agente via CLI do Composio. Pule a dança de copiar e colar stack traces.

Quando Usar

• Novo alerta do Sentry e você quer que o agente investigue, não apenas cite o assunto.
• Diagnosticando uma regressão: encontre as releases, o commit suspeito e os arquivos afetados.
• Criando um resumo das "10 issues não resolvidas mais frequentes" com dicas de reprodução.

Pré-requisitos

curl -fsSL https://composio.dev/install | bash
composio login
composio link sentry        # token de autenticação com event:read + project:read

Descobrir Ferramentas

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

Slugs comuns (verifique com --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

Diagnosticar uma Única Issue

1. Busque a issue (pelo ID curto como PROJ-1F4 ou ID numérico):

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

2. Pegue o evento mais recente com stack completo + breadcrumbs:

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

3. Mapeie cada frame para o código fonte local. Para cada filename + lineno na stack, o agente abre o arquivo e lê ±20 linhas. Sem copiar e colar manualmente.
4. Verifique commits suspeitos (o Sentry anexa estes quando o rastreamento de releases está configurado) — abra-os com git show <sha> localmente.
5. Proponha uma correção com um diff, execute testes e — quando estiver verde — marque a issue como resolvida:

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

Triagem em Lote

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

Encaminhe para jq para um resumo ranqueado:

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

Arquivo de Workflow

scripts/sentry-diag.ts, execute com 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));

O agente então lê cada file na line ± 20 e elabora um patch.

Rotear para Linear / Slack

Encadeie ferramentas para abrir um ticket para a issue não resolvida mais frequente:

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}`
  });
'

Solução de Problemas

• 404 on issue_id → use o ID curto (PROJ-1F4), não o slug da URL.
• Eventos vazios → a issue foi resolvida/arquivada; consulte com query:"is:resolved" ou aumente limit.
• Commit suspeito ausente → o rastreamento de releases não está configurado no Sentry; configure sentry-cli releases no CI.
• Nenhum frame inApp → source maps não foram enviados; a stack mostrará apenas código de fornecedor.

Referência completa da CLI: docs.composio.dev/docs/cli