logging

Documentation

Overview

Package logging provides a structured logger built on log/slog. It is configured once at startup via New and distributed through context values using WithLogger / FromContext.

Environment variables:

LOG_LEVEL  = debug | info | warn | error  (default: info)
LOG_FORMAT = json | text                  (default: json)

Index

• func FromContext(ctx context.Context) *slog.Logger
• func New() *slog.Logger
• func WithLogger(ctx context.Context, logger *slog.Logger) context.Context

Functions

func FromContext

func FromContext(ctx context.Context) *slog.Logger

FromContext returns the *slog.Logger stored in ctx. If no logger is present it returns slog.Default so callers never need to nil-check.

func New

func New() *slog.Logger

New constructs a *slog.Logger from environment variables. LOG_FORMAT selects the handler (json for production, text for local dev). LOG_LEVEL sets the minimum severity level.

func WithLogger

func WithLogger(ctx context.Context, logger *slog.Logger) context.Context

WithLogger returns a copy of ctx carrying logger.