Componentes de software de LibreQoS

Servicios systemd

flowchart LR
    A[Integraciones CRM/NMS] --> B[lqos_scheduler]
    C[network.json + ShapedDevices.csv] --> B
    D[lqos_overrides.json] --> B
    B --> E[Refresco del plan de colas/shaping]
    E --> F[lqosd]
    F --> G[Shaping runtime XDP/TC]
    F --> H[WebUI :9123]
    B --> I[Estado del scheduler / problemas urgentes]
    F --> I

lqosd

Administra la lógica de shaping/XDP.
Implementado en Rust.
Ejecuta la UI local disponible en http://a.b.c.d:9123.
Hospeda páginas de WebUI (Node Manager) como:
- Site Map
- Flow Globe
- Árbol de red
- ASN Analysis
- Árbol/Pesos de CPU
- Editores de configuración para integraciones (UISP, Splynx, Netzur, VISP, etc.)

lqos_scheduler

Realiza refrescos continuos de shaping, incluyendo lectura de integraciones CRM habilitadas.
Acciones:
- Al iniciar: ejecución de setup completo de colas.
- Cada X minutos: actualización de colas y datos de integración.
El intervalo por defecto es 30 minutos (queue_refresh_interval_mins en /etc/lqos.conf).

Verificación de estado

sudo systemctl status lqosd lqos_scheduler

Si algún servicio aparece como failed, revise logs:

sudo journalctl -u lqosd -b
sudo journalctl -u lqos_scheduler -b

Depuración de lqos_scheduler

lqos_scheduler ejecuta scheduler.py, que a su vez invoca LibreQoS.py. En instalaciones empaquetadas, Python se ejecuta desde el entorno virtual propiedad de root en /opt/libreqos/venv.

Flujo de depuración recomendado:

sudo systemctl stop lqos_scheduler
cd /opt/libreqos/src
sudo /opt/libreqos/venv/bin/python /opt/libreqos/src/LibreQoS.py --debug
sudo /opt/libreqos/venv/bin/python /opt/libreqos/src/scheduler.py
sudo systemctl start lqos_scheduler

Modo privacidad en WebUI

WebUI (Node Manager) incluye redacción del lado cliente para demos/capturas:

Se activa con el ícono de máscara en la barra superior.
La preferencia se guarda en localStorage.
Oculta datos visibles en la UI; no modifica archivos fuente.

Canal de problemas urgentes

WebUI (Node Manager) incluye un canal de problemas urgentes para eventos de alta prioridad (por ejemplo, límite de circuitos mapeados).

Los eventos aparecen en el indicador de navegación superior.
Pueden revisarse y reconocerse desde el modal de problemas urgentes.
Úselo como señal rápida; confirme detalle con journalctl -u lqosd.

Indicador de estado del scheduler

WebUI (Node Manager) incluye visibilidad del estado del scheduler.

Úselo como señal rápida de salud para jobs periódicos.
Si el scheduler no está saludable, valide primero estado de lqosd y lqos_scheduler.
Revise detalle con:
- journalctl -u lqos_scheduler --since "30 minutes ago"
- journalctl -u lqosd --since "30 minutes ago"

Solución de problemas de componentes

Consulte Solución de Problemas.

2.9 KiB Raw Blame History