GrafanaLoggingMiddleware

🎯 Funcionalidades Principales

• Logging estructurado: Captura completa de información de peticiones
• Optimización para Loki: Etiquetas y metadatos optimizados para consultas
• Métricas de rendimiento: Medición precisa de duración de peticiones
• Identificadores únicos: RequestId, TraceId y CorrelationId
• Categorización automática: Clasificación de códigos de estado y duración
• Contexto de usuario: Información de autenticación y claims
• Headers importantes: Captura de headers relevantes
• Logging dual: Console + Grafana Loki

📊 Dependencias de Serilog

• Serilog: Framework de logging estructurado
• LogContext: Contexto de logging con propiedades
• LogEventLevel: Niveles de logging estructurados
• JsonSerializer: Serialización JSON de datos

🎯 Pipeline de Logging

1. Inicio de petición: Genera RequestId único y captura tiempo
2. Configuración de contexto: Establece LogContext con identificadores
3. Log de inicio: Registra información de petición entrante
4. Ejecución del pipeline: Continúa con el resto de middlewares
5. Medición de duración: Calcula tiempo total de procesamiento
6. Log de finalización: Registra resultado y métricas
7. Manejo de errores: Captura excepciones y las re-lanza
8. Log de error: Registra errores con contexto completo

🎯 Etiquetas Optimizadas para Loki

• method: GET, POST, PUT, DELETE, etc.
• path: Primer segmento del path para agrupación
• status_code: 200, 400, 500, etc.
• status_category: success, client_error, server_error
• duration_category: fast, normal, slow, very_slow
• user_type: anonymous, authenticated
• exception_type: Tipo de excepción (solo en errores)

📊 Categorización Automática

• Códigos de estado:
  • 200-299: success
  • 300-399: redirect
  • 400-499: client_error
  • 500+: server_error
• Duración:
  • < 100ms: fast
  • 100-500ms: normal
  • 500-1000ms: slow
  • > 1000ms: very_slow

🎯 Información de Petición

• Identificadores: RequestId, TraceId, CorrelationId
• Método y ruta: HTTP method y path completo
• Query string: Parámetros de consulta
• User Agent: Información del cliente
• IP y puerto: Dirección remota y local
• Usuario: Información de autenticación
• Claims: Claims del JWT token
• Headers: Headers importantes filtrados

📊 Información de Respuesta

• Código de estado: HTTP status code
• Duración: Tiempo total de procesamiento
• Tamaño de contenido: ContentLength
• Tipo de contenido: ContentType
• Éxito: Indicador de éxito/fallo
• Timestamp: Marca de tiempo UTC
• Entorno: ASPNETCORE_ENVIRONMENT

🎯 Características del Middleware

• Async/Await: Operaciones asíncronas completas
• Stopwatch: Medición precisa de duración
• LogContext: Contexto de logging estructurado
• JSON Serialization: Datos estructurados para Loki
• Exception Handling: Captura y re-lanzamiento de excepciones
• Performance Monitoring: Métricas detalladas de rendimiento
• User Context: Información de autenticación
• Header Filtering: Captura de headers relevantes

📝 Patrones de Diseño Utilizados

• Middleware Pattern: Procesamiento en pipeline
• Observer Pattern: Observación de eventos HTTP
• Context Pattern: LogContext para información compartida
• Strategy Pattern: Diferentes estrategias de logging
• Template Method: Estructura común de logging
• Decorator Pattern: Enriquecimiento de información

🎯 Configuración para Loki

• Etiquetas optimizadas: Diseñadas para consultas eficientes
• Datos estructurados: JSON serializado para parsing
• Timestamps UTC: Consistencia temporal
• Categorización automática: Facilita filtrado y agrupación
• Identificadores únicos: Para correlación de eventos

📊 Consultas de Ejemplo para Grafana

• Errores por endpoint: {status_category="server_error"}
• Peticiones lentas: {duration_category="slow"}
• Usuarios autenticados: {user_type="authenticated"}
• Método específico: {method="POST"}
• Path específico: {path="api"}
• Excepciones: {exception_type!=""}

🎯 Middleware Relacionados

• ErrorHandlingMiddleware: Complementa el logging de errores
• DayOpenValidationMiddleware: Logging de validaciones de día
• JwtLoggingMiddleware: Información de autenticación
• SpanishCultureMiddleware: Configuración cultural

📋 Orden de Ejecución Recomendado

1. SpanishCultureMiddleware: Configuración de cultura
2. GrafanaLoggingMiddleware: Logging de inicio (primero)
3. JwtLoggingMiddleware: Logging de autenticación
4. DayOpenValidationMiddleware: Validación de día abierto
5. ErrorHandlingMiddleware: Manejo de errores (último)

🎯 Escenarios de Logging

• Monitoreo de rendimiento: Identificación de endpoints lentos
• Análisis de errores: Patrones de errores por endpoint
• Auditoría de seguridad: Seguimiento de accesos y autenticación
• Análisis de uso: Métodos y rutas más utilizadas
• Correlación de eventos: Seguimiento de peticiones específicas
• Alertas proactivas: Detección de patrones anómalos
• Reportes de negocio: Métricas de uso de la API

🔍 Ejemplos de Análisis

• Performance: "Endpoint /api/articulos/getall tiene duración promedio de 500ms"
• Errores: "50% de errores 500 ocurren en /api/invoice/add"
• Usuarios: "Usuario admin realiza 80% de operaciones POST"
• Geografía: "Mayor tráfico desde IP 192.168.1.100"
• Temporal: "Pico de actividad entre 12:00-14:00"