mirror of
https://github.com/LibreQoE/LibreQoS.git
synced 2026-10-25 14:20:05 -05:00
changes
This commit is contained in:
rchac committed
1 parent
b502e21056
commit
b4908ad727
9 files changed
+368
-61
No files matched your search
+20
-8
@@ -9,19 +9,31 @@ Bienvenido a la documentación de LibreQoS
|
||||
|
||||
v2.0/design-es
|
||||
v2.0/requirements-es
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Implementando LibreQoS (v1.5 a v2.0):
|
||||
|
||||
v2.0/prereq-es
|
||||
v2.0/ubuntu-server-es
|
||||
v2.0/bridge-es
|
||||
v2.0/quickstart-es
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Gestionando LibreQoS (v1.5 a v2.0):
|
||||
|
||||
v2.0/configuration-es
|
||||
v2.0/components-es
|
||||
v2.0/integrations-es
|
||||
v2.0/Updates/update
|
||||
v2.0/api-es
|
||||
v2.0/components-es
|
||||
v2.0/update-es
|
||||
v2.0/troubleshooting-es
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Insight
|
||||
|
||||
v2.0/insight-es
|
||||
v2.0/api-es
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Misceláneo
|
||||
|
||||
v2.0/cake-es
|
||||
v2.0/extras-es
|
||||
@@ -11,10 +11,9 @@
|
||||
|
||||
- lqos_scheduler realiza actualizaciones continuas de los reguladores de tráfico (shapers) de LibreQoS, incluyendo la obtención de datos desde cualquier integración CRM habilitada (UISP, Splynx, Netzur).
|
||||
- Acciones realizadas:
|
||||
- Al iniciar: Realiza una configuración completa de las filas.
|
||||
- Cada X minutos: Actualiza las colas, obteniendo nueva configuración desde la integración CRM, si está habilitada.
|
||||
- The default minute interval is 30, so the refresh occurs every 30 minutes by default.
|
||||
- El intervalo de minutos por defecto es de 30, por lo tanto, la actualización se realiza cada 30 minutos.
|
||||
- Al iniciar: realiza una configuración completa de las colas.
|
||||
- Cada X minutos: actualiza las colas, obteniendo nueva configuración desde la integración CRM si está habilitada.
|
||||
- El intervalo por defecto es de 30 minutos, por lo que la actualización ocurre cada 30 minutos.
|
||||
- El intervalo de minutos puede ajustarse mediante el parámetro `queue_refresh_interval_mins` ubicado en `/etc/lqos.conf`.
|
||||
|
||||
### Verificar el estado de los servicios
|
||||
@@ -68,3 +67,6 @@ Una vez que se hayan corregido los errores, reinicie el servicio lqos_scheduler
|
||||
```shell
|
||||
sudo systemctl start lqos_scheduler
|
||||
```
|
||||
|
||||
### Solución de problemas de los servicios
|
||||
Consulta la sección de [Solución de Problemas](troubleshooting-es.md).
|
||||
@@ -1,6 +1,71 @@
|
||||
# Configurar LibreQoS
|
||||
|
||||
## Archivo de Configuración Principal
|
||||
## Configuración inicial mediante la herramienta de instalación (desde el .deb)
|
||||
<img width="1605" height="1030" alt="setup_tool" src="https://github.com/user-attachments/assets/5a645da8-c411-4635-9777-a881966981df" />
|
||||
|
||||
NOTAS:
|
||||
- La herramienta de configuración de LibreQoS solo se controla con teclado. Usa las flechas para desplazarte y presiona ```Enter``` para seleccionar.
|
||||
- Al presionar la tecla ```Q``` se cierra la herramienta sin guardar.
|
||||
- Si estabas usando la herramienta y se cerró, debes ejecutar los siguientes comandos para relanzarla:
|
||||
```
|
||||
sudo apt remove libreqos
|
||||
sudo apt install ./{deb_url_v1_5}
|
||||
```
|
||||
|
||||
El primer paso es darle un nombre a tu Shaper Box (nodo). Por defecto se llama LibreQoS.
|
||||
Usa las flechas del teclado para recorrer las secciones de configuración:
|
||||
|
||||
### Bridge Mode
|
||||
<img width="1668" height="397" alt="bridge_mode" src="https://github.com/user-attachments/assets/22bc05cc-f1e5-451a-b4f8-5e75d7b8d64f" />
|
||||
|
||||
De manera predeterminada se selecciona el puente Linux. Si elegiste el puente XDP en el paso anterior, ajústalo aquí.
|
||||
|
||||
NOTA: el modo Single Interface, como su nombre indica, es para usuarios que solo pueden usar 1 interfaz y requiere soporte especial. Para más detalles visita nuestro [Zulip Chat].
|
||||
|
||||
### Interfaces
|
||||
<img width="885" height="352" alt="interfaces" src="https://github.com/user-attachments/assets/4afedfe6-65b8-450c-a675-bea25ef4553c" />
|
||||
|
||||
Siguiendo el diagrama recomendado, la interfaz “To Internet” debe apuntar al router de borde (y, por lo tanto, a Internet) y la interfaz “To Network” debe apuntar al router central.
|
||||
|
||||
### Bandwidth
|
||||
<img width="1089" height="350" alt="bandwidth" src="https://github.com/user-attachments/assets/f68185c3-82dc-4fb5-b78a-d812665533fb" />
|
||||
|
||||
En el contexto del ancho de banda contratado a tu proveedor upstream, ```To Internet``` representa el ancho de banda de subida y ```To Network``` el de bajada.
|
||||
|
||||
### IP Range
|
||||
<img width="1331" height="481" alt="ip_ranges" src="https://github.com/user-attachments/assets/b846baa7-288e-460c-ab77-ad400384057c" />
|
||||
|
||||
En esta sección debes especificar todos los rangos IP utilizados por los routers de tus clientes, incluyendo rangos para IPs estáticas. De forma predeterminada se incluyen 4 rangos comunes, como se ve en la imagen.
|
||||
|
||||
*Tip: para eliminar un rango, selecciónalo con las flechas del teclado y presiona ```Tab``` hasta resaltar ```<Remove Selected>```, luego ```Enter```.
|
||||
|
||||
### Web Users
|
||||
<img width="1664" height="528" alt="web_users" src="https://github.com/user-attachments/assets/8db17e0e-cc3d-4d67-9c59-4751bc4d9b0f" />
|
||||
|
||||
Aquí puedes crear usuarios para el panel web de LibreQoS con sus respectivos roles. Hay dos tipos: ```Admin``` y ```Read Only```.
|
||||
***
|
||||
Después de guardar el archivo podrías ver el siguiente mensaje en la terminal:
|
||||
```
|
||||
No VM guests are running outdated hypervisor (qemu) binaries on this host.
|
||||
N: Download is performed unsandboxed as root as file '/home/libreqos/libreqos_1.5-RC2.202510052233-1_amd64.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)
|
||||
```
|
||||
Ese mensaje es benigno; puedes ignorarlo.
|
||||
|
||||
### Próximos pasos
|
||||
|
||||
Si la instalación se completó correctamente, podrás ingresar a la WebUI en ```http://tu_ip_del_shaper:9123```. En el primer ingreso podrás definir usuario y contraseña.
|
||||
|
||||
Luego, configura tu [integración con CRM o NMS](integrations-es.md) usando la página de configuración de la WebUI. Si no usas un CRM/NMS soportado, tendrás que crear un script o proceso que genere los archivos necesarios para que LibreQoS pueda regular el tráfico: `network.json` y `ShapedDevices.csv`. Los formatos se explican más adelante en esta página.
|
||||
|
||||
## Configuración mediante la interfaz web
|
||||
|
||||
La mayoría de los parámetros del shaper pueden modificarse desde la página Configuration en la WebUI (http://tu_ip_del_shaper:9123/config_general.html).
|
||||
|
||||
## Configuración por línea de comando
|
||||
|
||||
También puedes modificar ajustes usando la CLI.
|
||||
|
||||
### Archivo de Configuración Principal
|
||||
### /etc/lqos.conf
|
||||
|
||||
La configuración para cada caja reguladora de LibreQoS se almacena en el archivo `/etc/lqos.conf`.
|
||||
@@ -25,7 +90,7 @@ Nota: Si observa que el tráfico no se está regulando cuando debería, asegúre
|
||||
|
||||
Después de cambiar cualquier parte de `/etc/lqos.conf`, se recomienda reiniciar siempre lqosd usando: `sudo systemctl restart lqosd`. Esto integra los nuevos valores en lqos.conf, haciéndolos accesibles tanto para el código en Rust como en Python.
|
||||
|
||||
### Netflow (optional)
|
||||
### Netflow (opcional)
|
||||
Para habilitar Netflow, agregue la siguiente sección `[flows]` al archivo de configuración `/etc/lqos.conf`, configurando el `netflow_ip` adecuado:
|
||||
```
|
||||
[flows]
|
||||
@@ -53,11 +118,15 @@ Si no planea usar una integración, puede definir manualmente el archivo network
|
||||
|
||||
<table><thead><tr><th colspan="5">Entire Network</th></tr></thead><tbody><tr><td colspan="3">Site_1</td><td colspan="2">Site_2</td></tr><tr><td>AP_A</td><td colspan="2">Site_3</td><td>Pop_1</td><td>AP_1</td></tr><tr><td></td><td colspan="2">PoP_5</td><td>AP_7</td><td></td></tr><tr><td></td><td>AP_9</td><td>PoP_6</td><td></td><td></td></tr><tr><td></td><td></td><td>AP_11</td><td></td><td></td></tr></tbody></table>
|
||||
|
||||
Para redes sin nodos padre (sin puntos de acceso o sitios estrictamente definidos), edite el network.json para usar una topología de red plana con:
|
||||
Para redes sin nodos padre (sin puntos de acceso o sitios estrictamente definidos), edita el network.json para usar una topología de red plana con:
|
||||
```
|
||||
echo "{}" > network.json
|
||||
```
|
||||
|
||||
#### Consideraciones de CPU
|
||||
|
||||
<img width="3276" height="1944" alt="cpu" src="https://github.com/user-attachments/assets/e4eeed5e-eeeb-4251-9258-d301c3814237" />
|
||||
|
||||
#### Ayudante para convertir CSV a JSON
|
||||
|
||||
Puede usar:
|
||||
@@ -81,7 +150,7 @@ El archivo ShapedDevices.csv correlaciona direcciones IP de dispositivos con cir
|
||||
|
||||
### ShapedDevices.csv
|
||||
|
||||
The ShapedDevices.csv file correlates device IP addresses to Circuits (each internet subscriber's unique service).
|
||||
El archivo ShapedDevices.csv correlaciona las direcciones IP de los dispositivos con los circuitos (cada servicio único de suscriptor).
|
||||
|
||||
A continuación un ejemplo de entrada en ShapedDevices.csv:
|
||||
| Circuit ID | Circuit Name | Device ID | Device Name | Parent Node | MAC | IPv4 | IPv6 | Download Min Mbps | Upload Min Mbps | Download Max Mbps | Upload Max Mbps | Comment |
|
||||
|
||||
+26
-45
@@ -1,59 +1,40 @@
|
||||
# Suposiciones de Diseño de Red
|
||||
# Escenarios de Despliegue
|
||||
|
||||
## Configuración oficialmente soportada
|
||||
## Despliegue inline estándar
|
||||
|
||||
- LibreQoS se coloca en línea en el borde de su red, normalmente entre el router de borde (edge router) de la red (NAT, firewall) y el router/switch de distribución central (core router/switch).
|
||||
LibreQoS se coloca en línea en el borde de la red, normalmente entre el router de borde (NAT, firewall) y el router o switch de distribución principal.
|
||||
|
||||
|
||||
#### NAT/CG-NAT
|
||||
Si utilizas NAT/CG-NAT, coloca LibreQoS en línea antes del punto donde se aplica el NAT, ya que necesita regular las direcciones previas al NAT (100.64.0.0/12) y no las IP públicas posteriores.
|
||||
|
||||
### Rutas Primaria y de Respaldo
|
||||
|
||||
Recomendamos usar protocolos de enrutamiento dinámico como OSPF para crear una ruta de bajo costo y otra de alto costo entre el router de borde y el router/switch de distribución central. The low cost path should pass "through" the LibreQoS shaper bridge interfaces to allow LibreQoS to observe and shape traffic.
|
||||
La ruta de bajo costo debe pasar a través de las interfaces del puente regulador de LibreQoS para permitir que LibreQoS observe y regule el tráfico.
|
||||
Por ejemplo, una ruta OSPF de bajo costo puede establecerse con un valor de 1. El enlace de alto costo (respaldo) pasaría completamente por fuera de LibreQoS, configurándose con un costo mayor (quizás 100 en OSPF) para asegurar que el tráfico solo tome ese camino cuando el puente regulador de LibreQoS no esté funcionando.
|
||||
|
||||
### NAT/CG-NAT
|
||||
Si utiliza NAT/CG-NAT, coloque LibreQoS en línea antes de donde se aplica el NAT, ya que LibreQoS necesita regular las direcciones pre-NAT (100.64.0.0/12), no las IPs públicas post-NAT.
|
||||
|
||||
### MPLS/VPLS
|
||||
LibreQoS puede trabajar con tráfico MPLS, sin embargo, el tráfico debe seguir el patrón estándar:
|
||||
#### MPLS/VPLS
|
||||
LibreQoS puede analizar tráfico MPLS siempre que siga el patrón estándar:
|
||||
```
|
||||
(mpls tags)(optional vlan tags)(ip header)
|
||||
```
|
||||
Si utiliza MPLS con un patrón de etiquetas diferente, lo ideal es terminar el tráfico MPLS en el router/switch de distribución central (core router) antes de que llegue a LibreQoS.
|
||||
Si tu despliegue MPLS usa un patrón distinto, lo ideal es terminar el tráfico MPLS en el router o switch de distribución principal antes de que llegue a LibreQoS.
|
||||
|
||||
## Configuración de laboratorio de pruebas
|
||||
Cuando pruebe LibreQoS por primera vez, recomendamos desplegar un laboratorio de pruebas a pequeña escala para verlo en acción.
|
||||
|
||||
#### Enrutamiento dinámico: ruta de bypass
|
||||
- Ruta primaria (bajo costo) *a través* del servidor que ejecuta LibreQoS.
|
||||
- Ruta de respaldo (alto costo) *evitando* el servidor que ejecuta LibreQoS.
|
||||
|
||||
### Network Interface Card
|
||||
#### Diagrama
|
||||
|
||||
|
||||
### Opción 1: Enrutamiento dinámico (recomendado)
|
||||
|
||||
Recomendamos usar protocolos como OSPF para definir rutas de bajo y alto costo entre el router de borde y el router/switch de distribución. La ruta de bajo costo debe pasar “a través” de las interfaces puente del shaper para que LibreQoS pueda observar y regular el tráfico. Por ejemplo, la ruta OSPF de bajo costo puede tener costo 1. El enlace de alto costo (respaldo) debe omitir por completo LibreQoS y configurarse con un costo mayor (por ejemplo 100 en OSPF) para que el tráfico solo tome ese camino cuando el puente de LibreQoS no esté operativo.
|
||||
|
||||
### Opción 2: Spanning Tree Protocol (no recomendado)
|
||||
|
||||
También puedes usar Spanning Tree Protocol con costos de ruta si OSPF u otro protocolo dinámico no es posible.
|
||||
|
||||
```{note}
|
||||
Debe contar con una de estas opciones:
|
||||
- Una sola NIC con dos interfaces,
|
||||
- Dos NICs con una sola interfaz cada una,
|
||||
- 2x interfaces VLAN (usando una o dos NICs).
|
||||
Casi las mismas consideraciones aplican a la configuración alternativa que a la configuración oficialmente soportada.
|
||||
```
|
||||
|
||||
LibreQoS requiere que las NICs tengan 2 o más filas RX/TX y soporte para XDP.
|
||||
Aunque muchas tarjetas cumplen teóricamente con estos requisitos, las tarjetas menos comunes tienden a tener errores de controlador no reportados que afectan la funcionalidad de XDP y las hacen inutilizables para nuestros fines.
|
||||
En este momento recomendamos las NICs Intel x520, Intel x710 y Nvidia (ConnectX-5 o más reciente). No podemos garantizar compatibilidad con otras tarjetas.
|
||||
Ten en cuenta que, si usas enlaces con distintos anchos de banda (por ejemplo, 10 Gbps a través de LibreQoS y 1 Gbps entre el switch central y el router de borde), deberás ajustar con mayor cuidado los costos de STP.
|
||||
|
||||
## Configuración Alternativa
|
||||
|
||||
Esta configuración alternativa utiliza Spanning Tree Protocol (STP) para modificar la ruta de datos en caso de que el dispositivo LibreQoS esté fuera de línea por mantenimiento u otro problema.
|
||||
|
||||
```{note}
|
||||
La mayoría de las consideraciones aplican tanto para la configuración alternativa como para la oficialmente soportada.
|
||||
```
|
||||
|
||||
- LibreQoS se coloca en línea en el borde de su red, normalmente entre el router de borde (edge router) de la red (NAT, firewall) y el router/switch de distribución central (core router/switch).
|
||||
- Si utiliza NAT/CG-NAT, coloque LibreQoS en línea antes de donde se aplica el NAT, ya que LibreQoS necesita regular las direcciones pre-NAT (100.64.0.0/12), no las IPs públicas post-NAT.
|
||||
- Para redes que usan MPLS: LibreQoS puede trabajar con tráfico MPLS, pero este debe seguir el patrón estándar (mpls tags)(optional vlan tags)(ip header). Si utiliza un patrón diferente, lo ideal es terminar el tráfico MPLS en el router/switch de distribución central (core router/switch) antes de que llegue a LibreQoS.
|
||||
- Enlace primario de Spanning Tree (bajo costo) a través del servidor que ejecuta LibreQoS.
|
||||
- Enlace de respaldo de Spanning Tree (alto costo, por ejemplo 80).
|
||||
|
||||
Keep in mind that if you use different bandwidth links, for example, 10 Gbps through LibreQoS, and 1 Gbps between core switch and edge router, you may need to be more intentional with your STP costs.
|
||||
Tenga en cuenta que si utiliza enlaces de diferente capacidad, por ejemplo, 10 Gbps a través de LibreQoS y 1 Gbps entre el switch central (core switch) y el router de borde (edge router), puede que necesite ser más enfático con los costos de STP.
|
||||
|
||||
|
||||
## Despliegue de laboratorio (opcional)
|
||||
Cuando pruebes LibreQoS por primera vez puedes desplegar un laboratorio a pequeña escala para verlo en acción.
|
||||
|
||||
@@ -0,0 +1,36 @@
|
||||
# Extras
|
||||
|
||||
## Flamegraph
|
||||
|
||||
```shell
|
||||
git clone https://github.com/brendangregg/FlameGraph.git
|
||||
cd FlameGraph
|
||||
sudo perf record -F 99 -a -g -- sleep 60
|
||||
perf script > out.perf
|
||||
./stackcollapse-perf.pl out.perf > out.folded
|
||||
./flamegraph.pl --title LibreQoS --width 7200 out.folded > libreqos.svg
|
||||
```
|
||||
|
||||
## Cómo habilitar CAKE o fq_codel en enlaces de respaldo (menor capacidad) en redes MikroTik
|
||||
|
||||
Configure un Queue Tree en la interfaz del enlace punto a punto de respaldo, en el router MikroTik de cada extremo del enlace.
|
||||
|
||||
Para enlaces inferiores a 500 Mbps en hardware razonable como un CCR2116, use CAKE:
|
||||
|
||||
```
|
||||
/queue type
|
||||
add kind=fq-codel name=fq_codel
|
||||
add cake-diffserv=diffserv4 kind=cake name=cake
|
||||
/queue tree
|
||||
add max-limit=300M name=BACKUP_LINK_INTERFACE packet-mark=no-mark parent=BACKUP_LINK_INTERFACE queue=cake
|
||||
```
|
||||
|
||||
Para enlaces de 500-1000 Mbps, use fq_codel:
|
||||
|
||||
```
|
||||
/queue type
|
||||
add kind=fq-codel name=fq_codel
|
||||
add cake-diffserv=diffserv4 kind=cake name=cake
|
||||
/queue tree
|
||||
add max-limit=300M name=BACKUP_LINK_INTERFACE packet-mark=no-mark parent=BACKUP_LINK_INTERFACE queue=fq_codel
|
||||
```
|
||||
@@ -0,0 +1,104 @@
|
||||
# LibreQoS Insight (Insight)
|
||||
|
||||
## Acerca de Insight
|
||||
Conoce más sobre Insight en nuestro sitio web, [aquí](https://libreqos.io/insight/).
|
||||
|
||||
## Interfaz de Insight
|
||||
|
||||
### Barra de tareas
|
||||
|
||||
<img width="355" height="871" alt="taskbar" src="https://github.com/user-attachments/assets/796cba7b-49d0-4a49-96a5-cd12823a6bd8" />
|
||||
|
||||
Si tienes más de una caja reguladora (shaper), puedes elegir cuál visualizar desde el desplegable **Shaper Nodes** (ubicado justo debajo del cuadro de búsqueda).
|
||||
|
||||
### Selector de tiempo
|
||||
|
||||
<img width="529" height="83" alt="image" src="https://github.com/user-attachments/assets/b706a230-883a-4064-9436-2e82749eb8b7" />
|
||||
|
||||
Al hacer clic en el selector de tiempo (por defecto Last 24 Hours) puedes definir el rango que se mostrará, desde 15 minutos hasta 28 días. También es posible establecer periodos personalizados (Now minus X minutes) o ventanas muy específicas.
|
||||
|
||||
### Panel (Dashboard)
|
||||
|
||||
Puedes ver qué caja reguladora se está consultando en la parte superior izquierda, junto a “Select a destination”.
|
||||
|
||||
El panel de LibreQoS Insight está basado en widgets y dispone de varias pestañas que se pueden editar.
|
||||
|
||||
#### Pestaña Traffic Overview
|
||||
|
||||
<img width="3828" height="2160" alt="01 dashboard" src="https://github.com/user-attachments/assets/29ee98e3-55c7-4466-a444-de9542cc0940" />
|
||||
|
||||
La pestaña predeterminada es **Traffic Overview**. Muestra el tráfico en vivo y los endpoints con mayor consumo, tanto por ASN como por nodo.
|
||||
|
||||
#### Pestaña Shaper
|
||||
|
||||
<img width="3840" height="2160" alt="02 shaper tab" src="https://github.com/user-attachments/assets/721fd195-35ad-421b-8d0a-e2aa6e5cf7e9" />
|
||||
|
||||
La pestaña **Shaper** muestra estadísticas de alto nivel para una caja LibreQoS determinada.
|
||||
|
||||
- **Active Circuit Count:** número de circuitos activos detectados (basado en el tráfico del suscriptor).
|
||||
- **Throughput:** tráfico agregado del shaper.
|
||||
- **Shaper Packets:** tasa de paquetes por segundo a lo largo del tiempo.
|
||||
- **Shaper TCP Retransmits Percentage:** porcentaje de paquetes TCP retransmitidos (proxy de pérdida); idealmente debe permanecer por debajo del 1 %.
|
||||
- **Shaper CAKE Activity:** nivel de actividad de los shapers CAKE en la red.
|
||||
- **Shaper Round Trip Time:** RTT promedio del tráfico.
|
||||
- **Shaper Round Trip Time Histogram:** el mismo RTT en formato histograma.
|
||||
- **Shaper CPU Utilization:** uso máximo y promedio de CPU en el tiempo.
|
||||
- **Shaper Memory Utilization:** uso de RAM del shaper en el tiempo.
|
||||
|
||||
#### Pestaña Children
|
||||
|
||||
<img width="3840" height="2160" alt="03 child view" src="https://github.com/user-attachments/assets/1f0a0e3c-672b-4982-b334-60a681248b99" />
|
||||
|
||||
- **Shaper Child Throughput:** rendimiento de cada nodo hijo de primer nivel.
|
||||
- **Shaper Child TCP Retransmits:** ayuda a detectar nodos con pérdidas elevadas.
|
||||
- **Shaper Child Round Trip Time:** ayuda a identificar nodos con RTT anómalo.
|
||||
|
||||
#### Heatmaps
|
||||
|
||||
<img width="3840" height="2160" alt="04 heatmap" src="https://github.com/user-attachments/assets/f3911ca3-8157-43dc-9f57-1402a6cd0204" />
|
||||
|
||||
Esta vista muestra heatmaps de RTT, retransmisiones y capacidad para los nodos de primer nivel del shaper.
|
||||
|
||||
#### Site Rankings
|
||||
|
||||
<img width="3840" height="2160" alt="05 health" src="https://github.com/user-attachments/assets/37e69c41-646c-458f-912d-8556acace102" />
|
||||
|
||||
Esta pestaña resume la salud de los sitios / AP / etc. según RTT, retransmisiones TCP y capacidad en cada dirección.
|
||||
|
||||
### Node Map
|
||||
|
||||
<img width="3840" height="2160" alt="06 map" src="https://github.com/user-attachments/assets/219d75b3-739a-4f41-86e6-5bc270f22afd" />
|
||||
|
||||
Permite identificar la topología general de la red desde la perspectiva de Insight. Al pasar el cursor por los enlaces se muestra el throughput y las retransmisiones TCP actuales de ese tramo.
|
||||
|
||||
### Libby (Asistente IA)
|
||||
|
||||
<img width="1784" height="882" alt="07 libby" src="https://github.com/user-attachments/assets/591a3fd1-3946-44ed-a4fd-e1b1d84b9ef6" />
|
||||
|
||||
Libby es el asistente IA de Insight. Puede ayudarte con dudas sobre LibreQoS o Insight basándose en la documentación oficial. Libby accede a datos en vivo y de largo plazo tanto de los shapers sincronizados como de Insight. Puede responder en la mayoría de los idiomas mediante traducción automática.
|
||||
|
||||
Si encuentras nuevos casos de uso para Libby, comparte con nosotros cómo te ayuda en el flujo de trabajo.
|
||||
|
||||
### Site Heatmap
|
||||
|
||||
<img width="3830" height="2160" alt="08 heatmap" src="https://github.com/user-attachments/assets/dfaea245-3221-4cea-874b-fd795ac8da33" />
|
||||
|
||||
Esta vista entrega heatmaps de RTT, retransmisiones y capacidad para cada Access Point, OLT y sitio de tu red en una sola pantalla, lo que facilita detectar puntos problemáticos rápidamente.
|
||||
|
||||
### Tree History
|
||||
|
||||
<img width="3840" height="2160" alt="09 tree history" src="https://github.com/user-attachments/assets/ea0d0417-c937-41ee-ac4d-7d84c162c6dd" />
|
||||
|
||||
Se basa en la vista Tree Overview de la WebUI de LibreQoS y muestra el diagrama Sankey a lo largo del tiempo para identificar cuellos de botella que afecten el rendimiento.
|
||||
|
||||
### Reports
|
||||
|
||||
<img width="3828" height="2160" alt="10 report" src="https://github.com/user-attachments/assets/37f6bd91-8937-4755-a095-6bc38822f544" />
|
||||
|
||||
Insight permite generar reportes asistidos por IA sobre circuitos específicos. Estos informes usan los últimos 7 días de actividad del cliente (características por ASN, contexto de topología y contexto geográfico) e incluyen un Perfil de usuario, Hallazgos clave, Problemas críticos, Tendencias de rendimiento, una Recomendación de mejora y elementos sugeridos para revisión manual.
|
||||
|
||||
### Alerts
|
||||
|
||||
<img width="3831" height="2160" alt="11 alerts" src="https://github.com/user-attachments/assets/66f0a465-eb00-4bfb-9cf8-c8302af78ead" />
|
||||
|
||||
La sección **Alerts** entrega advertencias automáticas sobre comportamientos fuera de norma para nodos de la red (AP, OLT, sitios, etc.).
|
||||
@@ -0,0 +1,28 @@
|
||||
# Ajuste de Rendimiento
|
||||
|
||||
## Ubuntu inicia lentamente (~2 minutos)
|
||||
|
||||
### Listar todos los servicios que dependen de la red
|
||||
|
||||
```shell
|
||||
systemctl show -p WantedBy network-online.target
|
||||
```
|
||||
|
||||
### En Ubuntu 22.04 este comando puede ayudar
|
||||
|
||||
```shell
|
||||
systemctl disable cloud-config iscsid cloud-final
|
||||
```
|
||||
|
||||
### Establecer el governor correcto para la CPU (baremetal/hipervisor)
|
||||
|
||||
```shell
|
||||
cpupower frequency-set --governor performance
|
||||
```
|
||||
|
||||
### OSPF
|
||||
|
||||
Se recomienda ajustar los temporizadores OSPF de ambos vecinos (core y edge router) para minimizar el tiempo de inactividad cuando el servidor LibreQoS se reinicie.
|
||||
|
||||
* hello interval
|
||||
* dead interval
|
||||
@@ -0,0 +1,37 @@
|
||||
# Comparte tu antes y después
|
||||
|
||||
Te pedimos que compartas una captura anonimizada de tu despliegue de LibreQoS antes (modo monitor) y después (colas activadas) en el [LibreQoS Chat](https://chat.libreqos.io/join/fvu3cerayyaumo377xwvpev6/). Esto nos ayuda a medir el impacto del software y, de paso, nos saca una sonrisa.
|
||||
|
||||
1. Activa el modo monitor only.
|
||||
2. Déjalo ejecutándose durante 1 semana.
|
||||
3. Desactiva el modo monitor only.
|
||||
4. Activa la opción **Redact** en la WebUI de LTS para ocultar datos sensibles.
|
||||
5. Toma la captura.
|
||||
|
||||
## Activar el modo monitor only
|
||||
|
||||
```shell
|
||||
sudo nano /etc/lqos.conf
|
||||
```
|
||||
|
||||
En la sección `[queues]`, establece `monitor_only = true` para pasar al modo monitor.
|
||||
|
||||
Después reinicia lqosd y lqos_scheduler:
|
||||
|
||||
```shell
|
||||
sudo systemctl restart lqosd lqos_scheduler
|
||||
```
|
||||
|
||||
## Desactivar el modo monitor only
|
||||
|
||||
```shell
|
||||
sudo nano /etc/lqos.conf
|
||||
```
|
||||
|
||||
En la sección `[queues]`, establece `monitor_only = false` para salir del modo monitor.
|
||||
|
||||
Después reinicia lqosd y lqos_scheduler:
|
||||
|
||||
```shell
|
||||
sudo systemctl restart lqosd lqos_scheduler
|
||||
```
|
||||
@@ -0,0 +1,38 @@
|
||||
# Actualización
|
||||
|
||||
```{warning}
|
||||
Si usas el puente XDP, el tráfico dejará de pasar por el puente mientras lqosd se reinicia (el puente XDP solo opera mientras lqosd está en ejecución).
|
||||
```
|
||||
|
||||
## Si instalaste el .deb
|
||||
|
||||
```
|
||||
cd ~
|
||||
sudo apt-get update
|
||||
sudo apt-get upgrade
|
||||
wget https://download.libreqos.com/{deb_url_v1_5}
|
||||
sudo apt install ./{deb_url_v1_5}
|
||||
sudo systemctl restart lqosd lqos_scheduler
|
||||
```
|
||||
|
||||
Ahora reinicia tu servidor LibreQoS con:
|
||||
|
||||
```
|
||||
sudo reboot
|
||||
```
|
||||
|
||||
Esto limpiará los mapas eBPF antiguos y cargará la última versión de LibreQoS.
|
||||
|
||||
## Si instalaste desde Git
|
||||
|
||||
1. Cambia a tu directorio `LibreQoS` (por ejemplo `cd /opt/LibreQoS`)
|
||||
2. Actualiza desde Git: `git pull`
|
||||
3. ```git switch develop```
|
||||
4. Recompila: `./build-rust.sh`
|
||||
5. `sudo rust/remove_pinned_maps.sh`
|
||||
|
||||
Ejecuta los siguientes comandos para recargar los servicios de LibreQoS:
|
||||
|
||||
```shell
|
||||
sudo systemctl restart lqosd lqos_scheduler
|
||||
```
|
||||
Reference in new issue
Block a user