Troubleshooting
Have you followed the Get Started guide but still aren't seeing results? Here are a couple possible reasons:
1. flakytest is not installed
Pytest lists all installed plugins in the sesssion header:
============================= test session starts ==============================
platform darwin -- Python 3.14.0, pytest-9.0.2, pluggy-1.6.0
rootdir: /Users/anze/flakytest/flakytest-python-example
plugins: flakytest-2026.0b1 # <--- this line
collected 7 items
pip install flakytest
2. Environment variable is not set
Check if the env variable is set:
echo $FLAKYTEST_SECRET_TOKEN
It should print out your secret token. If it does not make sure to set it and then rerun pytest:
export FLAKYTEST_SECRET_TOKEN=your-secret-token
3. Profiles show no stacks
If a run reports profiler_unavailable, no sampling profiler could attach to the test process. On Python before 3.15 flakytest uses py-spy, which needs permission to read another process's memory: in Docker add --cap-add SYS_PTRACE, on Linux check /proc/sys/kernel/yama/ptrace_scope, on macOS run with sudo or use Python 3.15. Durations, fixtures and query counts are still exact without it.
4. Some tests have no breakdown
Tests shorter than the sampling interval may get no samples. Rerun with a higher rate, e.g. pytest --flakytest-profile --flakytest-rate 5000.
The documentation covers profiler permissions, sampling rates and uploads in more detail.