If you run your application on a server, you need to write your application log to a file. It will help you debug and analyze your application. A good log file will tell you what the error is, when it happened, and where it is come from. This article will show you how to write logs to a file in Go.
Why write logs to a file?
The log is how an application tells its story to the engineer. It keeps track of the events that happened to the application. As an engineer, you need to monitor your application log, especially the error log. An application that runs in the production or even staging environment needs to write the logs to a file. It is to make it easier to find the log and see the logs that are only important to you. It can help you determine whether the error is critical or not. A good log also helps you find the root cause of the error faster.
How to write the log to a file
To write the logs to a file in Go, we need to open a file first and then set the log output to the file. Let’s see the example code below.
openLogFilewhich is written on line 19. The function is to open a file in the OS at the given file location path. We do this by calling the function
os.OpenFile. The function needs parameters that are file location, flags, and file permission.
The flags that we use are:
- os.O_WRONLY: open the file write-only
- os.O_APPEND: append data to the file when writing.
- os.O_CREATE: create a new file if none exists.
And the file is given permission
644 when created. If you want to read more about file permission, you can read here.
On line 13, we set the log output to the that we have opened.
On line 14, we set flags to the logs, so that it shows the date and time, and the line of code that writes the log.
Below is a sample of the log produced.
2021/10/10 02:38:37.129447 main.go:16: log file created
There we can see
main.go:16 is the code that calls log.Println. It is only written the filename because we used flag
log.Lshortfile. If you need the complete path of the code, you can use
Separate logs file
Sometimes we want to separate the file of the logs based on the event that cause it. A sample case is we separate error logs and info logs. We can do this by creating separate loggers for errors and info. See code below.
The result log will be like this.
[info]2021/10/10 03:36:38.734009 main.go:15: this is info
[error]2021/10/10 03:36:38.735311 main.go:23: this is error
Writing logs to a file is important so that we can see the events that happened to our application. It can be done by setting the output of the logs. We can separate logs into different files to make them easier to monitor.