Skip to content

Commit 502d716

Browse files
authored
Update troubleshooting.md (#4364)
Added section describing pyperf error when Python libraries have custom names
1 parent 9ea9ad3 commit 502d716

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

docs/sources/configure-client/grafana-alloy/ebpf/troubleshooting.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,3 +76,21 @@ apt install libc6-dbg
7676
If your profiles show many shallow stack traces, typically 1-2 frames deep, your binary might have been compiled without frame pointers.
7777

7878
To compile your code with frame pointers, include the `-fno-omit-frame-pointer` flag in your compiler options.
79+
80+
81+
### Ensure Python process data is discoverable
82+
83+
This error indicates that Pyroscope cannot locate required Python runtime symbols, potentially due to nonstandard library naming:
84+
85+
`pyperf get python process data failed: missing symbols pyRuntimeAddr autoTLSkeyAddr`
86+
87+
This can occur if the application build process uses custom naming for libraries, such as:
88+
89+
- `libpython3-custom.10.so.1.0`
90+
91+
Pyroscope expects standard naming patterns like:
92+
93+
- `libpython3.10.so.1.0`
94+
95+
To resolve this, ensure Python libraries follow standard naming conventions.
96+

0 commit comments

Comments
 (0)