Demangle Cython __pyx_* symbols in native stack frames

Offen

#6,500 erstellt am 04.6.2026 3 Kommentare 0 Reaktionen 1 zugewiesene Person Auf GitHub ansehen

@alexander-alderman-webb arbeitet bereits daran.

Seit 12.6.2026.

Bewertung

Dieses Issue wurde noch nicht bewertet.

Beschreibung

2. High Feature Python

Native crash frames generated by Cython-compiled code appear as mangled C
symbols (e.g. __pyx_pw_6module_3func) in sentry-native stack traces, making
them unreadable without manual demangling. The Python SDK captures Cython
frames correctly at the Python level (.pyx file, line number), but when a
crash occurs in the native layer of a Cython extension, the native stack frames
shown in Sentry are opaque.

Current behavior

Python-level Cython frames (captured by sentry-python via sys.exc_info())
show correct .pyx source file and line number
Native frames from the C code generated by Cython (captured by sentry-native
on crash) show raw mangled symbols: __pyx_pw_6module_3func_1name,
__pyx_f_6module_3ClassName_method, etc.
C++ demangling (__cxa_demangle) does not apply to Cython's naming scheme
No Cython-specific demangling exists in sentry-python or the Sentry backend

Gap

Cython uses a deterministic, documented symbol naming convention for the C code
it generates. A demangler can reconstruct the original Python-facing name from
a __pyx_* symbol:

__pyx_pw_<module>_<n><name> → Python wrapper for <module>.<name>
__pyx_f_<module>_<ClassName>_<method> → C-level function for
<module>.<ClassName>.<method>

This demangling could be applied as a post-processing step in the
GnuBacktraceIntegration or as a standalone CythonIntegration, enriching
native frames with human-readable Cython source names before the event is sent
to Sentry.

Options

Extend GnuBacktraceIntegration to detect and demangle __pyx_* symbols
in parsed backtrace frames — lowest friction, reuses existing pipeline
Add a standalone CythonIntegration event processor that post-processes
all native frames across exception and crash events — cleaner separation,
applicable beyond GnuBacktrace-formatted strings
Implement server-side demangling in the Sentry symbolicator for __pyx_*
symbols — transparent to SDK users, but requires changes outside this repo

References

Cython generated C naming conventions: https://cython.readthedocs.io/en/latest/src/userguide/debugging.html
Existing GnuBacktraceIntegration: sentry_sdk/integrations/gnu_backtrace.py

Action taken on behalf of Angelo de Voer.

Vorherrschende Sprache: Python
Sterne: 2.2k
Forks: 672
Ø Merge: 22 Std. 47 Min.
Gemergte PRs (30 T.): 224

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus getsentry/sentry-python

Remove `data_collection` from `_experiments` Offen

Python

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 65/100

getsentry/sentry-python#7569 · 1 Kommentar · Erstellt am 22.9.2026
Include `send_default_pii` migration in migration docs Offen

Python

Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 85/100

getsentry/sentry-python#7568 · 2 Kommentare · Erstellt am 22.9.2026
Remove `send_default_pii` from non-integration tests Offen

Python

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 65/100

getsentry/sentry-python#7567 · 1 Kommentar · Erstellt am 22.9.2026
`EventScrubber` doesn't scrub a request body that's a top level JSON array Offen

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100

getsentry/sentry-python#7543 · 2 Kommentare · 1 zugewiesene Person · Erstellt am 20.9.2026
Test with 3.15 stable (out Oct 1) Offen

Python

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100

getsentry/sentry-python#6992 · 1 Kommentar · Erstellt am 03.8.2026

Alle Issues in getsentry/sentry-python