Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

logger

package

Go to main page

Versions in this module

v0

v0.0.7

Aug 18, 2026

Changes in this version

+ var ErrInvalidFilePath = errors.New("ruta de archivo de log inválida o inaccesible")

+ var ErrInvalidLevel = errors.New("nivel de log inválido")

+ var ErrWriteFailed = errors.New("fallo al escribir el mensaje de log")

+ func DebugWithFields(msg string, fields map[string]interface{})

+ func ErrorWithFields(msg string, fields map[string]interface{})

+ func InfoWithFields(msg string, fields map[string]interface{})

+ func NewMultiWriter(writers ...io.Writer) io.Writer

+ func Panic(message string)

+ func ResetTheme()

+ func SetTheme(t Theme)

+ func SuccessWithFields(msg string, fields map[string]interface{})

+ func Trace(message string)

+ func WarnWithFields(msg string, fields map[string]interface{})

type Config

+ EnableColor bool

+ Level Level

+ ShowDate bool

+ ShowTime bool

+ Writer io.Writer

+ func NewConfig() Config

+ type Formatter struct

+ func NewFormatter(cfg Config) *Formatter

+ func (f *Formatter) Format(level Level, message string) string

type Level

+ const PanicLevel

+ const SuccessLevel

+ const TraceLevel

+ func (l Level) Color() string

+ func (l Level) Enabled(min Level) bool

+ func (l Level) IsValid() bool

+ func (l Level) Prefix() string

type Logger

+ func GetDefault() *Logger

+ func (l *Logger) DebugWithFields(message string, fields map[string]any)

+ func (l *Logger) ErrorWithFields(message string, fields map[string]any)

+ func (l *Logger) InfoWithFields(message string, fields map[string]any)

+ func (l *Logger) Panic(message string)

+ func (l *Logger) SuccessWithFields(message string, fields map[string]any)

+ func (l *Logger) Trace(message string)

+ func (l *Logger) WarnWithFields(message string, fields map[string]any)

+ type Option func(*Config)

+ func WithColor(enable bool) Option

+ func WithDateTime(showDate, showTime bool) Option

+ func WithFileOutput(filePath string) Option

+ func WithLevel(level Level) Option

+ func WithWriter(w io.Writer) Option

+ type Theme struct

+ Debug string

+ Error string

+ Fatal string

+ Info string

+ Panic string

+ Reset string

+ Success string

+ Trace string

+ Warn string

v0.0.6

Jan 29, 2026

Changes in this version

+ func Debug(f string, a ...interface{})

+ func DisableLogs()

+ func EnableLogs()

+ func Error(f string, a ...interface{})

+ func Fatal(f string, a ...interface{})

+ func GinMiddleware() gin.HandlerFunc

+ func GinRecovery() gin.HandlerFunc

+ func Info(f string, a ...interface{})

+ func LogRequestError(c *gin.Context, format string, args ...interface{})

+ func LogRequestInfo(c *gin.Context, format string, args ...interface{})

+ func LogRequestSecurity(c *gin.Context, format string, args ...interface{})

+ func LogRequestWarn(c *gin.Context, format string, args ...interface{})

+ func RegisterRoute(group *gin.RouterGroup, method, path string, handler gin.HandlerFunc, ...)

+ func RegisterRouteWithConfig(group *gin.RouterGroup, method, path string, handler gin.HandlerFunc, ...)

+ func RegisterRoutes(group *gin.RouterGroup, routes []Route)

+ func Security(f string, a ...interface{})

+ func SetDefault(l *Logger)

+ func Success(f string, a ...interface{})

+ func Warn(f string, a ...interface{})

+ type AppLog struct

+ CreatedAt time.Time

+ Extra []byte

+ ID uuid.UUID

+ Level string

+ Message string

+ type Config struct

+ EnableColors bool

+ MinLevel Level

+ ServiceName string

+ Writers []Writer

+ type ConsoleWriter struct

+ func NewConsoleWriter(enableColors bool) *ConsoleWriter

+ func (w *ConsoleWriter) Close() error

+ func (w *ConsoleWriter) Write(entry *Entry) error

+ type DBWriter struct

+ func NewDBWriter(db *gorm.DB, buffer int) (*DBWriter, error)

+ func (w *DBWriter) Close() error

+ func (w *DBWriter) Write(entry *Entry) error

+ type Entry struct

+ Fields Fields

+ ID uuid.UUID

+ Level Level

+ Message string

+ Service string

+ Timestamp time.Time

+ TraceID string

+ type Fields map[string]interface

+ type FileWriter struct

+ func NewFileWriter(path string) (*FileWriter, error)

+ func (w *FileWriter) Close() error

+ func (w *FileWriter) Write(entry *Entry) error

+ type Level int

+ const DebugLevel

+ const ErrorLevel

+ const FatalLevel

+ const InfoLevel

+ const OffLevel

+ const SecurityLevel

+ const WarnLevel

+ func (l Level) String() string

+ type Logger struct

+ func Default() *Logger

+ func GetLogger(c *gin.Context) *Logger

+ func InitGlobal(cfg Config) *Logger

+ func New(cfg Config) *Logger

+ func WithContext(ctx context.Context) *Logger

+ func WithFields(f Fields) *Logger

+ func WithRequest(e, ip string) *Logger

+ func WithUser(id uuid.UUID) *Logger

+ func (l *Logger) AddWriter(w Writer)

+ func (l *Logger) Clone() *Logger

+ func (l *Logger) Close() error

+ func (l *Logger) Debug(f string, a ...interface{})

+ func (l *Logger) Error(f string, a ...interface{})

+ func (l *Logger) Fatal(f string, a ...interface{})

+ func (l *Logger) Info(f string, a ...interface{})

+ func (l *Logger) Security(f string, a ...interface{})

+ func (l *Logger) SetMinLevel(level Level)

+ func (l *Logger) Success(f string, a ...interface{})

+ func (l *Logger) Warn(f string, a ...interface{})

+ func (l *Logger) WithContext(ctx context.Context) *Logger

+ func (l *Logger) WithFields(fields Fields) *Logger

+ func (l *Logger) WithRequest(endpoint, ip string) *Logger

+ func (l *Logger) WithUser(userID uuid.UUID) *Logger

+ type Route struct

+ Handler gin.HandlerFunc

+ Method string

+ Path string

+ Protected bool

+ type RouteConfig struct

+ ShowProtected bool

+ ShowTimestamp bool

+ type Writer interface

+ Close func() error

+ Write func(entry *Entry) error