Repository navigation
Description
Summary
sentry issue list --query 'release:"<release>"' correctly restricts which groups are returned, but the count and userCount in the response are period-wide totals across every release, not the counts matching the query. Nothing in the output signals this, so a release-scoped triage built on issue list silently over-reports by an arbitrary factor.
Environment
sentry 0.40.0
node v24.18.0
Windows 10.0.26200
Steps to reproduce
Any project with several releases contributing to the same issue group.
# 1. list issues restricted to one release
sentry issue list <org>/<project> --period 14d \
--query 'release:"<release-A>" is:unresolved' \
--sort freq --limit 100 --fresh --json
# 2. ask the events endpoint for the same group, with the same release filter
sentry api "/organizations/<org>/events/?field=count()&field=count_unique(user)\
&query=issue%3A<SHORT-ID>%20release%3A%22<release-A>%22\
&statsPeriod=14d&project=<project-id>&dataset=errors" --jsonActual
For one group in a project with 21 releases:
| source | events | users |
|---|---|---|
issue list with release:"A" in the query |
639 | 442 |
events endpoint, same issue + same release |
238 | 189 |
The issue list numbers equal that group's totals over the period across all releases. The factor is not constant — it depends on how the group is distributed across releases, so it cannot be corrected after the fact.
Expected
Either the counts reflect the applied query filter, or the output marks them as unfiltered lifetime/period totals so a caller does not attribute them to the filter.
Impact
This is the documented path for release triage (references/skill guidance suggests issue list --query 'release:"X" is:unresolved' --sort freq), and it is the natural entry point for agents. In my case it promoted an unrelated high-volume group to "top problem in release X" when that group's actual contribution to the release was a small fraction of the reported number — the release only had ~8k events total while the tool reported a single group at 4118 for it.
Notes
--sort freqordering appears to follow the same unfiltered counts, so the ranking is affected too, not just the displayed numbers.- The events endpoint returns correctly scoped values, so the data is available; it looks like the issues endpoint's stats simply are not filter-aware.
- Related but distinct:
sentry issue list --json --fieldsomitscount,firstSeen,lastSeen,userCount(missingexpand=stats) cli#969 (fields omitted withoutexpand=stats) — that one is about which fields appear, this one is about the values being out of scope.
Activity
fix(cli): Scope issue list counts to the release: filter (#1512)
linear-code commentedon Oct 22, 2026
MCP-1106
sentry-junior commentedon Oct 22, 2026
Closing — this is fixed on
mainby #1512 (fix(cli): Scope issue list counts to the release: filter, merged 2026-10-16, 5a7ec5a).When
--querycontains a count-unscoped filter (currentlyrelease:),issue listnow refetches each listed issue's counts from/organizations/<org>/events/withissue:<SHORT-ID>plus your query, overwritescount/userCountwith the scoped values, and re-ranks the results for--sort freq/--sort user. SeeapplyScopedCountsinpackages/cli/src/commands/issue/list.tsandunscopedCountFilterKeysinpackages/cli/src/lib/search-query.ts.The fix isn't in a published release yet (latest is
cli@0.47.0, cut before #1512). It should be in the next CLI release, or you can use a nightly now.One limitation: re-ranking applies only to the page that was fetched, because the API still picks that page by period-wide frequency. If you need an exact release-wide top-N, use a larger
--limit. If that turns out to matter in practice, please open a separate issue.fix(cli): Use the issues endpoint's filtered counts for release: quer…