Cookpad::Performance

Adds a selection of tools to make performance troubleshooting and profiling easier in development.

This gem should provide a set of plug-and-play performance monitoring and troubleshooting tools for use in development and test environments.

Each tool should sit behind a feature toggle, and should be explicitly enabled through the use of environment variables.

The gem should not make any changes to the functioning and performance of the application unless a specific feature has explicitly been enabled. This helps us to provide helpful tools that will stay out of your way unless your require them.

Add this line to your application's Gemfile:

group :development, :test do
  gem "cookpad-performance"
end

And then execute:

$ bundle

Log the total number of unique queries, cached queries, and async queries at the foot of each request in the Rails application log.

Activate by setting an environment variable called LOG_DB_QUERY_COUNT=true.

See the initializer file for more information.

Silence cached ActiveRecord database queries from the Rails application log. Makes it easier to see which unique queries are being executed in the database.

Activate by setting an environment variable called DISABLE_CACHED_QUERY_LOGGING=true.

Note: This should be used with discretion, to declutter very noisy logs. Cached queries are also expensive and should not be ignored

See the initializer file for more information.

Receive warnings in the Rails application logs when an n+1 query is detected.

Activate by setting an environment variable called LOG_N_PLUS_ONE_QUERIES=true, or RAISE_N_PLUS_ONE_QUERIES=true to raise exceptions when an instance is detected.

See the initializer file for more information.

Run your Rails application in a production-like configuration of the development environment.

Activate by setting an environment variable called PROFILE=true.

See the initializer file for more information.

The gem is available as open source under the terms of the MIT License.