quick-docs/modules/ROOT/pages/_partials/proc_log-files-command-line.adoc
hector louzao ef70ecd8f2
Review "view logs on Fedora" quick-doc
- Remove Caution
- Review and Check View Log Information via Systemctl
- Add Using journalctl to View Log Information for a Specific Service
- Add to know more about systemd -> understanding-and-administering-systemd
- Sections can be moved up one level replaceing rsyslog
- Improve con_viewing-logs.adoc with adding some usefull information
- Change in using nano and vim to you can use favourite text editor
- Remove rsyslog completly
- Add -b and --list-boots if the user needs flter log messages for the current boot or view old log's
- instead of using bold for commands and file/folder names, maybe make them monospace too. That does'nt work in _NOTE_
- "Using the command line to open log files in a text editor" -> "Use a text editor" as a separate section.
- Observe a Warning when editing view_log.adoc and there is a PR in ASCCIDOCTOR
https://github.com/asciidoctor/asciidoctor/issues/2855.

[Ticket: 107] - https://pagure.io/fedora-docs/quick-docs/issue/107
2019-04-05 11:45:08 +01:00

97 lines
3.2 KiB
Text

[id='using-the-command-line-to-view-log-files]
= Using the command line to view log files
You can use the command line to view logs in different ways, for example:
* Using the `*Journalctl*` command
* Using the commands for viewing, for example `*cat*`, `*more*`, `*less*`, `*tail*`, or `*head*`
* Combine the commands for viewing with the `*grep*` command
* Using any kind of CLI/GUI editor.
[id='using-journalctl-to-view-system-information']
== Using journalctl to view system information.
* To view all collected logs with no filter:
----
$ journalctl
----
* To view a specific log file, enter the `*journalctl*` command with a log filepath. The example command returns all logs of the kernel device node `/dev/sda`:
----
$ journalctl /dev/sda
----
* To view the boot logs, run the following command:
----
$ journalctl -k -b -1
----
[id='using-journalctl-to-view-log-information-for-a-specific-service']
== Using Journalctl to View Log Information for a Specific Service
* To view the current Boot log use the `-b` option :
* To view, With one match specified, all entries with a field matching the expression are shown:
----
$ journalctl -b _SYSTEMD_UNIT=foo
----
* To view, If two different fields are matched, only entries matching both expressions at the same time are shown:
----
$ journalctl -b _SYSTEMD_UNIT=foo _PID=number
----
* To view If two matches refer to the same field, all entries matching either expression are shown:
----
$ journalctl -b _SYSTEMD_UNIT=foo _SYSTEMD_UNIT=foo1
----
* To view, If the separator "+" is used, two expressions may be combined in a logical OR. The following will show all messages from the `*foo*` service process with the `*PID*` plus all messages from the `*foo1*` service (from any of its processes):
----
$ journalctl -b _SYSTEMD_UNIT=foo _PID=number + _SYSTEMD_UNIT=foo1
----
NOTE: The files for service modification are stored in a directory within `*/etc/systemd/system*`, to know more about systemd <<understanding-and-administering-systemd.adoc#,Understanding Systemd Services>>
[id='Using-journalctl-to-view-older-logs']
== Using Journalctl to View Older Logs
* To view older logs use the `--list-boots` option :
Show a tabular list of boot numbers, their IDs, and the timestamps of the first and last message pertaining to the boot.
Example :
----
$ journalctl --list-boots
-8 42cdeac65d494e938b9cb92f315b08a4 Mon 2018-11-12 10:36:42 CET—Mon 2018-11-12 20:08:24 CET
-7 c110d2b8705345b786fe310de628bfc7 Tue 2018-11-13 10:29:27 CET—Tue 2018-11-13 10:04:00 CET
----
with this ID you can use `*journalctl*` as usual :
----
$ journalctl --boot=ID _SYSTEMD_UNIT=foo
----
* To know more about `*journalctl*`, read the man page:
----
$ man journalctl
----
[id='using-any-kind-CLI/GUI-editor-for-view-logs']
== Using any kind of CLI/GUI editor for View-Logs
All logs are plain text, so you can use diferent utils to view them.
[id='using-CLI-editor-in-Terminal']
=== Using any CLI editor in Terminal
* To open, Just use (nano/pico/vim/nvim/emacs) for name a few.
[id='using-GUI-editor-in-terminal']
=== Using any GUI editor in Terminal
* To open, Just use (gvim/gedit/geany) for name a few.
NOTE: Both method usually requires `*sudo*` access.