The Complete Production SOP: How to Deploy and Run zerolog JSON Logger with Dedicated Zero-Allocation API in Autonomous AI Agents

---
name: "zerolog-zero-allocation-json-logger"
description: "Produce human-readable development logs and zero-allocation JSON logs with zerolog."
metadata:
  author: "Olivier Poitrey"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "configure zerolog"
  - "zerolog pretty console writer"
  - "contextual logger zerolog"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# zerolog JSON Logger with Dedicated Zero-Allocation API

Configures rs/zerolog: chaining fluent logging APIs (log.Info().Str('key', 'val').Msg('...')), global log level filtering, contextual loggers (logger.With()), and ConsoleWriter for pretty colored terminal output.

## When to Invoke
Invoke this skill whenever you need to:
- configure zerolog
- zerolog pretty console writer
- contextual logger zerolog

## Execution SOP & Rules
1. Initialize: zerolog.TimeFieldFormat = zerolog.TimeFormatUnix; log.Logger = log.Output(os.Stderr).
2. Fluent logging: log.Info().Str('service', 'billing').Int('retry', 2).Msg('Processing payment').
3. Create contextual sub-logger: sublogger := log.With().Str('component', 'auth').Logger().
4. Pretty print in development: log.Logger = log.Output(zerolog.ConsoleWriter{ Out: os.Stderr }).

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.

package telemetry

import (
	"io"
	"os"
	"time"

	"github.com/rs/zerolog"
	"github.com/rs/zerolog/log"
)

// InitLogger provisions the global or scoped zerolog instance.
func InitLogger(env string) zerolog.Logger {
	zerolog.TimeFieldFormat = time.RFC3339Nano

	var output io.Writer = os.Stderr
	if env == "development" {
		output = zerolog.ConsoleWriter{
			Out:        os.Stderr,
			TimeFormat: "15:04:05.000",
		}
	}

	logger := zerolog.New(output).With().Timestamp().Caller().Logger()
	log.Logger = logger
	return logger
}

package telemetry_test

import (
	"io"
	"testing"

	"github.com/rs/zerolog"
)

func BenchmarkLogging(b *testing.B) {
	logger := zerolog.New(io.Discard).With().Timestamp().Logger()
	b.ResetTimer()
	b.ReportAllocs()
	for i := 0; i < b.N; i++ {
		logger.Info().
			Str("endpoint", "/v1/orders").
			Int("status", 200).
			Int64("latency_ms", 42).
			Msg("processed request")
	}
}