Production Rails Tuning with Passenger: PassengerMaxProcesses

CTO of Our co-author today is Jesse Newland of RailsMachine . Jesse keeps RailsMachine customers up and running and troubleshoots their toughest problems. We’re pleased to have him share some of his expertise on Phusion Passenger tuning.

Say your Rails application is running in production and it’s getting good traffic. Performance isn’t as good you would like. You’ve already determined that your database is not the bottleneck. What’s your next move?

There is a good chance that Passenger’s PassengerMaxPoolSize needs to be adjusted. PassengerMaxPoolSize specifies how many instances of your application Passenger will spin up to service incoming requests. If you were running Mongrels back in the day, PassengerMaxPoolSize is equivalent to the number of mongrels you configured for your app. The value of PassengerMaxPoolSize has a major bearing on your application’s performance.

The Basic Rule of Thumb

A larger PassengerMaxPoolSize value yields better throughput but uses more memory.

Set PassengerMaxPoolSize too low and you may be constrained by the number of application instances on hand to service requests. Incoming requests get queued up behind running ones, and application response slows down accordingly.

On the other hand, set PassengerMaxPoolSize too high (relative to the amount of RAM you have) and Apache will start gobbling up swap space and begin to sputter. Consume too much swap, and your whole system can grind to a halt.

You need to find Passenger’s “happy place” where memory isn’t being wasted nor is it being over-consumed.

Scenario 1: Too few Passenger threads

RAM doesn’t do you any good just sitting there. A simple way to check your memory situation is free -ml :

~ $free -ml total used free shared buffers cached Mem: 1024 781 242 0 81 389

For illustration purposes, here’s the two-week history of memory usage as captured by Scout:

There is definitely some headroom here—memory usage is around half with very few spikes, leaving us around 500MB free.

Before we change settings, check that the number of Apache processes is actually a limiting factor. Passenger makes this easy to check with the passenger-status command . You’ll see the last line:

GLOBAL QUEUE: Waiting on global queue: 3

There’s our smoking gun—requests are backed up while we have memory to spare! Time to bump up PassengerMaxPoolSize .

Sidebar: If you don’t have Passenger’s global queueing turned on, there is (unfortunately) no way to see if requests are backed up.

How much to bump up PassengerMaxPoolSize?

So we already know that that we have around 500MB sitting around. Two more key pieces of information we need:

1. What’s your current PassengerMaxPoolSize value?

PassengerMaxPoolSize is set in the Apache configuration, typically located at /etc/apache2/apache2.conf . The default value is 6.

2. How much memory does an instance of your application generally use?

It’s easy to find this out with the passenger-memory-stats command . Part of the output will look like this:

--------- Passenger processes ---------- PID Threads VMSize Private Name ---------------------------------------- 6120 1 152.4 MB 26.2 MB Rails: /var/www/apps/wifi/current 637 1 165.1 MB 32.1 MB Rails: /var/www/apps/wifi/current

That “Private” column is what we’re interested in. In this case, application instances take up around 30MB each. Given that we have around 500MB free, we can safely add 10 more instances to the pool. So, we’ll bump PassengerMaxPoolSize from 4 up to 14.

In /etc/apache2/apache2.conf :

@PassengerMaxPoolSize@ 14

Make sure you reload Apache to take in the new settings. The command depends on your configuration; use sudo /etc/init.d/apache2 reload on Ubuntu. If you’re wondering if reload is sufficient (as opposed to a full restart of Apache)— reload is safe, and it ensures all running requests are processed before terminating.

After putting the new configuration in place, monitor your server to ensure everything keeps running correctly. Keep an eye on free memory available, the amount of swap used, the number of passenger processes, and Passenger’s global queue length. You should look for:

the amount of free memory to be less than it was previously (you want to use more of what’s available for better performance)

the amount of swap used to stay at zero.

the number of passenger processes to be close to to the maximum, but not always maxed out.

the Passenger global queue to stay consistently at zero.

Scenario 2: You’re using up all your RAM and running in swap

It’s easy to determine if you’re out of memory and using swap. A rule of thumb:

Any swap usage is bad.

If your server is using swap, your application will perform badly, end of story. So how do you know? run vmstat 2 on your server. The ‘2’ means it will refresh every two seconds. Output that is good looks like this:

~ $vmstat 2 procs -----------memory---------- ---swap-- -----io---- -system-- ----cpu---- r b swpd free buff cache si so bi bo in cs us sy id wa 0 0 139952 174176 81292 398068 1 0 6 7 0 0 1 0 97 0 0 0 139952 174120 81292 398092 0 0 0 0 1133 382 0 0 99 0 0 0 139952 174120 81292 398092 0 0 0 28 1087 32 0 0 99 0 0 0 139952 174120 81292 398092 0 0 0 0 1155 25 0 0 99 0

You can ignore the first line in the vmstat output (in this case, the line with the 1 under si). The ‘si’ and ‘so’ columns are swap-in and swap-out, respectively, and show writes and reads to swap. If there’s activity there, especially in ‘so’, you’re using swap instead of RAM, and things will be slower. See the Analyze your Server's "Swappiness" section in this helpful article over at Rails Machine for more details.

What to Do?

If you’re running in swap , you basically have two options:

Add more memory. If you’re running VM’s, this should be straightforward. Reduce the memory consumption of processes on this machine.

It is unlikely that simply reducing the PassengerMaxPoolSize on this machine will solve your problems. If Passenger is spinning up this many instances, you have too much traffic for your current setup.

Some options for freeing up memory for better performance include:

Add another front-end box running Apache+Passenger. If you don’t already have a load balancer, you’ll need to set one up.

Moving something off this server (database? full text search? batch jobs?) to another machine to free up memory.

How RailsMachine uses Scout to determine PassengerMaxPoolSize

If you’re just looking at the current memory usage, you’re ignoring past memory spikes. You may allocate to much memory to Passenger, exhaust the swap memory space, and shut down the server. Scout makes it easier to tune Passenger because:

you can view the long-term history and volatility of memory usage the Phusion Passenger Monitor plugin automatically tracks the number of Passenger processes and total RAM used by Passenger processes.

The chart above shows the total RAM used and the RAM used by Passenger processes over the past week. We can can an idea of volatility (November 15 had a large memory spike). Since this server has 1 GB of RAM, it looks like we have headroom for more Passenger processes (another 100 MB could safely be used by Passenger based on the chart).

Conclusion

The number of processes Passenger will spin up has a significant bearing on your application’s performance. The setting is in your Apache configuration file under PassengerMaxPoolSize . Generally speaking, you want to fill up as much RAM as possible with passenger processes without utilizing swap in order to maximize you performance and throughput.

Adjust PassengerMaxPoolSize so that there is little free RAM left and no swap being used.