Merge pull request #71 from jodh-intel/add-sigusr1-to-dev-guide

docs: Explain SIGUSR1 usage in dev guide
This commit is contained in:
Eric Ernst 2018-05-16 10:45:59 -07:00 committed by GitHub
commit 8876d423df
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -275,7 +275,19 @@ script and paste its output directly into a
To perform analysis on Kata logs, use the
[`kata-log-parser`](https://github.com/kata-containers/tests/tree/master/cmd/log-parser)
tool.
tool, which can convert the logs into formats (e.g. JSON, TOML, XML, and YAML).
To obtain a full backtrace for the agent, proxy, runtime, or shim send the
`SIGUSR1` signal to the process ID of the component. The component will send a
backtrace to the system log on the host system and continue to run without
interruption.
For example, to obtain a backtrace for `kata-proxy`:
```
$ sudo kill -USR1 $kata_proxy_pid
$ sudo journalctl -t kata-proxy
```
# Appendices