logger

Super simple structured logging mechanism for Go projects with Stackdriver format compatibility

Installation

go get -u github.com/macuenca/logger

Usage

package main

import (
    "github.com/macuenca/logger"
)

// There should be a LOG_LEVEL environment variable set, which is read by the library
// If no value is set, the default LOG_LEVEL will be INFO

func main() {
    // Stackdriver requires a project name and   version to be set. Use your environment for these values.
    // SERVICE should be your GCP project-id, e.g. robokiller-146813
    // VERSION is an arbitrary value
    log := log.New()

    // You can also initialize the logger with a context, the values will persisted throughout the scope of the logger instance
    log := log.New().With(log.Fields{
        "user": "+1234567890",
        "action": "create-account",
    })

    // A metric is an INFO log entry without a payload
    log.Metric("CUSTOM_METRIC_ENTRY")

    // Log a DEBUG message, only visible in when LOG_LEVEL is set to DEBUG
    log.With(log.Fields{"key":"val"}).Debug("debug message goes here")
    log.With(log.Fields{"key":"val"}).Debugf("debug message with %s", param)

    // Log an INFO message
    log.With(log.Fields{"key":"val"}).Info("info message goes here")
    log.With(log.Fields{"key":"val"}).Infof("info message with %s", param)

    // Log a WARN message
    log.With(log.Fields{"key":"val"}).Warn("warn message goes here")
    log.With(log.Fields{"key":"val"}).Warnf("warn message with %s", param)

    // Error() prints the stacktrace as part of the payload for each entry and sends the
    // data to Stackdriver Error Reporting service
    log.With(log.Fields{"key":"val"}).Error("error message goes here")
    log.With(log.Fields{"key":"val"}).Errorf("error message with %s", param)
}