Troubleshooting¶
This page lists common failure modes when using Prof and what to change before opening an issue.
prof ui or prof tui fails in CI or IDEs¶
Menus never appear, or you see an error about stdin or stdout not being a TTY.
prof ui and prof tui expect an interactive terminal.
Use non-interactive commands instead: prof auto and prof manual. See Quickstart Path B and CLI reference.
Wrong directory or no bench folder¶
Collect succeeds elsewhere, or bench/ appears in the wrong repo.
Prof writes .prof/ under the current working directory, which must be your module root (where go.mod lives).
cd to the same directory you use for go test, then run Prof again. See Working directory and paths.
Graphviz or PNG errors¶
Failure when generating call-graph PNGs.
PNG generation uses Graphviz dot when installed. Without Graphviz, prof warns during collection and still writes text profiles.
Install Graphviz for call-graph PNGs. See Collect profiling data.
Next steps¶
- CLI reference for flags and defaults