egutierrez
47fac22230
- .claude/CLAUDE.md - .claude/commands/subagentes.md - .claude/rules/INDEX.md - .mcp.json - bash/functions/cybersecurity/analyze_dns.md - bash/functions/cybersecurity/audit_http_headers.md - bash/functions/cybersecurity/audit_ssh_config.md - bash/functions/cybersecurity/check_firewall.md - bash/functions/cybersecurity/detect_suspicious_users.md - bash/functions/cybersecurity/encrypt_file.md - ... Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
44 lines
2.1 KiB
Markdown
44 lines
2.1 KiB
Markdown
---
|
|
name: logger_middleware
|
|
kind: function
|
|
lang: go
|
|
domain: infra
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "func LoggerMiddleware(logger *Logger) Middleware"
|
|
description: "Retorna un Middleware HTTP que emite un log estructurado por cada request. Cada request produce una entrada info con method, path, status y duration_ms. Respeta los campos contextuales del Logger (app, version, request_id...)."
|
|
tags: [logging, log, slog, middleware, http, server, infra, pendiente-usar]
|
|
uses_functions: [log_info_go_infra]
|
|
uses_types: [Logger_go_infra, Middleware_go_infra]
|
|
returns: [Middleware_go_infra]
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: [net/http, time]
|
|
params:
|
|
- name: logger
|
|
desc: "Logger estructurado al que emitir cada request. Hereda los campos contextuales (app, version...)"
|
|
output: "Middleware que loguea cada request HTTP tras su procesamiento"
|
|
tested: true
|
|
tests: ["loguea method, path, status y duration_ms", "usa status 200 si el handler no llama WriteHeader", "preserva los campos contextuales del logger"]
|
|
test_file_path: "functions/infra/logger_test.go"
|
|
file_path: "functions/infra/logger_middleware.go"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
base, _ := LoggerNew(LogLevelInfo, os.Stdout, "json")
|
|
appLog := LoggerWith(base, map[string]any{"app": "sqlite_api"})
|
|
|
|
mux := HTTPRouter(routes)
|
|
chain := HTTPMiddlewareChain(LoggerMiddleware(appLog), HTTPCORSMiddleware([]string{"*"}, []string{"GET"}))
|
|
|
|
http.ListenAndServe(":8484", chain(mux))
|
|
// Cada request produce:
|
|
// {"time":"...","level":"INFO","msg":"http request","app":"sqlite_api","method":"GET","path":"/health","status":200,"duration_ms":1}
|
|
```
|
|
|
|
## Notas
|
|
|
|
Funcion impura — captura el status code con un `loggerResponseWriter` envolvente que intercepta `WriteHeader`. Si el handler no llama `WriteHeader` explicitamente el status por defecto es 200. La duracion se mide desde el inicio del middleware hasta despues de que el handler siguiente termine — incluye el tiempo de los middlewares internos pero no los externos en la cadena. El mensaje emitido es `"http request"` a nivel info para facilitar filtrado via `msg:"http request"` en queries downstream.
|