Read the following troubleshooting tips for common issues when using the Ruby agent and Passenger.
- Restarting the agent
If all you do is edit the Passenger
tmp/restart.txtfile, it will not pick up the new agent. When you update the agent and restart Passenger, you must do a hard restart of Apache for the change to take effect.
- Missing log files
For Passenger, the log file is
newrelic_agent.passenger.log. Recommendation: For Apache users, provide write permissions for the entire /log directory.
- Developer mode
When using Passenger in Developer mode, sometimes you may notice the list of requests may disappear, or that it seems like it misses some requests. Also, when selecting a request, you may see an error message indicating the trace is not available, suggesting maybe you restarted.
This occurs when Passenger spawns more than one handler process. The transaction traces get put in one of the processes, and if you connect to the other one, you will not see it.
The workaround is to set the max number of instances to 1 by using the PassengerMaxPoolSize parameter. Also, if you refresh several times, you have a good chance of getting the requests back.