← Volver a Configuration

LokiSettings

Configuración para el sistema de logging Loki

📊 Descripción General

La clase LokiSettings contiene la configuración para el sistema de logging Loki, que es una solución de agregación de logs distribuida. Esta clase proporciona todos los parámetros necesarios para configurar la integración con Loki.

🎯 Propósito de la Clase

  • Logging Distribuido: Configuración para logging centralizado
  • Agregación de Logs: Recopilación de logs de múltiples fuentes
  • Monitoreo: Configuración para monitoreo de aplicaciones
  • Análisis: Configuración para análisis de logs

📋 Propiedades de Configuración

Enabled

bool
Indica si el logging a Loki está habilitado (por defecto: true)

Uri

string
URI del servidor Loki para envío de logs

Credentials

LokiCredentials
Credenciales para autenticación con Loki

BatchSize

int
Tamaño del lote de logs a enviar (por defecto: 100)

BatchPeriod

TimeSpan
Período de tiempo para envío de lotes (por defecto: 2 segundos)

QueueLimit

int
Límite de elementos en la cola de logs (por defecto: 10000)

RetentionPeriod

TimeSpan
Período de retención de logs (por defecto: 30 días)

Labels

Dictionary<string, string>
Etiquetas personalizadas para los logs

🔐 LokiCredentials

Clase anidada que contiene las credenciales para autenticación con Loki.

Login

string
Nombre de usuario para autenticación con Loki

Password

string
Contraseña para autenticación con Loki

💡 Ejemplo de Configuración

{ "LokiSettings": { "Enabled": true, "Uri": "http://loki:3100/loki/api/v1/push", "Credentials": { "Login": "loki_user", "Password": "secure_password" }, "BatchSize": 100, "BatchPeriod": "00:00:02", "QueueLimit": 10000, "RetentionPeriod": "30.00:00:00", "Labels": { "application": "RestMaster", "environment": "production", "version": "1.0.0" } } }

📊 Características de Rendimiento

⚡ Optimización de Rendimiento

  • Batching: Envío de logs en lotes para mejor rendimiento
  • Queue Management: Gestión de cola para evitar pérdida de logs
  • Retention: Configuración de retención para optimizar almacenamiento
  • Labels: Etiquetas para mejor organización y búsqueda

🎯 Configuración Recomendada

  • BatchSize: 100-500 logs por lote
  • BatchPeriod: 2-5 segundos entre envíos
  • QueueLimit: 5000-20000 elementos
  • RetentionPeriod: 30-90 días según necesidades

🔐 Consideraciones de Seguridad

🔒 Seguridad de Logging

  • Credenciales: Almacenar credenciales de forma segura
  • HTTPS: Usar HTTPS para comunicación con Loki
  • Datos Sensibles: No loggear información sensible
  • Acceso: Restringir acceso a logs
  • Auditoría: Mantener auditoría de acceso a logs

⚠️ Mejores Prácticas

  • Labels Estratégicas: Usar labels para categorización
  • Monitoreo: Monitorear el estado de Loki
  • Backup: Mantener backup de configuración
  • Documentación: Documentar cambios en configuración

🔗 Integración con Otros Componentes

📚 Componentes Relacionados

  • AppSettings: Incluido en la configuración principal
  • Middleware: Middleware de logging
  • Back.API: Logging de requests y responses
  • Back.Application: Logging de servicios de aplicación

🎯 Casos de Uso

  • Debugging: Logs para debugging de aplicaciones
  • Monitoreo: Monitoreo de rendimiento y errores
  • Auditoría: Auditoría de operaciones del sistema
  • Análisis: Análisis de patrones de uso