<div class="post-toc-block float-default with-border"> 
						<div class="post-toc-header">Table of Contents</div>
						<nav id="md-post-toc" class="md-post-toc"></nav>
						</div><p>Logging is an integral part of software development, providing developers with valuable insights into the behaviour and performance of their applications. In the Go programming language, various logging libraries, such as the standard library&#8217;s <code>log</code> package or <a href="https://keploy.io/blog/community/how-i-simulated-a-response-from-a-third-party-app">third-party</a> options like <code>logrus</code> , <code>zap</code> and <code>zerolog</code>, facilitate the generation of log output. While the primary goal of logging is to convey information, the traditional black-and-white log messages can sometimes make it challenging to quickly discern critical information amidst a sea of logs.</p>
<h2>Need for colouring logs</h2>
<p><strong>Prioritisation and Highlighting:</strong> colour can be used to prioritise and highlight critical information. For example, error messages or warning logs can be displayed in attention-grabbing colours like red or yellow, making it immediately apparent when an issue requires urgent attention. This facilitates a faster response to potential problems.<br />
<strong>Enhanced Readability:</strong> colours can improve the overall readability of log messages by adding structure and visual hierarchy. Differentiating between log levels, timestamps, and contextual information becomes more intuitive, leading to a more user-friendly experience during log analysis and troubleshooting.<br />
<strong>User-Friendly Debugging:</strong> Developers spend a considerable amount of time interacting with logs during <a href="https://aws.amazon.com/what-is/debugging/#:~:text=Debugging%20is%20the%20process%20of,determine%20why%20any%20errors%20occurred.">debugging</a>. colour logging contributes to a more user-friendly debugging experience by allowing developers to quickly spot relevant information, errors, or patterns in log outputs, thereby expediting the debugging process.</p>
<h3>Support for colouring log level keywords</h3>
<p>Nearly all logging libraries offer the option to enable colorization for log level keywords such as info, debug, warning and error.<br />
In the case of Zap, you can use the <code>CapitalColorLevelEncoder</code> function to achieve this effect.<br />
Here&#8217;s an example of how you might configure Zap to enable colourised log levels:</p>
<pre><code class="language-go">
logCfg := zap.NewDevelopmentConfig()
logCfg.EncoderConfig.EncodeLevel = zapcore.CapitalColorLevelEncoder</code></pre>
<h3>Contextual Logs</h3>
<p>In complicated systems and tricky debugging situations, it&#8217;s crucial to add extra details to log messages. This additional information, like variable values, timestamps, and user IDs, helps developers grasp what&#8217;s happening in the application at specific times. Contextual logging jazzes up log messages by connecting them to dynamic key-value pairs, giving more flexibility than sticking to fixed formats. This method is super helpful during debugging, making it quicker to find the main issues and understand how the program is running.<br />
<em>Note: To follow along,</em></p>
<ol>
<li><em>create a</em><code>color-logs</code><em>directory by running</em><code>mkdir color-logs</code> and <code>cd color-logs</code> to change directory.</li>
<li><em>Start a module by running</em><code>go mod init example.com/color-logs</code><em>, here we have used &#8220;example.com/color-logs&#8221; as a module path.</em></li>
<li><em>In your text editor, create a file in which to write your code and call it</em><code>main.go</code><em>.</em></li>
<li><em>Ensure that you fetch the necessary dependencies by running</em><code>go get</code><em>before executing</em><code>go run main.go</code><em>.</em></li>
</ol>
<p>Here is an example of how you can display contextual logs in zerolog logging libraries:</p>
<pre><code class="language-go">
package main
import "github.com/rs/zerolog/log"
func main() {
log.Debug().
Str("Scale", "833 cents").
Float64("Interval", 833.09).
Msg("Fibonacci is everywhere")
}
// output:
// {"level":"debug","Scale":"833 cents","Interval":833.09,"time":"2024-01-24T22:01:03+05:30","message":"Fibonacci is everywhere"}</code></pre>
<h3>Lack of native support to colour contextual logs</h3>
<p>While contextual logging provides a powerful means of enhancing information, the visual representation of this context often remains monochromatic. Unfortunately, many logging libraries do not inherently support the colorization of key and value components within log entries. This absence leaves developers with a missed opportunity to leverage visual cues for quick identification and differentiation of critical information, hindering the efficiency of log analysis and debugging processes.<br />
lets see what will happen if we try to add colour to context log in zap :</p>
<pre><code class="language-go">
package main
import (
"github.com/fatih/color"
"go.uber.org/zap"
)
func main() {
PlainLogger, _:= zap.NewDevelopment()
var HighlightGreen = color.New(color.FgGreen).SprintFunc()
PlainLogger.Info("test log", zap.String(HighlightGreen("key"), "value"))
}</code></pre>
<p>The output generated would be:<br />
<code>2024-01-24T22:23:16.356+0530 INFO zap-logging/main.go:66 test log {&quot;\u001b[32mkey\u001b[0m&quot;: &quot;value&quot;}</code><br />
The reason why the ANSI escape code for colour formatting are not interpreted is because of the way the <code>EncoderEntry</code> function is implemented in <code>zapcore</code> package.<br />
We will now discuss how to solve this misinterpretation.</p>
<h3>Colouring contextual logs</h3>
<p>The primary cause of the mentioned problem lies with the default encoder, which can be either &quot;json&quot; or &quot;console.&quot; To address this, we&#8217;ll begin by crafting our own encoder.</p>
<ol>
<li>Lets create a custom encoder named <code>colorConsoleEncoder</code> will be initialized by <code>NewColorConsole</code>:</li>
</ol>
<pre><code class="language-go">
type colorConsoleEncoder struct {
*zapcore.EncoderConfig
zapcore.Encoder
}

func NewColorConsole(cfg zapcore.EncoderConfig) (enc zapcore.Encoder) {
return colorConsoleEncoder{
EncoderConfig: &amp;cfg,
// Using the default ConsoleEncoder can avoid rewriting interfaces such as ObjectEncoder
Encoder: zapcore.NewConsoleEncoder(cfg),
}
}</code></pre>
<ol start="2">
<li>We will then register our encoder using <code>RegisterEncoder</code> function</li>
</ol>
<pre><code class="language-go">
func init() {
_ = zap.RegisterEncoder("colorConsole", func(config zapcore.EncoderConfig) (zapcore.Encoder, error) {
return NewColorConsole(config), nil
})
}</code></pre>
<ol start="3">
<li>The misinterpretation issue discussed earlier is associated with the <code>EncodeEntry</code> function within the <a href="https://pkg.go.dev/go.uber.org/zap/zapcore#Encoder"><code>Encoder</code></a> interface of the <code>zapcore</code> package. To address this, it is necessary to override this function.</li>
</ol>
<pre><code class="language-go">
// EncodeEntry overrides ConsoleEncoder's EncodeEntry
func (c colorConsoleEncoder) EncodeEntry(ent zapcore.Entry, fields []zapcore.Field) (buf *buffer.Buffer, err error) {
buff, err := c.Encoder.EncodeEntry(ent, fields) // Utilize the existing implementation of zap
if err != nil {
return nil, err
}

bytesArr := bytes.Replace(buff.Bytes(), []byte("\\u001b"), []byte("\u001b"), -1)
buff.Reset()
buff.AppendString(string(bytesArr))
return buff, err
}</code></pre>
<p>This function will utilize the existing <code>EncodeEntry</code> implementation from the embedded <code>Encoder</code> field but introduces a correction using <code>bytes.Replace</code>. The aim is to replace occurrences of &quot;\u001b&quot; (which represent a literal backslash followed by the characters &quot;u001b&quot;) with the ANSI escape code &quot;\u001b&quot; (representing the escape character). This adjustment ensures accurate handling of ANSI escape codes during log entry encoding, allowing for the intended colorization without disrupting the overall logging system functionality.</p>
<ol start="4">
<li>we can now create a <code>setupLogger</code> function that utilizes the registered encoder and produces a logger with colorization.</li>
</ol>
<pre><code class="language-go">
func setupLogger() *zap.Logger {
logCfg := zap.NewDevelopmentConfig()

logCfg.Encoding = "colorConsole"

logger, _ := logCfg.Build()
return logger
}</code></pre>
<ol start="5">
<li>Write a Log to see the effect</li>
</ol>
<pre><code class="language-go">
func main() {
ColorLogger := setupLogger()
var HighlightGreen = color.New(color.FgGreen).SprintFunc()
var HighlightYellow = color.New(color.FgYellow).SprintFunc()
ColorLogger.Info("test log", zap.String(HighlightGreen("key"), HighlightYellow("value")))
}</code></pre>
<p><img loading="lazy" decoding="async" class="aligncenter size-full wp-image-1138" src="https://wp.keploy.io/wp-content/uploads/2024/05/9163e20b-81c2-4261-bf4e-828dfc12.webp" alt="" width="781" height="20" srcset="https://wp.keploy.io/wp-content/uploads/2024/05/9163e20b-81c2-4261-bf4e-828dfc12.webp 781w, https://wp.keploy.io/wp-content/uploads/2024/05/9163e20b-81c2-4261-bf4e-828dfc12-300x8.webp 300w, https://wp.keploy.io/wp-content/uploads/2024/05/9163e20b-81c2-4261-bf4e-828dfc12-768x20.webp 768w" sizes="auto, (max-width: 781px) 100vw, 781px" /></p>
<p>To run the full code, execute the following commands in your terminal:</p>
<pre><code class="language-bash">
git clone https://github.com/AkashKumar7902/coloring-log-output
cd coloring-log-output
go run main.go</code></pre>
<p>While we&#8217;ve specifically covered this aspect for the Zap logging library, comparable solutions can be identified for other logging libraries as well 🙂<br />
Thank you and Happy colouring 🎨 !</p>
<h2>FAQ&#8217;s</h2>
<h3><strong>Can I color code log messages in Go?</strong></h3>
<p>Yes, coloring log messages improves readability and helps prioritize critical information. Popular libraries like Zap and zerolog offer built-in support or allow customization through custom encoders.</p>
<h3><strong>Should i add coloring to contextual logs?</strong></h3>
<p>Coloring contextual logs (key-value pairs) makes debugging faster. You can easily spot relevant details and differentiate between values, leading to quicker problem identification.</p>
<h3><strong>How do I create a custom encoder for coloring logs?</strong></h3>
<p>While some libraries offer colorization by default, you can create a custom encoder to achieve more control. This typically involves overriding the <code>EncodeEntry</code> function to handle ANSI escape codes correctly.</p>

         
        
                    

                    
                    <div class="pp-multiple-authors-boxes-wrapper pp-multiple-authors-wrapper pp-multiple-authors-layout-boxed multiple-authors-target-the-content box-post-id-16 box-instance-id-1 ppma_boxes_16"
                    data-post_id="16"
                    data-instance_id="1"
                    data-additional_class="pp-multiple-authors-layout-boxed.multiple-authors-target-the-content"
                    data-original_class="pp-multiple-authors-boxes-wrapper pp-multiple-authors-wrapper box-post-id-16 box-instance-id-1">
                                                                                    <h2 class="widget-title box-header-title">Author</h2>
                                                                            <span class="ppma-layout-prefix"></span>
                        <div class="ppma-author-category-wrap">
                                                                                                <span class="ppma-category-group ppma-category-group-">
                                                                                                                        <ul class="pp-multiple-authors-boxes-ul">
                                                                                                                                                                                                                                                                                                                                                                                                                    <li class="pp-multiple-authors-boxes-li author_index_0 author_akash-kumar has-avatar">
                                                                                                                                                                                                                                            <div class="pp-author-boxes-avatar">
                                                                                                                                            <img alt='Akash Kumar' src='https://wp.keploy.io/wp-content/uploads/2024/10/Gravatar-Logo.jpg' srcset='https://wp.keploy.io/wp-content/uploads/2024/10/Gravatar-Logo.jpg' class='multiple_authors_guest_author_avatar avatar' height='80' width='80'/>                                                                                                                                    </div>
                                                            
                                                            <div class="pp-author-boxes-avatar-details">
                                                                                                                                                                                                <div class="pp-author-boxes-name multiple-authors-name">
                                                                        <a href="https://wp.keploy.io/author/akash-kumar/" rel="author" title="Akash Kumar" class="author url fn">Akash Kumar</a> 
                                                                    </div>
                                                                                                                                                                                                                                                                    <p class="pp-author-boxes-description multiple-authors-description">
                                                                                                                                            </p>
                                                                                                                                
                                                                                                                                
                                                                                                                            </div>
                                                                                                                                                                                                                                                                                                                                                                                                             </li>
                                                                                                                                                                                                                                    </ul>
                                                                            </span>
                                                                                    </div>
                    <span class="ppma-layout-suffix"></span>
                    </div>
                    
                    
                
                                <style>
                .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .pp-author-boxes-avatar img { width: 80px !important; height: 80px !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .pp-author-boxes-avatar img { border-style: none !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .pp-author-boxes-avatar img { border-radius: 50% !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .pp-author-boxes-meta a { background-color: #655997 !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .pp-author-boxes-meta a { color: #ffffff !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .pp-author-boxes-meta a:hover { color: #ffffff !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .ppma-author-user_email-profile-data { background-color: #655997 !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .ppma-author-user_email-profile-data { border-radius: 100% !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .ppma-author-user_email-profile-data { color: #ffffff !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .ppma-author-user_url-profile-data { background-color: #655997 !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .ppma-author-user_url-profile-data { border-radius: 100% !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .ppma-author-user_url-profile-data { color: #ffffff !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .pp-author-boxes-recent-posts-title { border-bottom-style: dotted !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .pp-multiple-authors-boxes-li { border-style: solid !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .pp-multiple-authors-boxes-li { border-width: 1px !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .pp-multiple-authors-boxes-li { border-color: #999 !important; } .pp-multiple-authors-boxes-wrapper.box-post-id-16.pp-multiple-authors-layout-boxed.multiple-authors-target-the-content.box-instance-id-1 .pp-multiple-authors-boxes-li { color: #3c434a !important; }             </style>

Adding colour to the log output of logging libraries in Go

Getting Started with Alpha Testing : Definition, Process, and Key Benefits

What Does Enumerate Mean in Python

Getting started with Selenium IDE

Introduction to Gitlab Python API

LLM TXT Generator: Why the llms.txt File Matters and How to Use Effectively

Agile Testing Best Practices for Faster, Higher‑Quality Releases

Why You Need an AI Code Checker

Building Keploy.io, an EBPF based open source framework to generate test cases and data stubs from API calls.

Neha Gupta

Cloud technology veteran and probably the youngest (globally) to have completed all 5 AWS certifications (including Solutions architect Professional and Dev­ops engineer professional)

Adding Colour To The Log Output Of Logging Libraries In Go

More Stories