blob: fe36653102c4544b91d92b3e395a68c399a11f8c [file] [log] [blame]
Ian Wienand59ce1d92019-02-11 12:27:10 +11001Devstack systemd journal
2========================
3
4The devstack.journal file is a copy of the systemd journal during the
5devstack run.
6
7To use it, you will need to convert it so journalctl can read it
8locally. After downloading the file:
9
10 $ /lib/systemd/systemd-journal-remote <(xzcat ./devstack.journal.xz) -o output.journal
11
12Note this binary is not in the regular path. On Debian/Ubuntu
Eyal56b2e7f2019-12-19 13:32:55 +020013platforms, you will need to have the "systemd-journal-remote" package
Ian Wienand59ce1d92019-02-11 12:27:10 +110014installed.
15
16It should result in something like:
17
18 Finishing after writing <large number> entries
19
20You can then use journalctl to examine this file. For example, to see
21all devstack services try:
22
23 $ journalctl --file ./output.journal -u 'devstack@*'
24
25To see just cinder API server logs restrict the match with
26
27 $ journalctl --file ./output.journal -u 'devstack@c-api'
28
29There may be many types of logs available in the journal, a command like
30
31 $ journalctl --file ./output.journal --output=json-pretty | grep "_SYSTEMD_UNIT" | sort -u
32
33can help you find interesting things to filter on.