2020-10-30 18:08:56 +00:00
---
stage: none
group: unassigned
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers
---
2015-10-15 10:15:18 +00:00
# Profiling
To make it easier to track down performance problems GitLab comes with a set of
profiling tools, some of these are available by default while others need to be
explicitly enabled.
2018-01-19 13:04:30 +00:00
## Profiling a URL
There is a `Gitlab::Profiler.profile` method, and corresponding
`bin/profile-url` script, that enable profiling a GET or POST request to a
specific URL, either as an anonymous user (the default) or as a specific user.
2020-07-16 06:09:33 +00:00
The first argument to the profiler is either a full URL
2019-03-07 11:06:12 +00:00
(including the instance hostname) or an absolute path, including the
leading slash.
2018-01-19 13:04:30 +00:00
When using the script, command-line documentation is available by passing no
arguments.
When using the method in an interactive console session, any changes to the
application code within that console session will be reflected in the profiler
output.
For example:
```ruby
Gitlab::Profiler.profile('/my-user')
# Returns a RubyProf::Profile for the regular operation of this request
class UsersController; def show; sleep 100; end; end
Gitlab::Profiler.profile('/my-user')
# Returns a RubyProf::Profile where 100 seconds is spent in UsersController#show
```
2018-02-16 06:38:45 +00:00
For routes that require authorization you will need to provide a user to
`Gitlab::Profiler` . You can do this like so:
```ruby
Gitlab::Profiler.profile('/gitlab-org/gitlab-test', user: User.first)
```
2018-01-19 13:04:30 +00:00
Passing a `logger:` keyword argument to `Gitlab::Profiler.profile` will send
ActiveRecord and ActionController log output to that logger. Further options are
documented with the method source.
2019-10-24 06:07:07 +00:00
```ruby
Gitlab::Profiler.profile('/gitlab-org/gitlab-test', user: User.first, logger: Logger.new(STDOUT))
```
2018-07-19 12:38:57 +00:00
There is also a RubyProf printer available:
`Gitlab::Profiler::TotalTimeFlatPrinter` . This acts like
`RubyProf::FlatPrinter` , but its `min_percent` option works on the method's
total time, not its self time. (This is because we often spend most of our time
in library code, but this comes from calls in our application.) It also offers a
`max_percent` option to help filter out outer calls that aren't useful (like
`ActionDispatch::Integration::Session#process` ).
There is a convenience method for using this,
`Gitlab::Profiler.print_by_total_time` :
```ruby
result = Gitlab::Profiler.profile('/my-user')
Gitlab::Profiler.print_by_total_time(result, max_percent: 60, min_percent: 2)
# Measure Mode: wall_time
# Thread ID: 70005223698240
# Fiber ID: 70004894952580
# Total: 1.768912
# Sort by: total_time
#
# %self total self wait child calls name
# 0.00 1.017 0.000 0.000 1.017 14 *ActionView::Helpers::RenderingHelper#render
# 0.00 1.017 0.000 0.000 1.017 14 *ActionView::Renderer#render_partial
# 0.00 1.017 0.000 0.000 1.017 14 *ActionView::PartialRenderer#render
# 0.00 1.007 0.000 0.000 1.007 14 *ActionView::PartialRenderer#render_partial
# 0.00 0.930 0.000 0.000 0.930 14 Hamlit::TemplateHandler#call
# 0.00 0.928 0.000 0.000 0.928 14 Temple::Engine#call
# 0.02 0.865 0.000 0.000 0.864 638 *Enumerable#inject
```
2019-02-11 17:51:56 +00:00
To print the profile in HTML format, use the following example:
```ruby
result = Gitlab::Profiler.profile('/my-user')
printer = RubyProf::CallStackPrinter.new(result)
printer.print(File.open('/tmp/profile.html', 'w'))
```
2018-01-19 13:04:30 +00:00
[GitLab-Profiler ](https://gitlab.com/gitlab-com/gitlab-profiler ) is a project
that builds on this to add some additional niceties, such as allowing
2020-04-21 15:21:10 +00:00
configuration with a single YAML file for multiple URLs, and uploading of the
2018-01-19 13:04:30 +00:00
profile and log output to S3.
2015-11-05 17:06:05 +00:00
## Sherlock
2015-10-15 10:15:18 +00:00
2015-11-05 17:06:05 +00:00
Sherlock is a custom profiling tool built into GitLab. Sherlock is _only_
available when running GitLab in development mode _and_ when setting the
environment variable `ENABLE_SHERLOCK` to a non empty value. For example:
2020-01-30 15:09:15 +00:00
```shell
2019-07-09 07:16:17 +00:00
ENABLE_SHERLOCK=1 bundle exec rails s
```
2015-11-05 17:06:05 +00:00
Recorded transactions can be found by navigating to `/sherlock/transactions` .
2015-10-15 10:15:18 +00:00
## Bullet
2020-05-22 00:08:07 +00:00
Bullet is a Gem that can be used to track down N+1 query problems. Bullet section is
displayed on the [performance-bar ](../administration/monitoring/performance/performance_bar.md ).
![Bullet ](img/bullet_v13_0.png )
Because Bullet adds quite a bit of logging noise the logging is disabled by default.
To enable the logging, set the environment variable `ENABLE_BULLET` to a non-empty value before
2015-10-15 10:15:18 +00:00
starting GitLab. For example:
2020-01-30 15:09:15 +00:00
```shell
2019-07-09 07:16:17 +00:00
ENABLE_BULLET=true bundle exec rails s
```
2015-10-15 10:15:18 +00:00
Bullet will log query problems to both the Rails log as well as the Chrome
console.
2017-03-09 14:54:26 +00:00
As a follow up to finding `N+1` queries with Bullet, consider writing a [QueryRecoder test ](query_recorder.md ) to prevent a regression.
2020-03-06 15:08:05 +00:00
## Settings that impact performance
1. `development` environment by default works with hot-reloading enabled, this makes Rails to check file changes every request, and create a potential contention lock, as hot reload is single threaded.
1. `development` environment can load code lazily once the request is fired which results in first request to always be slow.
To disable those features for profiling/benchmarking set the `RAILS_PROFILE` environment variable to `true` before starting GitLab. For example when using GDK:
- create a file [`env.runit` ](https://gitlab.com/gitlab-org/gitlab-development-kit/-/blob/master/doc/runit.md#modifying-environment-configuration-for-services ) in the root GDK directory
- add `export RAILS_PROFILE=true` to your `env.runit` file
- restart GDK with `gdk restart`
*This environment variable is only applicable for the development mode.*