---
name: log_debug
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func LogDebug(logger *Logger, msg string, fields ...any)"
description: "Emite un log a nivel debug en el Logger. Los fields son pares key-value variadicos. Si el nivel del logger es mayor que Debug, el mensaje se descarta silenciosamente."
tags: [logging, log, debug, slog, infra, pendiente-usar]
uses_functions: []
uses_types: [Logger_go_infra]
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
  - name: logger
    desc: "Logger al que emitir el mensaje. Si es nil la funcion no hace nada"
  - name: msg
    desc: "mensaje principal del log"
  - name: fields
    desc: "pares key-value variadicos (ej: \"port\", 8484, \"user\", \"lucas\")"
output: "nada (side effect: escribe al Output del Logger)"
tested: true
tests: ["LogDebug emite nivel DEBUG", "campos inline en la llamada aparecen en el JSON", "logger nil no hace panic en las funciones de log"]
test_file_path: "functions/infra/logger_test.go"
file_path: "functions/infra/log_debug.go"
---

## Ejemplo

```go
logger, _ := LoggerNew(LogLevelDebug, os.Stdout, "json")
LogDebug(logger, "parsing body", "content_type", "application/json", "size", 1024)
// {"time":"...","level":"DEBUG","msg":"parsing body","content_type":"application/json","size":1024}
```

## Notas

Funcion impura — delega a `slog.Logger.Debug()`. El filtrado por nivel lo hace el handler de slog internamente (no se evalua el costo de los campos si el nivel esta debajo). Los fields deben venir en pares: si el numero es impar slog lo marca como `!BADKEY`. Usar este nivel para trazas detalladas de desarrollo que normalmente no se ven en produccion.
