Journalctl: Difference between revisions

From ICO wiki
Jump to navigationJump to search
Mnoumees (talk | contribs)
No edit summary
Mnoumees (talk | contribs)
No edit summary
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Sissejuhatus==
==Sissejuhatus==
''journalctl'' on käsk ''[[Systemd]]'' logide kuvamiseks. ''systemd'' kasutab ''systemd-journald'' teenust andmete logimiseks. Teenus kogub informatsiooni kerneli teadetest üle ''kmsg'', tavapärastest süsteemi logidest ''[[Syslog]]''-ilt pärides, kasutades oma enda API't, süsteemi teenuste STDOUT ja STDERR-ist ja ''[[Auditd]]'' salvestustest.
''journalctl'' on käsk ''[[Systemd]]'' logide kuvamiseks. ''systemd'' kasutab ''systemd-journald'' teenust andmete logimiseks. Teenus kogub informatsiooni kerneli teadetest üle ''kmsg'', tavapärastest süsteemi logidest ''[[Syslog]]''-ilt pärides, kasutades oma enda API't, süsteemi teenuste STDOUT ja STDERR-ist ja ''[[Auditd]]'' salvestustest.<ref>https://www.freedesktop.org/software/systemd/man/systemd-journald.service.html#</ref>


''journalctl'' on väga kasulik tööriist Linuxi kasutaja varamus, sest see tsentraliseerib paljude protsesside logid ühe käsu alla olenemata nende lähteasukohast.  
''journalctl'' on väga kasulik tööriist Linuxi kasutaja varamus, sest see tsentraliseerib paljude protsesside logid ühe käsu alla olenemata nende lähteasukohast.  
Line 15: Line 15:
''journalctl'' väljund kuvatakse kasutades ''[[Less]]''-i. Kriitilised read on värvitud punaseks ja muidu tähelepanu võibolla vajavad read on tavapärasest eredamas tekstis.  
''journalctl'' väljund kuvatakse kasutades ''[[Less]]''-i. Kriitilised read on värvitud punaseks ja muidu tähelepanu võibolla vajavad read on tavapärasest eredamas tekstis.  


Sisestades oma soovitud terminali emulaatorisse käsu '''<code>journalctl</code>''' kuvatakse kõik logid, millel on kasutajal lugemisõigus. Ilma lisaparameetriteta võib järgnev väljund olla väga raskesti loetav, sest olenevalt Linuxi kasutusest, konfiguratsioonifailis sätitud logifailide kõvakettakasutuse piirangutest ja logide hoidmise ajalisest piirangust, võib väljund olla väga pikk ulatudes tavapärase kasutuse puhul mitmete miljonite ridadeni.
Sisestades oma soovitud terminali emulaatorisse käsu <code>journalctl</code> kuvatakse kõik logid, millel on kasutajal lugemisõigus. Ilma lisaparameetriteta võib järgnev väljund olla väga raskesti loetav, sest olenevalt Linuxi kasutusest, konfiguratsioonifailis sätitud logifailide kõvakettakasutuse piirangutest ja logide hoidmise ajalisest piirangust, võib väljund olla väga pikk ulatudes tavapärase kasutuse puhul mitmete miljonite ridadeni.


Filtreerimaks väljundit on olemas mitmeid võtmeid, millest kasulikumad järgnevad :
===Väljundi filtreerimine===
Filtreerimaks väljundit on olemas mitmeid võtmeid, millest kasulikumad järgnevad :<ref>https://www.freedesktop.org/software/systemd/man/journalctl.html</ref>
----
----
*'''<code>journalctl -b</code>'''
<source lang="bash">journalctl -b</source>
:: tagastab terve logi viimasest käivitusest saadik
:: tagastab terve logi viimasest käivitusest saadik
----
----
-b võtmele võib lisada järgi arvu, mis näitab mitmenda käivituse logi näidata kronoloogilises järjekorras.
'''-b''' võtmele võib lisada järgi arvu, mis näitab mitmenda käivituse logi näidata kronoloogilises järjekorras.


*'''<code>journalctl -b 1</code>'''
<source lang="bash">journalctl -b 1</source>  
:: tagastab esimese käivituse logi, mis on logiraamatus saadaval
:: tagastab esimese käivituse logi, mis on logiraamatus saadaval
----
----
Kui anda -b võtmele miinusmärgiga arv siis tagastatakse praegusest nii mitmes tahapoole jääv logi kui miinusmärgi järel arv.
Kui anda '''-b''' võtmele miinusmärgiga arv siis tagastatakse praegusest nii mitmes tahapoole jääv logi kui miinusmärgi järel arv.


*'''<code>journalctl -b -2</code>'''
<source lang="bash">journalctl -b -2</source>  
:: tagastab praegusest kahe võrra tahapoole jääv logi, ehk üleeelmise.
:: tagastab praegusest kahe võrra tahapoole jääv logi, ehk üleeelmise.
----
----
''journalctl''-il on ka --since ( -S ) ja --until ( -U ) võtmed, millega saab filtreerida väljundit näitamaks logiridu mingist ajast alates kuni mingi ajani.
''journalctl''-il on ka '''--since''' ( '''-S''' ) ja '''--until''' ( '''-U''' ) võtmed, millega saab filtreerida väljundit näitamaks logiridu mingist ajast alates kuni mingi ajani.
*'''<code>journalctl --since "20 min ago"</code>''' või '''<code>journalctl --since="2016-12-01 12:01:01" --until "2016-12-08"</code>'''
<source lang="bash">journalctl --since "20 min ago"</source> või <source lang="bash">journalctl --since="2016-12-01 12:01:01" --until "2016-12-08"</source>
:: tagastab logi alates 20 minutit tagasi või alates esimesest detsembrist 2016 (soovi korral võib kellaaja ka määrata, vaikimisi 00:00:00) kuni kaheksanda detsembrini.  
:: tagastab logi alates 20 minutit tagasi või alates esimesest detsembrist 2016 (soovi korral võib kellaaja ka määrata, vaikimisi 00:00:00) kuni kaheksanda detsembrini.  
----
----
Jälgimaks uusi sissetulevaid teateid reaalajas võib kasutada -f võtit.
Jälgimaks uusi sissetulevaid teateid reaalajas võib kasutada '''-f''' võtit.
*'''<code>journalctl -f</code>'''
<source lang="bash">journalctl -f</source>
:: paneb terminali ''journalctl'' kuulama, kirjutades välja kõik uued logiteated.
:: paneb terminali ''journalctl'' kuulama, kirjutades välja kõik uued logiteated.
----
----
Selleks, et vaadata ainult kerneli teateid on -k võti.
Selleks, et vaadata ainult kerneli teateid on '''-k''' võti.
*'''<code>journalctl -k -f | grep "IN=.*OUT=.*"</code>'''
<source lang="bash">journalctl -k -f | grep "IN=.*OUT=.*"</source>
:: näitab reaalajas kerneli logiteateid, aga filtreerib väljundit [[Grep kasutamine | ''grep'']]-iga näitamaks ''[[Iptables]]''-ile omaseid teateid.
:: näitab reaalajas kerneli logiteateid, aga filtreerib väljundit [[Grep kasutamine | ''grep'']]-iga näitamaks ''[[Iptables]]''-ile omaseid teateid.
----
----
Et vaadata kindla teenuse logiridu on olemas -u <service> võti.
Et vaadata kindla teenuse logiridu on olemas '''-u''' <service> võti.
*'''<code>journalctl -f -u pulseaudio.service</code>'''
<source lang="bash">journalctl -f -u pulseaudio.service</source>
:: näitab reaalajas ''[[Pulseaudio]]'' teenuse logisid.
:: näitab reaalajas ''[[Pulseaudio]]'' teenuse logisid.
----
----
Kui on vaja filtreerida prioriteedi järgi logisid, saab kasutada võtit -p <“emerg”, “alert”, “crit”, “err”, “warning”, “notice”, “info”, “debug”> .
Kui on vaja filtreerida prioriteedi järgi logisid, saab kasutada võtit '''-p''' <“emerg”, “alert”, “crit”, “err”, “warning”, “notice”, “info”, “debug”> .
*'''<code>journalctl -b -p crit</code>'''
<source lang="bash">journalctl -b -p crit</source>
:: näitab viimasest käivitusest kriitilise prioriteediga logisid.
või
<source lang="bash">journalctl -b -p crit..emerg</source>
:: näitab viimasest käivitusest kriitilise prioriteediga logisid või näitab viimasest käivitusest kriitilise kuni hädaolukorra prioriteediga logisid.
----
Kui on vaja näidata logisid vastupidises järjekorras alustades värskeimast saab kasutada '''-r'''.
<source lang="bash">journalctl -b -1 -r -u arno-iptables-firewall.service</source>
:: näitab eelmise käivituse [https://github.com/arno-iptables-firewall/aif Arno iptables tulemüüri] logisid alustades viimasest.
 
===Konfiguratsioonifail===
 
Tavakasutajale peaksid olema vaikimisi seaded piisavad, aga kui peaks olema tahtmist muuta ''journalctl''-i käitumist siis .conf fail asub tavapäraselt /etc/systemd/ nimega journal.conf .<ref>https://www.freedesktop.org/software/systemd/man/journald.conf.html#</ref>
 
Täpsemalt selle .conf faili valikute kohta lugeda vastavalt [https://www.freedesktop.org/software/systemd/man/journald.conf.html# man] lehelt.
<source lang="bash">
$ sudo nano /etc/systemd/journal.conf
 
#  This file is part of systemd.
#
#  systemd is free software; you can redistribute it and/or modify it
#  under the terms of the GNU Lesser General Public License as published by
#  the Free Software Foundation; either version 2.1 of the License, or
#  (at your option) any later version.
#
# Entries in this file show the compile time defaults.
# You can change settings by editing this file.
# Defaults can be restored by simply deleting this file.
#
# See journald.conf(5) for details.
 
[Journal]
#Storage=auto
#Compress=yes
#Seal=yes
#SplitMode=uid
#SyncIntervalSec=5m
#RateLimitIntervalSec=30s
#RateLimitBurst=1000
#SystemMaxUse=
#SystemKeepFree=
#SystemMaxFileSize=
#SystemMaxFiles=100
#RuntimeMaxUse=
#RuntimeKeepFree=
#RuntimeMaxFileSize=
#RuntimeMaxFiles=100
#MaxRetentionSec=
#MaxFileSec=1month
#ForwardToSyslog=no
#ForwardToKMsg=no
#ForwardToConsole=no
#ForwardToWall=yes
#TTYPath=/dev/console
#MaxLevelStore=debug
#MaxLevelSyslog=debug
#MaxLevelKMsg=notice
#MaxLevelConsole=info
#MaxLevelWall=emerg
</source>
 
==Kokkuvõtteks==
<code>journalctl</code> on mõistlik valik, leidmaks oma süsteemist või protsessist probleeme, ent ka tavapäraseks administreerimiseks ja süsteemil silma peal hoidmiseks. Hulgaliselt võtmeid väljundist otsitava leidmiseks muudavad selle programmi väga võimsaks tööriistaks, mille kasutamine ei tohiks üle jõu kellelegi käia.
 
Rohkem infot leiab <code> journalctl --help </code> ja <code> man journalctl </code>
 
==Autor==
Mart-Erki Nõumees, D21, 07.12.2016.
 
==Viited==
<references />

Latest revision as of 16:44, 7 December 2016

Sissejuhatus

journalctl on käsk Systemd logide kuvamiseks. systemd kasutab systemd-journald teenust andmete logimiseks. Teenus kogub informatsiooni kerneli teadetest üle kmsg, tavapärastest süsteemi logidest Syslog-ilt pärides, kasutades oma enda API't, süsteemi teenuste STDOUT ja STDERR-ist ja Auditd salvestustest.[1]

journalctl on väga kasulik tööriist Linuxi kasutaja varamus, sest see tsentraliseerib paljude protsesside logid ühe käsu alla olenemata nende lähteasukohast.

Journalctl

systemd-journald kirjutab vaikimisi logifaile "/var/log/journal/machine-id/" alla. Logifailide sufiks on .journal. Vigase või pooliku faili puhul .journal~. Juhul kui eelmainitud tee pole saadaval või konfiguratsioonis on nimelt nii öeldud, kirjutab teenus püsimatuid logifaile ( kestavad järgmise taaskäivituseni ) kausta "/run/log/journal/machine-id/" .

Kasutamine

Tavapäraselt näevad kõiki logifaile ainult juurkasutajad või kasutajad kes on gruppides "wheel" või "adm". Teistele kasutajatele on ainult nähtavad nende enda kasutaja privaatsed logid. Lisades kasutaja systemd-journal gruppi, võimaldab neil lugeda ka süsteemi logifaile, aga ei anna kirjutamisõigust nende failide üle.

journalctl logiread on klassifitseeritud analoogselt syslog logide katogeriseerimise protokolliga. Priority level ( Probleemide raskusastmed syslog artiklis ), näitab tähelepanu nõudmise taset, ja Facility on kood mis näitab mis tüüpi protsessilt logirida pärit on.

journalctl väljund kuvatakse kasutades Less-i. Kriitilised read on värvitud punaseks ja muidu tähelepanu võibolla vajavad read on tavapärasest eredamas tekstis.

Sisestades oma soovitud terminali emulaatorisse käsu journalctl kuvatakse kõik logid, millel on kasutajal lugemisõigus. Ilma lisaparameetriteta võib järgnev väljund olla väga raskesti loetav, sest olenevalt Linuxi kasutusest, konfiguratsioonifailis sätitud logifailide kõvakettakasutuse piirangutest ja logide hoidmise ajalisest piirangust, võib väljund olla väga pikk ulatudes tavapärase kasutuse puhul mitmete miljonite ridadeni.

Väljundi filtreerimine

Filtreerimaks väljundit on olemas mitmeid võtmeid, millest kasulikumad järgnevad :[2]


journalctl -b
tagastab terve logi viimasest käivitusest saadik

-b võtmele võib lisada järgi arvu, mis näitab mitmenda käivituse logi näidata kronoloogilises järjekorras.

journalctl -b 1
tagastab esimese käivituse logi, mis on logiraamatus saadaval

Kui anda -b võtmele miinusmärgiga arv siis tagastatakse praegusest nii mitmes tahapoole jääv logi kui miinusmärgi järel arv.

journalctl -b -2
tagastab praegusest kahe võrra tahapoole jääv logi, ehk üleeelmise.

journalctl-il on ka --since ( -S ) ja --until ( -U ) võtmed, millega saab filtreerida väljundit näitamaks logiridu mingist ajast alates kuni mingi ajani.

journalctl --since "20 min ago"

või

journalctl --since="2016-12-01 12:01:01" --until "2016-12-08"
tagastab logi alates 20 minutit tagasi või alates esimesest detsembrist 2016 (soovi korral võib kellaaja ka määrata, vaikimisi 00:00:00) kuni kaheksanda detsembrini.

Jälgimaks uusi sissetulevaid teateid reaalajas võib kasutada -f võtit.

journalctl -f
paneb terminali journalctl kuulama, kirjutades välja kõik uued logiteated.

Selleks, et vaadata ainult kerneli teateid on -k võti.

journalctl -k -f | grep "IN=.*OUT=.*"
näitab reaalajas kerneli logiteateid, aga filtreerib väljundit grep-iga näitamaks Iptables-ile omaseid teateid.

Et vaadata kindla teenuse logiridu on olemas -u <service> võti.

journalctl -f -u pulseaudio.service
näitab reaalajas Pulseaudio teenuse logisid.

Kui on vaja filtreerida prioriteedi järgi logisid, saab kasutada võtit -p <“emerg”, “alert”, “crit”, “err”, “warning”, “notice”, “info”, “debug”> .

journalctl -b -p crit

või

journalctl -b -p crit..emerg
näitab viimasest käivitusest kriitilise prioriteediga logisid või näitab viimasest käivitusest kriitilise kuni hädaolukorra prioriteediga logisid.

Kui on vaja näidata logisid vastupidises järjekorras alustades värskeimast saab kasutada -r.

journalctl -b -1 -r -u arno-iptables-firewall.service
näitab eelmise käivituse Arno iptables tulemüüri logisid alustades viimasest.

Konfiguratsioonifail

Tavakasutajale peaksid olema vaikimisi seaded piisavad, aga kui peaks olema tahtmist muuta journalctl-i käitumist siis .conf fail asub tavapäraselt /etc/systemd/ nimega journal.conf .[3]

Täpsemalt selle .conf faili valikute kohta lugeda vastavalt man lehelt.

$ sudo nano /etc/systemd/journal.conf

#  This file is part of systemd.
#
#  systemd is free software; you can redistribute it and/or modify it
#  under the terms of the GNU Lesser General Public License as published by
#  the Free Software Foundation; either version 2.1 of the License, or
#  (at your option) any later version.
#
# Entries in this file show the compile time defaults.
# You can change settings by editing this file.
# Defaults can be restored by simply deleting this file.
#
# See journald.conf(5) for details.

[Journal]
#Storage=auto
#Compress=yes
#Seal=yes
#SplitMode=uid
#SyncIntervalSec=5m
#RateLimitIntervalSec=30s
#RateLimitBurst=1000
#SystemMaxUse=
#SystemKeepFree=
#SystemMaxFileSize=
#SystemMaxFiles=100
#RuntimeMaxUse=
#RuntimeKeepFree=
#RuntimeMaxFileSize=
#RuntimeMaxFiles=100
#MaxRetentionSec=
#MaxFileSec=1month
#ForwardToSyslog=no
#ForwardToKMsg=no
#ForwardToConsole=no
#ForwardToWall=yes
#TTYPath=/dev/console
#MaxLevelStore=debug
#MaxLevelSyslog=debug
#MaxLevelKMsg=notice
#MaxLevelConsole=info
#MaxLevelWall=emerg

Kokkuvõtteks

journalctl on mõistlik valik, leidmaks oma süsteemist või protsessist probleeme, ent ka tavapäraseks administreerimiseks ja süsteemil silma peal hoidmiseks. Hulgaliselt võtmeid väljundist otsitava leidmiseks muudavad selle programmi väga võimsaks tööriistaks, mille kasutamine ei tohiks üle jõu kellelegi käia.

Rohkem infot leiab journalctl --help ja man journalctl

Autor

Mart-Erki Nõumees, D21, 07.12.2016.

Viited