Check why ruby script hangs

capybara, capybara-webkit, debugging, rspec, ruby

Solution

tl;dr

Use `gdb` (e.g. Linux):

- `echo 'call (void)rb_backtrace()' | gdb -p $(pgrep -f ruby)`

or use `lldb` (e.g. OS X):

- `echo 'call (void)rb_backtrace()' | lldb -p $(pgrep -f ruby)`

You can debug Ruby script by using debug library.

If the script is executed from shell, this can be achieved by changing first line (shebang) of the script into:

#!/usr/bin/env ruby -rdebug

or running it as:

ruby -rdebug my_script.rb

Once the debugger is loaded, you can either set-up some breakpoints or just run the app by typing `c` to continue the execution.

Then the debugger automatically breaks on any Exceptions (such as Ctrl+C) or breakpoints (e.g. the lines which consist `debugger`).

Then every time when debugger console is shown, you can choose between:

- `c` for Continue (to the next Exception, breakpoint or line with: `debugger`),

- `n` for Next line,

- `w`/`where` to Display frame/call stack,

- `l` to Show the current code,

- `cat` to show catchpoints.

- `h` for more Help.

See also: Debugging with ruby-debug, Key shortcuts for ruby-debug gem.

The downside of this method is that there is no magic button to raise the debugger on demand, other than raising the Exception within the script as well which will show different block of code rather than hung one.

Here are few other ideas:

- Add `debugger` statement into your code, raise the debugger and go step by step.

Use Pry debugger instead (see: GitHub).

Install via: `gem install pry`, run as: `pry` or add as `require 'pry'`.

Try `lldb` debugger (which aiming to replace `gdb`) which can attach to the currently running process.

Example (replace `PID` with your process id):

$ lldb -p PID
(lldb) bt all
* thread #1: tid = 0x11d68a, 0x00007fff86c71716 libsystem_kernel.dylib`__psynch_cvwait + 10
  * frame #0: 0x00007fff86c71716 libsystem_kernel.dylib`__psynch_cvwait + 10
    frame #1: 0x00007fff838a9c3b libsystem_pthread.dylib`_pthread_cond_wait + 727
    frame #2: 0x0000000100241aad libruby.2.0.0.dylib`native_cond_wait + 29

Another example showing backtrace of live running ruby script (on its tty):

echo 'call (void)rb_backtrace()' | lldb -p $(pgrep -f ruby)

Alternatively use `gdb` (you can extend it by: `gdb.rb` which can show you ruby objects).

- Install via: `sudo apt-get install gdb python-dev ncurses-dev && gem install gdb.rb`

- On Unix/OS X press Ctrl+T on hanging process to check the PID and what's doing (or check via `ps wuax | grep ruby`).

- Attach to the process via: `gdb -p PID`.

See also: using gdb to inspect a hung ruby process, GDB wrapper for Ruby and Inspecting a live Ruby process.

- Other libraries/tools which can help include: debugger, crash-watch, memprof, rack-perftools_profiler.

If nothing helps, you can simply try: `strace` (Linux) /`dtruss` (OS X) with the following syntax:

sudo strace -fp <PID>
sudo dtruss -fp <PID>

Or `ltrace` which can trace library calls as opposed to `strace` system calls.

If you think it's a network issue, use `tcpdump`.

See also:

- How do I debug Ruby scripts?

- How do I configure ruby to enter the debugger on Ctrl-C (SIGINT)?

- How do I use the keyboard to break into ruby-debug running a rails app?

- Is there a way to use a keystroke to invoke the pry ruby gem?

- Debugging Stuck Ruby Processes – What to do Before You Kill -9

- Tools for Debugging Running Ruby Processes and Debugging Ruby Tools

- Debugging Rails Applications

- The right way to deal with frozen processes on Unix

- Debugging Ruby-applications in Unix by Sergii Boiko

- Debugging using Ruby Debugger at JumpstartLab

- ruby-debug in 30 seconds (we don't need no stinkin' GUI!)

- How to debug stuck Ruby processes

Problem

Original source

Related problems

• How to debug Ruby scripts
• How do I configure ruby to enter the debugger on Ctrl-C (SIGINT)?