echozap

README

echozap

Middleware for Golang Echo framework that provides integration with Uber´s Zap logging library for logging HTTP requests.

Pre-requisites

• Go with Go modules enabled.
• Echo v4
• Zap

Usage

package main

import (
	"net/http"

	"github.com/brpaz/echozap"
	"github.com/labstack/echo/v4"
	"go.uber.org/zap"
)

func main() {
	e := echo.New()

	zapLogger, _ := zap.NewProduction()

	e.Use(echozap.ZapLogger(zapLogger))

	e.GET("/", func(c echo.Context) error {
		return c.String(http.StatusOK, "Hello, World!")
	})
	e.Logger.Fatal(e.Start(":1323"))
}

Logged details

The following information is logged:

• Status Code
• Time
• Uri
• Method
• Hostname
• Remote IP Address

Todo

• Add more customization options.

🤝 Contributing

Contributions, issues and feature requests are welcome!

Show your support

If this project have been useful for you, I would be grateful to have your support.

Give a ⭐️ to the project, or just:

Author

👤 Bruno Paz

• Website: https://github.com/brpaz
• Github: @brpaz

📝 License

Copyright © 2019 Bruno Paz.

This project is MIT licensed.

Documentation

Index

• Variables
• func DefaultSkipper(echo.Context) bool
• func ZapLogger(log *zap.Logger) echo.MiddlewareFunc
• func ZapLoggerWithConfig(log *zap.Logger, config Config) echo.MiddlewareFunc
• type Config
• type Skipper

Variables

var DefaultConfig = Config{
	Skipper:     DefaultSkipper,
	ContextKeys: nil,
	PrintBody:   true,
}

Functions

func DefaultSkipper

func DefaultSkipper(echo.Context) bool

DefaultSkipper returns false which processes the middleware.

func ZapLogger

func ZapLogger(log *zap.Logger) echo.MiddlewareFunc

ZapLogger is a middleware and zap to provide an "access log" like logging for each request.

func ZapLoggerWithConfig

func ZapLoggerWithConfig(log *zap.Logger, config Config) echo.MiddlewareFunc

Types

type Config

type Config struct {
	// Skipper defines a function to skip middleware.
	Skipper Skipper

	// ContextKeys defines the keys which should be added to the logger, as fields, from the context.
	ContextKeys []interface{}

	// PrintBody defines if the body of the request should be printed, if it exists.
	PrintBody bool
}

type Skipper

type Skipper func(echo.Context) bool