- GraalVM Updater
- Native Image
- Polyglot Programming
- Embedding Reference
- JVM Languages Reference
- JavaScript and Node.js Reference
- LLVM Languages Reference
- Python Reference
- R Reference Manual
- Ruby Reference
- Compatibility
- Debugging Ruby
- Runtime Configurations
- Using Ruby with GraalVM
- Installing `libssl`
- Installing Make and GCC
- Installing `zlib`
- Migration from JRuby to Ruby
- TruffleRuby Options and Command Line
- Polyglot Programming
- Ruby Managers and Installers
- Standalone Distribution
- Development Tools for Ruby
- Ruby Additional Functionality
- Setting up a UTF-8 Locale
- Reporting Performance Problems
- Security
- Optcarrot Example
- FAQ
- WebAssembly Reference
Debugging TruffleRuby
Printing Exceptions #
There are two ways to print exceptions, which can be useful to find the source of an error:
- the standard Ruby
-dflag which prints thefile:linewhere each exception was raised. --backtraces-raisewhich show the full backtrace on each exception raised.
Both print all exceptions even if the exceptions are later rescued.
Java exceptions can be printed with --exceptions-print-uncaught-java or
--exceptions-print-java.
See other --backtraces-* and --exceptions-* options for more possibilities.
Printing Stacktraces and Backtraces of a Running Process #
One can send the SIGQUIT signal to TruffleRuby to make it print the Java stacktraces of all threads.
Ctrl + \ can be used to send SIGQUIT to the current process in a terminal.
This is useful to debug hangs, deadlocks or know what the process is doing.
This works on both TruffleRuby Native and JVM.
Sending SIGALRM to a TruffleRuby process will print the Ruby backtraces of all threads.
Note that printing the Ruby backtraces of all threads significantly lowers
performance, so it should only be used for debugging.
More Information in Backtraces #
TruffleRuby tries to match MRI’s backtrace format as closely as possible. This sometimes means that extra available information is not displayed. When debugging you may want to see this information.
An option to show more information is --backtraces-interleave-java=true
which shows you the Java methods involved in executing each Ruby method.
When you are interoperating with other languages, including C extensions, backtraces for Java exceptions may be missing information, as the Java frames are gone by the time Ruby has a chance to format them into a backtrace.