Skip to content

Commit fabfd6d

Browse files
author
Misty Stanley-Jones
authored
Document where to find stack traces (docker#4962)
1 parent 82e5cb7 commit fabfd6d

File tree

1 file changed

+27
-1
lines changed

1 file changed

+27
-1
lines changed

engine/admin/index.md

+27-1
Original file line numberDiff line numberDiff line change
@@ -177,11 +177,37 @@ This will force a stack trace to be logged but will not stop the daemon.
177177
Daemon logs will show the stack trace or the path to a file containing the
178178
stack trace if it was logged to a file.
179179

180-
181180
The daemon will continue operating after handling the `SIGUSR1` signal and
182181
dumping the stack traces to the log. The stack traces can be used to determine
183182
the state of all goroutines and threads within the daemon.
184183

184+
### View stack traces
185+
186+
The Docker daemon log can be viewed by using one of the following methods:
187+
188+
- By running `journalctl -u docker.service` on Linux systems using `systemctl`
189+
- `/var/log/messages`, `/var/log/daemon.log`, or `/var/log/docker.log` on older
190+
Linux systems
191+
- By running `Get-EventLog -LogName Application -Source Docker -After (Get-Date).AddMinutes(-5) | Sort-Object Time` on Docker EE for Windows Server
192+
193+
> **Note**: It is not possible to manually generate a stack trace on Docker for
194+
> Mac or Docker for Windows. However, you can click the Docker taskbar icon and
195+
> choose **Diagnose and feedback** to send information to Docker if you run into
196+
> issues.
197+
198+
Look in the Docker logs for a message like the following:
199+
200+
```none
201+
...goroutine stacks written to /var/run/docker/goroutine-stacks-2017-06-02T193336z.log
202+
...daemon datastructure dump written to /var/run/docker/daemon-data-2017-06-02T193336z.log
203+
```
204+
205+
The locations where Docker saves these stack traces and dumps depends on your
206+
operating system and configuration. You may be able to get useful diagnostic
207+
information straight from the stack traces and dumps. Otherwise, you can provide
208+
this information to Docker for help diagnosing the problem.
209+
210+
185211
## Check whether Docker is running
186212

187213
The operating-system independent way to check whether Docker is running is to

0 commit comments

Comments
 (0)