Commit 2cf02b64 authored by Aleksei Lipniagov's avatar Aleksei Lipniagov Committed by Achilleas Pipinellis

Replace Unicorn references in troubleshooting doc

Update `doc/administration/troubleshooting/debug.md`.
parent dc14918a
...@@ -178,7 +178,7 @@ following tips are only recommended if you do NOT mind users being affected by ...@@ -178,7 +178,7 @@ following tips are only recommended if you do NOT mind users being affected by
downtime. Otherwise skip to the next section. downtime. Otherwise skip to the next section.
1. Load the problematic URL 1. Load the problematic URL
1. Run `sudo gdb -p <PID>` to attach to the Unicorn process. 1. Run `sudo gdb -p <PID>` to attach to the Puma process.
1. In the GDB window, type: 1. In the GDB window, type:
```plaintext ```plaintext
...@@ -186,7 +186,7 @@ downtime. Otherwise skip to the next section. ...@@ -186,7 +186,7 @@ downtime. Otherwise skip to the next section.
``` ```
1. This forces the process to generate a Ruby backtrace. Check 1. This forces the process to generate a Ruby backtrace. Check
`/var/log/gitlab/unicorn/unicorn_stderr.log` for the backtrace. For example, you may see: `/var/log/gitlab/puma/puma_stderr.log` for the backtrace. For example, you may see:
```plaintext ```plaintext
from /opt/gitlab/embedded/service/gitlab-rails/lib/gitlab/metrics/sampler.rb:33:in `block in start' from /opt/gitlab/embedded/service/gitlab-rails/lib/gitlab/metrics/sampler.rb:33:in `block in start'
...@@ -213,16 +213,19 @@ downtime. Otherwise skip to the next section. ...@@ -213,16 +213,19 @@ downtime. Otherwise skip to the next section.
exit exit
``` ```
Note that if the Unicorn process terminates before you are able to run these Note that if the Puma process terminates before you are able to run these
commands, GDB will report an error. To buy more time, you can always raise the commands, GDB will report an error. To buy more time, you can always raise the
Unicorn timeout. For omnibus users, you can edit `/etc/gitlab/gitlab.rb` and Puma worker timeout. For omnibus users, you can edit `/etc/gitlab/gitlab.rb` and
increase it from 60 seconds to 300: increase it from 60 seconds to 600:
```ruby ```ruby
unicorn['worker_timeout'] = 300 gitlab_rails['env'] = {
'GITLAB_RAILS_RACK_TIMEOUT' => 600
}
``` ```
For source installations, edit `config/unicorn.rb`. For source installations, set the environment variable.
Refer to [Puma Worker timeout](https://docs.gitlab.com/omnibus/settings/puma.html#worker-timeout).
[Reconfigure](../restart_gitlab.md#omnibus-gitlab-reconfigure) GitLab for the changes to take effect. [Reconfigure](../restart_gitlab.md#omnibus-gitlab-reconfigure) GitLab for the changes to take effect.
...@@ -267,7 +270,7 @@ is a Unicorn worker that is spinning via `top`. Try to use the `gdb` ...@@ -267,7 +270,7 @@ is a Unicorn worker that is spinning via `top`. Try to use the `gdb`
techniques above. In addition, using `strace` may help isolate issues: techniques above. In addition, using `strace` may help isolate issues:
```shell ```shell
strace -ttTfyyy -s 1024 -p <PID of unicorn worker> -o /tmp/unicorn.txt strace -ttTfyyy -s 1024 -p <PID of puma worker> -o /tmp/puma.txt
``` ```
If you cannot isolate which Unicorn worker is the issue, try to run `strace` If you cannot isolate which Unicorn worker is the issue, try to run `strace`
...@@ -275,10 +278,10 @@ on all the Unicorn workers to see where the ...@@ -275,10 +278,10 @@ on all the Unicorn workers to see where the
[`/internal/allowed`](../../development/internal_api.md) endpoint gets stuck: [`/internal/allowed`](../../development/internal_api.md) endpoint gets stuck:
```shell ```shell
ps auwx | grep unicorn | awk '{ print " -p " $2}' | xargs strace -ttTfyyy -s 1024 -o /tmp/unicorn.txt ps auwx | grep puma | awk '{ print " -p " $2}' | xargs strace -ttTfyyy -s 1024 -o /tmp/puma.txt
``` ```
The output in `/tmp/unicorn.txt` may help diagnose the root cause. The output in `/tmp/puma.txt` may help diagnose the root cause.
## More information ## More information
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment