1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
|
## Синтаксис и опции journalctl
Если утилита не выводит ничего, выполните её от имени суперпользователя:
**journalctl опции**
- **--full, -l** - отображать все доступные поля;
- **--all, -a** - отображать все поля в выводе full, даже если они содержат непечатаемые символы или слишком длинные;
- **--pager-end, -e** - отобразить только последние сообщения из журнала;
- **--lines, -n** - количество строк, которые нужно отображать на одном экране, по умолчанию 10;
- **--no-tail** - отображать все строки доступные строки;
- **--reverse, -r** - отображать новые события в начале списка;
- **--output, -o** - настраивает формат вывода лога;
- **--output-fields** - поля, которые нужно выводить;
- **--catalog, -x** - добавить к информации об ошибках пояснения, ссылки на документацию или форумы там, где это возможно;
- **--quiet, -q** - не показывать все информационные сообщения;
- **--merge, -m** - показывать сообщения из всех доступных журналов;
- **--boot, -b** - показать сообщения с момента определенной загрузки системы. По умолчанию используется последняя загрузка;
- **--list-boots** - показать список сохраненных загрузок системы;
- **--dmesg, -k** - показывает сообщения только от ядра. Аналог вызова команды dmesg;
- **--identifier, -t** - показать сообщения с выбранным идентификатором;
- **--unit, -u** - показать сообщения от выбранного сервиса;
- **--user-unit** - фильтровать сообщения от выбранной сессии;
- **--priority, -p** - фильтровать сообщения по их приоритету. Есть восемь уровней приоритета, от 0 до 7;
- **--grep, -g** - фильтрация по тексту сообщения;
- **--cursor, -c** - начать просмотр сообщений с указанного места;
- **--since, -S, --until, -U** - фильтрация по дате и времени;
- **--field, -F** - вывести все данные из выбранного поля;
- **--fields, -N** - вывести все доступные поля;
- **--system** - выводить только системные сообщения;
- **--user** - выводить только сообщения пользователя;
- **--machine, -M** - выводить сообщения от определенного контейнера;
- **--header** - выводить заголовки полей при выводе журнала;
- **--disk-usage** - вывести общий размер лог файлов на диске;
- **--list-catalog** - вывести все доступные подсказки для ошибок;
- **--sync** - синхронизировать все не сохраненные журналы с файловой системой;
- **--flush** - перенести все данные из каталога /run/log/journal в /var/log/journal;
- **--rotate** - запустить ротацию логов;
- **--no-pager** - выводить информацию из журнала без возможности листать страницы;
- **-f** - выводить новые сообщения в реальном времени, как в команде tail;
- **--vacuum-time** - очистить логи, давностью больше указанного периода;
- **--vacuum-size** - очистить логи, чтобы размер хранилища соответствовал указанному.
## Горячие клавиши journalctl
По умолчанию информация лога выводится в формате, в котором её можно листать. Давайте разберем горячие клавиши, которые вы можете для этого использовать:
- **Стрелка вниз, Enter, e** или **j** - переместиться вниз на одну строку;
- **Стрелка вверх, y** или **k** - переместиться на одну строку вверх;
- **Пробел** - переместиться на одну страницу вниз;
- **b** - переместиться на одну страницу вверх;
- **Стрелка вправо, стрелка влево** - горизонтальна прокрутка;
- **g** - перейти на первую строку;
- **G** - перейти на последнюю строку;
- **p** - перейти на позицию нужного процента сообщений. Например, 50p перенесет курсор на середину вывода;
- **/** - поиск по журналу;
- **n** - найти следующее вхождение;
- **N** - предыдущее вхождение;
- **q** - выйти.
## Шпаргалка по journalctl
Чтобы найти именно то, что вам нужно, необходимо научится перемещаться по этому списку. Формат вывода лога довольно простой:
**янв 13 20:55:55 sergiy-pc kernel: Linux version 4.15.0-43-generic**
- **янв 13 20:55:55** - дата и время события;
- **sergiy-pc** - хост, на котором произошло событие;
- **kernel** - источник события, обычно это программа или сервис. В данном случае ядро;
- **Linux version 4.15.0-43-generic** - само сообщение.
### 1. Просмотр логов сервисов
Самый частый случай использования journalctl - это когда вы пытаетесь запустить какой-либо сервис с помощью systemd, он не запускается и systemd выдает вам такое сообщение подобного содержания: Failed to start service use journalctl -xe for details. Система сама предлагает вам какую команду надо выполнить:
`sudo journalctl -xe`
Как вы помните из опций, эта команда отображает последние сообщения в журнале и добавляет к ним дополнительную информацию, если она есть. Учитывая, что последнее, что мы делали - был наш сервис, то здесь будут сообщения от него и вы быстро сможете понять почему он не запускается.
Чтобы отфильтровать сообщения только от определенного сервиса можно использовать опцию -u. Например:
`sudo journalctl -eu apache2.service`
### 2. Просмотр логов в режиме tail
С помощью опции -f можно указать утилите, что необходимо выводить новые сообщения в реальном времени:
`sudo journalctl -f`
В этом режиме less не поддерживается, поэтому для выхода нажмите сочетание клавиш **Ctrl+C**.
### 3. Просмотр логов загрузки
В логе journalctl содержатся все логи, в том числе и логи загрузки. Для того чтобы открыть лог последней загрузки используйте опцию -b:
`sudo journalctl -b`
Посмотреть список всех сохраненных загрузок можно командой:
`sudo journalctl -list-boots`
Теперь, чтобы посмотреть сообщения для нужной загрузки используйте её идентификатор:
`sudo journalctl -b 37d5c906c9c6404682f029b2c34ec9dc`
### 4. Фильтрация по дате
С помощью опции **--since** вы можете указать дату и время, начиная с которой нужно отображать логи:
`sudo journalctl --since "2019-01-20 15:10:10"`
Опция **--until** помогает указать по какую дату вы хотите получить информацию:
`sudo journalctl -e --until "2019-01-20 15:05:50"`
Или сразу скомбинируем две эти опции чтобы получить логи за нужный период:
`sudo journalctl --since "2019-01-20 15:10:10" --until "2019-01-20 15:05:50"`
Кроме даты в формате YYYY-MM-DD в этих опциях можно использовать такие слова, как yesterday, today, и tomorrow. Также допустимы конструкции **1 day ago** (один день назад) или **3 hours ago** (три часа назад). Ещё можно использовать знаки + и -. Например **-1h30min** будет означать полтора часа назад.
### 5. Журнал ядра
Если вы хотите посмотреть только сообщения ядра используйте опцию -k:
`sudo journalctl -ek`
### 6. Настройка формата вывода
По умолчанию journalctl выводит информацию с помощью утилиты less, в которой вы можете её удобно листать и просматривать. Но формат вывода можно изменить:
- **short** - используется по умолчанию;
- **verbose** - также, как и short, только выводится намного больше информации;
- **json** - вывод в формате json, одна строка лога в одной строке вывода;
- **json-pretty** - форматированный вывод json для более удобного восприятия;
- **cat** - отображать только сообщения, без метаданных.
Чтобы указать нужный формат используйте опцию -o. Например:
`sudo journalctl -o json-pretty`
Или:
`sudo journalctl -eo json-pretty`
### 7. Очистка логов
Сначала нужно посмотреть сколько ваши логи занимают на диске. Для этого используйте такую команду:
`sudo journalctl --disk-usage`
Чтобы уменьшить размер лога можно использовать опцию --vacuum-size. Например, если вы хотите, чтобы ваши файлы журналов занимали на диске не более 2 Гб, выполните команду:
`sudo journalctl --vacuum-size=2G`
Теперь старые логи будут удалены, пока общий объем хранилища не будет составлять 2 гигабайта.
Также можно удалять логи по времени. Для этого используется опция --vacuum-time. Например, оставим только логи за последний год:
`journalctl --vacuum-time=1years`
|