devstack/roles/export-devstack-journal/templates/devstack.journal.README.txt.j2
Radosław Piliszek 6f2c807bfa gzip, not xz
xz may cause POST_FAILUREs due to memory pressure [1].

[1] http://lists.openstack.org/pipermail/openstack-discuss/2021-April/021609.html

Change-Id: I2ea3175ecf2508b62640bfffdd798d7072e55550
2021-04-06 18:43:32 +00:00

33 lines
1.0 KiB
Django/Jinja

Devstack systemd journal
========================
The devstack.journal file is a copy of the systemd journal during the
devstack run.
To use it, you will need to convert it so journalctl can read it
locally. After downloading the file:
$ /lib/systemd/systemd-journal-remote <(zcat ./devstack.journal.gz) -o output.journal
Note this binary is not in the regular path. On Debian/Ubuntu
platforms, you will need to have the "systemd-journal-remote" package
installed.
It should result in something like:
Finishing after writing <large number> entries
You can then use journalctl to examine this file. For example, to see
all devstack services try:
$ journalctl --file ./output.journal -u 'devstack@*'
To see just cinder API server logs restrict the match with
$ journalctl --file ./output.journal -u 'devstack@c-api'
There may be many types of logs available in the journal, a command like
$ journalctl --file ./output.journal --output=json-pretty | grep "_SYSTEMD_UNIT" | sort -u
can help you find interesting things to filter on.