feat(seer): Add lightweight RCA clustering endpoint integration by yuvmen · Pull Request #112229 · getsentry/sentry

yuvmen · 2026-04-03T20:22:41Z

Integrate Seer's new /v0/issues/supergroups/cluster-lightweight endpoint for lightweight root cause analysis and supergroup clustering.

When a new error issue is created, if the org is in the supergroups.lightweight-enabled-orgs sentry-option, we send the issue's event data to Seer. Seer generates a lightweight RCA via a single LLM call and clusters the issue into supergroups based on embedding similarity. This is separate from the existing Explorer-based agentic RCA flow.

Changes:

Register supergroups.active-rca-source and supergroups.lightweight-enabled-orgs sentry-options
Add LightweightRCAClusterRequest type and make_lightweight_rca_cluster_request() API function
Add trigger_lightweight_rca_cluster() core function and Celery task
Add kick_off_lightweight_rca_cluster pipeline step in post_process for new error issues
Rename existing lightweight_rca.py → explorer_lightweight_rca.py to clarify it's the Explorer-based flow

Call Seer's new /v0/issues/supergroups/cluster-lightweight endpoint on new issue creation, gated per-org via sentry-options. This sends issue event data to Seer for lightweight root cause analysis and clustering into supergroups. Also renames the existing explorer-based lightweight RCA files to explorer_lightweight_rca to avoid confusion with the new direct endpoint-based clustering approach. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

src/sentry/seer/supergroups/lightweight_rca_cluster.py

Serialized event data from EventSerializer can contain non-string dict keys (integer keys in _meta.entries). Without this option orjson.dumps raises TypeError.

github-actions · 2026-04-03T21:11:28Z

Backend Test Failures

Failures on 35a6636 in this run:

tests/sentry/taskworker/test_config.py::test_all_instrumented_tasks_registered — log

[gw1] linux -- Python 3.13.1 /home/runner/work/sentry/sentry/.venv/bin/python3
tests/sentry/taskworker/test_config.py:120: in test_all_instrumented_tasks_registered
    raise AssertionError(
E   AssertionError: Found 1 module(s) with @instrumented_task that are NOT registered in TASKWORKER_IMPORTS.
E   These tasks will not be discovered by the taskworker in production!
E   
E   Missing modules:
E     - sentry.tasks.seer.lightweight_rca_cluster
E   
E   Add these to TASKWORKER_IMPORTS in src/sentry/conf/server.py

Without this registration the task won't be discovered by the taskworker in production.

src/sentry/seer/supergroups/lightweight_rca_cluster.py

github-actions · 2026-04-03T21:30:40Z

Backend Test Failures

Failures on b442df5 in this run:

tests/sentry/taskworker/test_config.py::test_import_paths — log

[gw0] linux -- Python 3.13.1 /home/runner/work/sentry/sentry/.venv/bin/python3
tests/sentry/taskworker/test_config.py:25: in test_import_paths
    __import__(path)
src/sentry/tasks/seer/lightweight_rca_cluster.py:10: in <module>
    @instrumented_task(
E   TypeError: instrumented_task() missing 1 required positional argument: 'namespace'

tests/sentry/test_devimports.py::test_startup_imports[sentry] — log

[gw1] linux -- Python 3.13.1 /home/runner/work/sentry/sentry/.venv/bin/python3
tests/sentry/test_devimports.py:121: in test_startup_imports
    validate_package(pkg, EXCLUDED, XFAIL)
tests/sentry/test_devimports.py:116: in validate_package
    raise AssertionError(ret.stdout)
E   AssertionError: /home/runner/work/sentry/sentry/src/sentry/spans/consumers/process_segments/enrichment.py:38: DeprecationWarning: ATTRIBUTE_NAMES.SENTRY_BROWSER_NAME is deprecated.
E     ATTRIBUTE_NAMES.SENTRY_BROWSER_NAME,
E   error importing sentry.tasks.seer.lightweight_rca_cluster:
E   
E   Traceback (most recent call last):
E     File "<string>", line 35, in <module>
E       __import__(name)
E       ~~~~~~~~~~^^^^^^
E     File "<string>", line 15, in _import
E       return orig(name, globals=globals, locals=locals, fromlist=fromlist, level=level)
E     File "/home/runner/work/sentry/sentry/src/sentry/tasks/seer/lightweight_rca_cluster.py", line 10, in <module>
E       @instrumented_task(
E        ~~~~~~~~~~~~~~~~~^
E           name="sentry.tasks.seer.lightweight_rca_cluster.trigger_lightweight_rca_cluster_task",
E           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
E       ...<2 lines>...
E           taskworker_namespace=issues_tasks,
E           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
E       )
E       ^
E   TypeError: instrumented_task() missing 1 required positional argument: 'namespace'

src/sentry/options/defaults.py

cvxluo · 2026-04-03T21:42:16Z

src/sentry/options/defaults.py

 )

+# Supergroups / Lightweight RCA
+register(


does it make sense to duplicate the options between here and seer? i thought the original plan was to have seer do this check

yea I was conflicted about it, I think that now I got options in Seer I can have protections there, but I also dont want to queue tasks for all issues for nothing, seems very wasteful... and now I can basically have both be controlled by the same repo so I think its ok to protect from both sides using same config

we could just do the check only in sentry the? not sure it makes sense to duplicate the options, especially if the options have exactly the same name + purpose

This option is used on the Seer side, not in Sentry. Remove it until it's actually needed here.

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 6f9d2d1. Configure here.}

cursor · 2026-04-03T22:06:55Z

src/sentry/seer/supergroups/lightweight_rca_cluster.py

+    """
+    enabled_orgs: list[int] = options.get("supergroups.lightweight-enabled-orgs")
+    if group.organization.id not in enabled_orgs:
+        return


Duplicated org enablement check increases maintenance risk

Low Severity

The supergroups.lightweight-enabled-orgs option check is duplicated in kick_off_lightweight_rca_cluster and trigger_lightweight_rca_cluster. The check in trigger_lightweight_rca_cluster is redundant since kick_off_lightweight_rca_cluster already performs this gating before dispatching the task. This duplication creates a maintenance risk if the logic changes, potentially leading to inconsistencies.

Additional Locations (1)

src/sentry/tasks/post_process.py#L1597-L1600

^{Reviewed by Cursor Bugbot for commit 6f9d2d1. Configure here.}

github-actions · 2026-04-03T22:11:07Z

Backend Test Failures

Failures on c02c388 in this run:

tests/sentry/taskworker/test_config.py::test_import_paths — log

[gw1] linux -- Python 3.13.1 /home/runner/work/sentry/sentry/.venv/bin/python3
tests/sentry/taskworker/test_config.py:25: in test_import_paths
    __import__(path)
src/sentry/tasks/seer/lightweight_rca_cluster.py:10: in <module>
    @instrumented_task(
E   TypeError: instrumented_task() missing 1 required positional argument: 'namespace'

tests/sentry/test_devimports.py::test_startup_imports[sentry] — log

[gw1] linux -- Python 3.13.1 /home/runner/work/sentry/sentry/.venv/bin/python3
tests/sentry/test_devimports.py:121: in test_startup_imports
    validate_package(pkg, EXCLUDED, XFAIL)
tests/sentry/test_devimports.py:116: in validate_package
    raise AssertionError(ret.stdout)
E   AssertionError: /home/runner/work/sentry/sentry/src/sentry/spans/consumers/process_segments/enrichment.py:38: DeprecationWarning: ATTRIBUTE_NAMES.SENTRY_BROWSER_NAME is deprecated.
E     ATTRIBUTE_NAMES.SENTRY_BROWSER_NAME,
E   error importing sentry.tasks.seer.lightweight_rca_cluster:
E   
E   Traceback (most recent call last):
E     File "<string>", line 35, in <module>
E       __import__(name)
E       ~~~~~~~~~~^^^^^^
E     File "<string>", line 15, in _import
E       return orig(name, globals=globals, locals=locals, fromlist=fromlist, level=level)
E     File "/home/runner/work/sentry/sentry/src/sentry/tasks/seer/lightweight_rca_cluster.py", line 10, in <module>
E       @instrumented_task(
E        ~~~~~~~~~~~~~~~~~^
E           name="sentry.tasks.seer.lightweight_rca_cluster.trigger_lightweight_rca_cluster_task",
E           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
E       ...<2 lines>...
E           taskworker_namespace=issues_tasks,
E           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
E       )
E       ^
E   TypeError: instrumented_task() missing 1 required positional argument: 'namespace'

The instrumented_task decorator requires `namespace` not `taskworker_namespace`, and doesn't accept `queue` or `max_retries`.

GroupEvent.group is typed as non-optional, so the None check is unreachable and mypy flags it.

github-actions bot added the Scope: Backend Automatically applied to PRs that change backend components label Apr 3, 2026

vercel bot deployed to Preview April 3, 2026 20:23 View deployment

yuvmen force-pushed the yuvmen/feat/lightweight-rca-cluster branch from a949cd4 to 1b7c082 Compare April 3, 2026 21:00

vercel bot deployed to Preview April 3, 2026 21:02 View deployment

sentry-warden bot reviewed Apr 3, 2026

View reviewed changes

src/sentry/seer/supergroups/lightweight_rca_cluster.py Show resolved Hide resolved

fix(seer): Add OPT_NON_STR_KEYS to lightweight RCA cluster request

98a5f16

Serialized event data from EventSerializer can contain non-string dict keys (integer keys in _meta.entries). Without this option orjson.dumps raises TypeError.

fix(seer): Register lightweight RCA cluster task in TASKWORKER_IMPORTS

a3bbef2

Without this registration the task won't be discovered by the taskworker in production.

vercel bot deployed to Preview April 3, 2026 21:15 View deployment

yuvmen marked this pull request as ready for review April 3, 2026 21:20

yuvmen requested review from a team as code owners April 3, 2026 21:20

sentry bot reviewed Apr 3, 2026

View reviewed changes

src/sentry/seer/supergroups/lightweight_rca_cluster.py Show resolved Hide resolved

cursor bot reviewed Apr 3, 2026

View reviewed changes

src/sentry/options/defaults.py Outdated Show resolved Hide resolved

cvxluo reviewed Apr 3, 2026

View reviewed changes

ref(seer): Remove unused supergroups.active-rca-source option

6f9d2d1

This option is used on the Seer side, not in Sentry. Remove it until it's actually needed here.

vercel bot deployed to Preview April 3, 2026 21:56 View deployment

cursor bot reviewed Apr 3, 2026

View reviewed changes

fix(seer): Use correct namespace param for instrumented_task

4905a86

The instrumented_task decorator requires `namespace` not `taskworker_namespace`, and doesn't accept `queue` or `max_retries`.

vercel bot deployed to Preview April 3, 2026 22:15 View deployment

fix(seer): Remove unreachable None check on GroupEvent.group

c984fcf

GroupEvent.group is typed as non-optional, so the None check is unreachable and mypy flags it.

vercel bot deployed to Preview April 3, 2026 22:49 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(seer): Add lightweight RCA clustering endpoint integration#112229

feat(seer): Add lightweight RCA clustering endpoint integration#112229
yuvmen wants to merge 6 commits intomasterfrom
yuvmen/feat/lightweight-rca-cluster

yuvmen commented Apr 3, 2026

Uh oh!

Uh oh!

github-actions bot commented Apr 3, 2026

Uh oh!

Uh oh!

github-actions bot commented Apr 3, 2026 •

edited

Loading

Uh oh!

Uh oh!

cvxluo Apr 3, 2026

Uh oh!

yuvmen Apr 3, 2026

Uh oh!

cvxluo Apr 3, 2026

Uh oh!

cursor bot left a comment

Uh oh!

cursor bot Apr 3, 2026

Uh oh!

github-actions bot commented Apr 3, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

yuvmen commented Apr 3, 2026

Uh oh!

Uh oh!

github-actions bot commented Apr 3, 2026

Backend Test Failures

Uh oh!

Uh oh!

github-actions bot commented Apr 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Backend Test Failures

Uh oh!

Uh oh!

cvxluo Apr 3, 2026

Choose a reason for hiding this comment

Uh oh!

yuvmen Apr 3, 2026

Choose a reason for hiding this comment

Uh oh!

cvxluo Apr 3, 2026

Choose a reason for hiding this comment

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor bot Apr 3, 2026

Choose a reason for hiding this comment

Duplicated org enablement check increases maintenance risk

Uh oh!

github-actions bot commented Apr 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Backend Test Failures

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

github-actions bot commented Apr 3, 2026 •

edited

Loading

github-actions bot commented Apr 3, 2026 •

edited

Loading