5 MIN READ
The Linux Foundation | 26 March 2022
This is a classic article written by Jack Wallen from theLinux.comarchives. For more great SysAdmin tips and techniques check out our free intro to Linux course. At some point in your career as a Linux administrator, you are going to have to view log files. After all, they are there for one very important reason…to help you troubleshoot an issue. In fact, every seasoned administrator will immediately tell you that the first thing to be done, when a problem arises, is to view the logs. And there are plenty of logs to be found: logs for the system, logs for the kernel, for package managers, for Xorg, for the boot process, for Apache, for MySQL… For nearly anything you can think of, there is a log file. Most log files can be found in one convenient location:/var/log. These are all system and service logs, those which you will lean on heavily when there is an issue with your operating system or one of the major services. For desktop app-specific issues, log files will be written to different locations (e.g., Thunderbird writes crash reports to ‘~/.thunderbird/Crash Reports’). Where a desktop application will write logs will depend upon the developer and if the app allows for custom log configuration.
We are going to be focus on system logs, as that is where the heart of Linux troubleshooting lies. And the key issue here is, how do you view those log files?
Fortunately there are numerous ways in which you can view your system logs, all quite simply executed from the command line.
/var/log
This is such a crucial folder on your Linux systems. Open up a terminal window and issue the commandcd /var/log. Now issue the commandlsand you will see the logs housed within this directory (Figure 1).
Now, let’s take a peek into one of those logs.
Viewing logs withless
One of the most important logs contained within/var/logissyslog.This particular log file logs everything except auth-related messages. Say you want to view the contents of that particular log file. To do that, you could quickly issue the commandless/var/log/syslog. This command will open thesysloglog file to the top. You can then use the arrow keys to scroll down one line at a time, the spacebar to scroll down one page at a time, or the mouse wheel to easily scroll through the file.
The one problem with this method is thatsyslogcan grow fairly large; and, considering what you’re looking for will most likely be at or near the bottom, you might not want to spend the time scrolling line or page at a time to reach that end. Willsyslogopen in thelesscommand, you could also hit the [Shift]+[g] combination to immediately go to the end of the log file. The end will be denoted by (END). You can then scroll up with the arrow keys or the scroll wheel to find exactly what you want.
This, of course, isn’t terribly efficient.
Viewing logs with dmesg
Thedmesgcommand prints the kernel ring buffer. By default, the command will display all messages from the kernel ring buffer. From the terminal window, issue the commanddmesgand the entire kernel ring buffer will print out (Figure 2).
Fortunately, there is a built-in control mechanism that allows you to print out only certain facilities (such asdaemon).
Say you want to view log entries for the user facility. To do this, issue the commanddmesg –facility=user. If anything has been logged to that facility, it will print out.
Unlike thelesscommand, issuingdmesgwill display the full contents of the log and send you to the end of the file. You can always use your scroll wheel to browse through the buffer of your terminal window (if applicable). Instead, you’ll want to pipe the output ofdmesgto thelesscommand like so:
dmesg | less
The above command will print out the contents ofdmesgand allow you to scroll through the output just as you did viewing a standard log with thelesscommand.
Viewing logs with tail
Thetailcommand is probably one of the single most handy tools you have at your disposal for the viewing of log files. What tail does is output the last part of files. So, if you issue the commandtail /var/log/syslog,it will print out only the last few lines of thesyslogfile.
But wait, the fun doesn’t end there. The tail command has a very important trick up its sleeve, by way of the -foption. When you issue the command tail -f /var/log/syslog, tailwill continue watching the log file and print out the next line written to the file. This means you can follow what is written tosyslog, as it happens, within your terminal window (Figure 3).
Using tailin this manner is invaluable for troubleshooting issues.
To escape thetailcommand (when following a file), hit the [Ctrl]+[x] combination.
You can also instruct tail to only follow a specific amount of lines. Say you only want to view the last five lines written tosyslog; for that you could issue the command:
tail -f -n 5 /var/log/syslog
The above command would follow input tosyslogand only print out the most recent five lines. As soon as a new line is written tosyslog,it would remove the oldest from the top. This is a great way to make the process of following a log file even easier. I strongly recommend not using this to view anything less than four or five lines, as you’ll wind up getting input cut off and won’t get the full details of the entry.
There are other tools
You’ll find plenty of other commands (and even a few decent GUI tools) to enable the viewing of log files. Look tomore, grep, head, cat, multitail,andSystem Log Viewerto aid you in your quest to troubleshooting systems via log files.
Advance your career withLinux system administrationskills. Check out theEssentials of System Administration coursefrom The Linux Foundation.