go-logkeycheck

Lint Go programs that use the go.uber.org/zap or planetscale/log, or assetnote/cs-core-go/v2/pkg/log loggers to ensure log field names are consistent.

This also validates that the log types are consistent for a given label, to ensure that downstream logging aggregation doesn't have type conflicts

Current linting rules:

1. Log field names should be snake_case.
2. Any type logging should not be used
3. Log field names and types should be consistent

This was forked from github.com/planetscale/go-logkeycheck given the similar structure and nature of the check.

Install

Install latest:

go install github.com/assetnote/go-logkeycheck@latest

Or specify a version:

go install github.com/assetnote/[email protected]

Refer to github releases for a list of available versions.

Example

Assume we have the following file:

package main

import (
  "github.com/planetscale/log"
  // "go.uber.org/zap" is also supported
)

func main() {
  logger := log.NewPlanetScaleLogger()
  defer logger.Sync()

  logger.Info("info log with fields",
    log.String("user_id", "12345678"),
    log.String("branchId", "abcdefghijkl"),
  )

  logger.Info("info log with fields",
    log.Int("user_id", 12345678),
  )

Run go-logkeycheck to check if our log fields are in the correct format:

$ go-logkeycheck ./...
main.go:13:17: log key 'branchId' should be snake_case.
main.go:18:17: log key 'branchId' has conflicting types: Int: 1, String: 1

Usage

Run the linter on a file, directory, or Go package:

go-logkeycheck foo.go # lint a single file
go-logkeycheck ./...  # recursively lint all files

golangci-lint plugin support

Support for running in plugin mode is experimental.

The linter can be compiled as a plugin for golangci-lint.

You will need to compile a CGO_ENABLED=1 version of golangci-lint. The official binaries are not compatible with plugins.

Run make build-plugin to generate the plugin object go-logkeycheck.so.

Include the following in your golangci.yml file:

linters-settings:
  custom:
    logkeycheck:
      path: ./go-logkeycheck.so

linters:
  enable:
    - logkeycheck

Credits

This tool is built on top of the go/analysis package that makes it easy to write customer linters in Go.

If you are interested in writing a linter for Go check out these excellent resources which were invaluable in writing this tool:

• @fatih's Using go/analysis to write a custom linter
• Custom linter plugins for golangci-lint