Documentación de BQN
Cerrar icono

Cuadro de mando de los abonados

El panel de control del abonado incluye un conjunto muy completo de información útil sobre el rendimiento actual y pasado del abonado. Es el lugar ideal donde analizar y diagnosticar los problemas notificados en el acceso a los datos del abonado.

Se puede acceder a ella haciendo clic en el identificador del abonado o en la dirección IP del abonado en cualquiera de las siguientes ventanas:

  • Status->Subscribers
  • Status->Flows->Per Subscriber
  • Estado->RADIUS/REST/Facturación->Suscriptores

El panel de control de los abonados contiene mucha información, así que utilice la barra de desplazamiento de la derecha para navegar por él.

El cuadro de mandos contiene la siguiente información:

  • Parámetros de la sesión principal del abonado (incluidas las políticas de tarifa y monitorización aplicadas, IP e ID del abonado, etc.). Haga clic en Detalles adicionales para ver más información. Haga clic en Ver grupos de abonados para ir a la lista de grupos a los que pertenece este abonado. Las métricas del abonado se pueden comparar con las de los grupos, para evaluar si la QoE está dentro de los valores normales.
  • Iconos de marcación con un resumen de las últimas métricas.
  • Gráficos con la evolución a lo largo del tiempo de las principales métricas de los abonados: velocidades medias y máximas, latencias, retransmisiones de paquetes (pérdidas), tráfico a altas velocidades, que sufre congestión y está limitado por ACM, reducciones de latencia y pérdidas gracias a ACM y número de flujos (creados por minuto y activos).
  • Gráfico con la utilización del servicio de los abonados a lo largo del tiempo.
  • Latencias de Internet experimentadas por este abonado para los servicios más utilizados. Haciendo clic en la barra del gráfico, se pasa al histograma con la distribución de la latencia y de ahí, a la evolución del histograma en el tiempo.
  • Tabla con los flujos activos del abonado. Se proporciona la política del flujo (haga clic en el nombre de la política para ir a la definición de la política). Si está disponible, también muestra el dominio DPI (columna DOMINIO) y la categoría DPI del flujo (columna DPI).

Los gráficos anteriores muestran la evolución en el tiempo de la velocidad media y máxima, el número de flujos y la latencia de acceso. En el caso de la latencia de acceso, se incluye también como referencia la media de la red, para determinar si el abonado está por debajo o por encima de la calidad media de la red.

Los siguientes gráficos muestran la retransmisión de paquetes en el lado de acceso, incluyendo también la media de la red como referencia. Los tres últimos gráficos contienen información sobre la función de gestión automática de la congestión para ese abonado.

Tres gráficos de dispersión muestran la posible correlación entre la velocidad y las mediciones de latencia, pérdidas y congestión. Por ejemplo, en el de velocidad frente a latencia, un punto es un par velocidad-latencia medido al mismo tiempo. Una línea roja muestra la posible correlación entre ambas (la línea que mejor se ajusta a los puntos):

Para seguir más de cerca al abonado, ponga el interruptor del modo Live en On. Aparecerán gráficos con la evolución actual de las principales métricas. Aparecerá una tabla de flujos, incluyendo la composición DPI. Se puede mostrar un lapso de tiempo máximo (último número de minutos). Esto es configurable a 2, 5 o 10 minutos, usando el selector al lado del interruptor de modo Live. Cuando se alcance el intervalo de tiempo, por ejemplo, después de 5 minutos, los gráficos seguirán actualizándose, mostrando la ventana de los últimos cinco minutos.

También se incluirá una tabla de flujos que se actualizará continuamente. Los flujos se ordenan en la tabla con los flujos activos en primer lugar, y entre ellos, los flujos más rápidos. Se muestran las categorías DPI y los dominios. Las velocidades no nulas se resaltan en azul para facilitar la identificación de los flujos activos. Puede visualizar los gráficos de vida con más espacio vertical haciendo clic en el icono Disposición ↕.

El modo Live finalizará cuando el interruptor de modo Live se ponga en Off o transcurridos quince minutos.

Identificador de abonado (ID)

Para facilitar la identificación de una sesión de abonado, se admite un campo de ID de abonado. El ID de abonado puede utilizarse al solicitar métricas, para obtener información histórica incluso cuando el abonado ha cambiado de dirección IP a lo largo del tiempo.

Existen varias fuentes posibles para el identificador de abonado:

  • Dirección de acceso MAC (por defecto). En algunas redes, la dirección MAC puede ser la misma para todos los abonados (por ejemplo, si todo el tráfico procede del mismo puerto del router), pero en otras redes puede identificar los puntos de acceso de los abonados.
  • Dirección IP de acceso al abonado. Para configurar la dirección IP para rellenar el ID de abonado, vaya a Administración->Configuración general->Fuente de ID de abonado por defecto.
  • Un sistema externo: el sistema externo puede utilizar la API REST de BQN, RADIUS o uno de nuestros sistemas Billing.Vaya a esas secciones para más detalles.

Métricas de calidad de vida del abonado

Estado->Suscriptores da acceso a la lista de suscriptores activos junto con sus métricas (si el suscriptor de interés no aparece en la lista, escriba la dirección IP en el campo de filtro).

Para facilitar la identificación de abonados con problemas de calidad de experiencia, utilizamos mapas de calor y umbrales de alerta.

Se proporciona un mapa térmico para el subconjunto de abonados cuyas métricas se trazan en el gráfico. El mapa térmico representa una escala de intensidad de color que mapea el rango métrico. Esto se muestra con una escala de colores a la izquierda del gráfico de métricas. Cuanto mayor sea el número, mayor será la intensidad del color. Cada abonado tiene una fila con la evolución de la métrica a lo largo del tiempo. Haciendo clic en la fila, se desbloquea ese abonado y haciendo clic de nuevo se vuelve a bloquear. Un doble clic deja visible sólo ese abonado. Haciendo clic con el botón derecho se accede al panel de control del abonado.

Una columna MEDIA a la izquierda del mapa térmico muestra el valor medio de la métrica, para cada abonado, durante el periodo de tiempo seleccionado. Los abonados pueden ordenarse por ese valor medio en orden ascendente o descendente.

La escala de colores es ajustable. Arrastrando los valores mínimo y máximo se centrará la gama de colores en ese intervalo métrico, dejando los valores por debajo y por encima pintados en los colores más claros y más oscuros respectivamente. Esto ayuda a centrar el análisis, haciendo zoom en ese intervalo métrico. El valor MEDIO se ajustará al intervalo seleccionado, con los valores fuera del rango redondeados a los límites del intervalo.

En cuanto a los umbrales de alerta, la columna WARN de la tabla de métricas muestra una puntuación con el número de métricas por encima de su umbral de alerta. Ordena la tabla para que los valores WARN más altos se muestren en primer lugar.

Para evitar destacar abonados que simplemente están inactivos, se aplica un umbral a la velocidad media(umbral de aviso MEAN-Mbps, en la parte superior derecha de la ventana). Si un cliente no alcanza al menos esta velocidad media, no recibirá una puntuación de advertencia y no será destacado. El umbral puede modificarse, pero en general no es necesario.

Estado->Suscriptores->Métricas QoE contiene la información que había en Estado->Suscriptores en versiones anteriores.

Gráficos de cajas

Para facilitar el seguimiento de la calidad de acceso de los abonados, cinco gráficos de caja resumen la distribución de estas métricas clave:

  • MAX-Mbps: velocidad máxima en Mbps.
  • RTT-ms: latencia de acceso en milisegundos.
  • RTX: tasa de pérdida de paquetes en porcentaje
  • VELOCIDAD MÁXIMA: porcentaje del tráfico que va a la velocidad máxima o cerca de ella.
  • CONGESTIÓN: porcentaje del tráfico que sufre congestión.

Un diagrama de cajas es un resumen de la distribución de un conjunto de valores. Muestra los valores máximo y mínimo, la mediana (valor que separa la mitad inferior y la mitad superior) y los cuartiles1 y3 (valores que separan el 25% inferior y el 25% superior, respectivamente):

Los valores exactos de los percentiles se muestran en el lado derecho de un diagrama de caja.

Umbrales de advertencia

Un umbral configurable ayuda a identificar qué abonados tienen problemas. Por ejemplo, si el umbral de RTT se establece en 20ms, el gráfico de caja sombreará en rojo todos los valores entre 20ms y el máximo. En la tabla, los valores de RTT por encima del umbral también se sombrearán en rojo, lo que facilita la detección de los clientes afectados. La tabla puede ordenar la columna de métricas para mostrar primero los valores más grandes (haga clic en la etiqueta de la columna para hacerlo).

El valor del umbral de alerta se muestra en la parte superior del gráfico de caja. Para ajustarlo, haga clic en el icono del lápiz situado en la parte superior derecha del gráfico de caja.

Resaltar percentiles

También es posible ver el cuartil de un valor activando el interruptor de color en la parte superior derecha de la página. Los códigos de cuartil son:

  • 1er cuartil: azul
  • cuartil (hasta la mediana): verde
  • 3er cuartil: naranja
  • cuartil (del al máximo): rojo

Tabla de abonados activos

La información que figura en el cuadro es la siguiente:

  • IP-ADDR: dirección IP del abonado.
  • SUBS-ID: identificador del abonado. Dirección MAC por defecto, aunque puede rellenarse con información externa del sistema (ver secciones RADIUS y Facturación).
  • RATE-POLICY: nombre de la política de tarifas que se aplica a este abonado.
  • TOTAL-MBYTES: volumen total de tráfico de esta sesión de abonado, en megabytes.
  • ACTIVE-FLOWS: número total de flujos de tráfico (principalmente conexiones TCP y flujos UDP) de este abonado que están activos (intercambiando tráfico).
  • CURR-Mbps: velocidad actual en Mbps.
  • MAX-Mbps: velocidad máxima en Mbps durante un día.
  • RTT-ms: latencia mínima de acceso en milisegundos durante un período de un día.
  • RTX: porcentaje medio de pérdidas de paquetes durante un día.
  • VELOCIDAD MÁXIMA: porcentaje de tráfico con una velocidad cercana a la velocidad máxima, en un período de un día.
  • CONGESTIÓN: porcentaje de tráfico que sufre congestión, en un período de un día.
  • LIFETIME: duración hasta el momento de esta sesión de abonado.

Haciendo clic en la dirección IP o el identificador del abonado se accede al panel de control del mismo, con datos históricos de hasta tres meses.

Métricas a lo largo del tiempo

La página de métricas de calidad de vida muestra la evolución temporal de las métricas de algunos abonados seleccionados:

El gráfico mostrará por defecto los 10 primeros abonados de la tabla de métricas, y una columna PLOT en la tabla indica los abonados incluidos en el gráfico. Se pueden mostrar hasta 50 suscriptores al mismo tiempo seleccionando su casilla de trazado y actualizando el gráfico (icono de recarga en la parte superior derecha del gráfico). Si se desmarca la casilla, el abonado desaparece del gráfico.

El gráfico mostrará las métricas de las IPs o IDs de abonado filtradas en la tabla de métricas, de forma que puede utilizar los selectores de políticas de tarifas o grupos de abonados para ver la evolución de sus métricas particulares.

Haciendo clic con el botón derecho en una IP o ID de la leyenda del gráfico se accede al panel de control de ese abonado.

Principales suscriptores por uso

La entrada de menú Estadísticas->Análisis de abonados->Volumen horario muestra los abonados con mayor consumo de tráfico a lo largo del tiempo. El uso puede mostrarse por dirección IP o por Id de Abonado utilizando la selección apropiada. El siguiente ejemplo muestra el uso por dirección IP:

Puede ir a la página del panel de control de un abonado haciendo clic con el botón derecho del ratón en la dirección IP o en el ID del abonado en la leyenda del gráfico.

En Estadísticas->Análisis de abonados->Volumen total se muestra el total en el periodo considerado. El siguiente ejemplo muestra el uso por ID de abonado:

Puede ir a la página del panel de control de un abonado haciendo clic en la dirección IP o en el ID del abonado en el gráfico circular.

También es posible exportar a un archivo CVS con el uso de hasta 500 suscriptores principales.

Tráfico y abonados por política

Statistics->Subscribers->Per Policy muestra la división de los suscriptores en las diferentes políticas de plan.

Statistics->Subscribers->Per Policy muestra la división del volumen de tráfico en las diferentes políticas de plan:

Estadísticas->Suscriptores->Por política también puede mostrar la división del volumen de tráfico en las diferentes políticas de flujo:

Tráfico por servicio

En Statistics->Service Analysis hay información sobre la composición del tráfico.

El BQN muestra la composición global del tráfico por servicio en Statistics->Service Analysis->Total Volume per Service.

La evolución horaria puede obtenerse en EStatistics->Service Analysis->Hourly Volume per Service.

Por defecto, todas las muestras DPI son consideradas por los informes(All UDRs), tanto las muestras generadas automáticamente por el BQN como las generadas por las políticas de monitorización. Si las políticas de monitorización generan tantas muestras que pueden causar un sesgo en los informes, esas muestras pueden ser excluidas seleccionando Only auto U DRs . Este podría ser el caso si varios abonados tienen una política de monitorización que genera UDRs para todo su tráfico y hace que estén sobrerrepresentados en la mezcla de muestras de tráfico.

Latencia por servicio

Para ver la latencia por servicio, vaya a Statistics->Service Analysis->Latency per Service.

Para ver la distribución de la latencia de un servicio concreto, haga clic en el icono del diagrama de barras de la columna DETALLES:

La distribución muestra el porcentaje de mediciones que caen en los distintos intervalos del rango de valores de latencia.

Para ver la evolución en el tiempo de esas latencias de Internet, haga clic en el enlace Distribución por tiempo de la parte superior derecha del gráfico:  

Para cada intervalo de tiempo,el gráfico muestra los porcentajes relativos de cada rango de latencia

Este análisis de la latencia por servicio, ya sea de forma global o a lo largo del tiempo, puede afinarse aún más filtrando con una dirección IP (o rango) del abonado, o por una dirección IP (o rango) del lado de Internet, lo que le permitirá estudiar la latencia de diferentes servicios procedentes de distintos proveedores, y específicamente para determinados abonados:

Abonados principales por servicio

Es posible identificar a los principales abonados de un determinado servicio, tanto los identificadores o direcciones de los abonados (IP del lado de acceso) como las direcciones de los servidores de contenidos en Internet.

En Estadísticas->Análisis de Servicios DPI->Volumen Total por Servicio, pulse sobre el sector circular del servicio cuyas IPs principales desea visualizar. Se mostrará un histograma de las direcciones IP principales, con las direcciones IP de los servidores en la parte superior y las direcciones de los abonados en la parte inferior. El histograma muestra el porcentaje del volumen total del servicio de esa dirección IP.

También es posible mostrar los ID de los principales abonados mediante el selector situado en la parte inferior de la página.

Se puede hacer clic en las direcciones: las IP de servidor llevarán a la distribución de latencia para esa IP de servidor y las IP o ID de abonado irán al panel de control del abonado.

Para obtener un fichero CVS con los porcentajes de volumen del servidor o del abonado, haga clic en el icono Exportar.

Métricas generales de tráfico

Statistics->Throughput->Overview muestra la evolución temporal del caudal total de tráfico, sumando ambas direcciones y todos los wires.

‍Statistics->Throughput->Protocols muestra la evolución temporal del rendimiento del tráfico, desglosado por:

  • Dirección: enlace descendente (DN) y enlace ascendente (UP).
  • Versión IP: IPV4, IPV6 o Sin IP.
  • L4 Tipo de protocolo: TCP, UDP u Otro protocolo IP.
  • Tráfico de circunvalación.

La evolución en el tiempo por interfaz de red está disponible en Statistics->Throughput->Interfaces.

Es posible comprobar cuánto tráfico se está procesando según cada una de las políticas configuradas. En el caso de las políticas de flujos de abonados , se puede comprobar en Statistics->Throughput->Subscriber Flows Policies y, de forma similar, en el caso de las políticas de planes de abonado y las políticas de monitorización.

El gráfico en Estadísticas->Sistema->Latencias muestra el RTT de acceso (RTT-Acceso). Es la media de todos los flujos del valor mínimo por flujo.

Además, Statistics->System->Retransmissions muestra los porcentajes medios de retransmisión en sentido descendente y ascendente.

Para ver el número de flujos por política y por protocolo, haga clic en Statistics->Flow->Per Policy y Statistics->Flow->Per Protocol respectivamente.

También puede ver el número instantáneo de Flujos por protocolo en Status->Flows->Per Protocol y por abonado en Status->Flows->Per Subscriber..

DoS

El BQN detecta los ataques de denegación de servicio. Para ello, se deben configurar los umbrales de DoS en Configuration->DoS:

  • Tasa de handshake fallido en bajada (Downlink failed handshake rate). SYNs por segundo sin respuesta en dirección a los abonados (inicializados desde Internet). Un valor típico es 50.
  • Tasa de handshake fallido en subida (Uplink failed handshake rate). SYNs por segundo sin respuesta inicializados por un abonado. Un valor típico es 50.
  • Tasa de velocidad mínima (Minimum rate) que puede considerarse un ataque volumétrico. El valor exacto depende de la velocidad de la red, pero un valor típico es 50 Mbps.
  • Multiplicadorde la política de plan (Multiplier of subscriber rate policy). Si el abonado tiene una política de velocidad conocida, el umbral se define como el multiplicador * límite  de bajada. Un multiplicador típico es 3. Por ejemplo, un abonado con un plan de 20Mbps tendrá un umbral de DoS de 3*20=60Mbps.

Los eventos DoS se muestran en Statistics->DoS Attacks. En DoS Attacks Over Time, se muestran los eventos de ataque DoS mostrando su tipo, su duración y parámetros como la IP del abonado afectado y la IP principal que contribuye al ataque.

En Detalles de Ataques DoS se listan todos los eventos DoS, con información sobre la hora, el tipo de evento, la dirección IP afectada, la dirección del ataque (entrada o salida) y su duración. En SYN Attacks se pueden encontrar ataques de tipo SYN, con el número de SYN fallidos y su tasa por segundo. En Ataques de Volumen se encuentra una lista de ataques volumétricos, con información del volumen de tráfico y su tasa media.

Métricas de grupos de abonados

Métricas de calidad de servicio del grupo de abonados

Para ver las métricas por grupo de abonados, vaya a Estado->Abonados->Grupos de abonados (también accesible desde Estadísticas->Abonados->Grupos de abonados).

En la parte superior de la página, hay un selector con la dirección del tráfico, el periodo de tiempo a considerar y la métrica a mostrar. Por defecto, se muestra la velocidad media del enlace descendente durante el último día.

Un gráfico muestra la evolución temporal de la métrica seleccionada para los 10 primeros grupos de abonados por uso de tráfico. Si no se definen grupos de abonados, sólo aparecerán los grupos de todos los abonados por defecto, con métricas de todo el tráfico combinado que pasa por el servidor BQN.

Debajo del gráfico, un mapa térmico muestra la métrica con una fila por grupo de abonados. El mapa térmico representa una escala de intensidad de color que mapea el rango de la métrica. Esto se muestra con una escala de colores a la izquierda del gráfico. Cuanto mayor sea el número, mayor será la intensidad del color.

Al hacer clic en una fila del mapa térmico, se elimina el grupo del gráfico y, si se vuelve a hacer clic, el grupo vuelve a aparecer. Un doble clic deja visible sólo ese grupo. Haciendo clic con el botón derecho se accede al panel de grupos de abonados.

La escala de colores es ajustable. Arrastrando los valores mínimo y máximo se centrará la gama de colores en ese intervalo métrico, dejando los valores por debajo y por encima pintados en los colores más claros y más oscuros respectivamente. Esto ayuda a centrar el análisis, haciendo zoom en ese intervalo métrico. El valor MEDIO se ajustará al intervalo seleccionado, con valores fuera del rango redondeados a los límites del intervalo.

Al situar el ratón sobre una celda del mapa de calor, se muestra su hora y valor exactos.

En la parte inferior de la página hay una tabla que enumera los grupos de abonados. La información de la tabla es la siguiente:

  • SUBSCRIBER-GROUP: el nombre del grupo de abonados. Al hacer clic en el nombre se accede al panel de control del grupo.
  • SUBS-ACTIVE: cuenta el número de abonados miembros de ese grupo que tienen una sesión activa en el servidor BQN. Haciendo clic en él se accede a la página de QoE del abonado filtrada por este grupo de abonados, de modo que allí se pueden comprobar las métricas de cada uno de los miembros del grupo.
  • FL-ACTIVE: número de flujos activos que forman parte del tráfico de este grupo.
  • LIM-Mbps: velocidad límite de velocidad establecida en esa dirección, en Mbps (n/a si no hay límite establecido).
  • RATE-POLICY: nombre de la política de tarifas que se aplica a este grupo (n/a si no hay política definida). La definición de la política es la que establece el límite mostrado en LIM-Mbps.
  • FL-CREATED: flujos creados hasta el momento pertenecientes a este grupo de abonados.
  • MBYTES: volumen total de tráfico de este grupo de abonados hasta el momento, en megabytes.
  • CURR-Mbps: velocidad actual en Mbps. 
  • MEAN-Mbps: velocidad media móvil en Mbps (calculada cada 10 minutos).
  • RTT-ms: media móvil de la latencia en milisegundos. Si se selecciona la dirección de enlace descendente, se muestra la latencia en el lado de acceso (hacia los abonados). Si se selecciona la dirección de enlace ascendente, se muestra la latencia en el lado de Internet.
  • RTX: la media móvil del porcentaje de retransmisiones TCP (directamente relacionadas con las pérdidas de paquetes). Si se selecciona la dirección de enlace descendente, se muestra la retransmisión en el lado de acceso (hacia los abonados). Si se selecciona la dirección de enlace ascendente, se muestra la retransmisión en el lado de Internet.
  • VELOCIDAD MÁXIMA: media móvil del porcentaje de tráfico con una velocidad cercana a la velocidad máxima.
  • CONGESTIÓN: media móvil del porcentaje de tráfico que sufre congestión.
  • LIFETIME: duración hasta ahora de este grupo de abonados.

Una columna PLOT en la tabla indica los grupos incluidos en el gráfico y el mapa térmico. Se pueden mostrar hasta 50 grupos de abonados al mismo tiempo seleccionando su casilla de selección de gráfico. El gráfico se actualiza automáticamente al cabo de unos segundos. Si se desmarca la casilla, el grupo desaparecerá del gráfico y del mapa térmico.

Es posible utilizar un filtro, para seleccionar sólo los grupos que tienen como miembro una dirección IP o un ID de abonado:

Si hemos llegado a la página de métricas de QoE de grupo desde el panel de control de un abonado (haciendo clic en Ver grupos de abonados en el panel de control del abonado), se mostrarán las métricas del abonado junto con las métricas de los grupos de los que es miembro:

Panel de control de grupos de abonados

Al hacer clic en el nombre de un grupo de abonados en la página QoE del grupo de abonados, se mostrará un panel del grupo de abonados, con las métricas en gráficos separados:

El dashboad muestra la evolución temporal durante el periodo seleccionado de las siguientes métricas del grupo de abonados:

  • Velocidades medias del enlace descendente y ascendente.
  • Flujos creados y flujos activos.
  • Acceso y latencias de Internet.
  • Acceso y retransmisiones de paquetes de Internet.
  • Porcentaje de tráfico que sufre congestión.
  • Porcentaje de tráfico a una velocidad cercana a la máxima.

También contiene gráficos de dispersión con la relación entre la velocidad media y las mediciones de latencia, retransmisión y congestión. Una línea roja muestra la posible correlación entre ambas. Estos gráficos ayudan a identificar las velocidades en las que otras métricas de calidad de servicio pueden deteriorarse (y quizá mitigarlo limitando la velocidad global de ese grupo).

Si coloca el ratón sobre un punto del gráfico, aparecerá un tooltip con su valor exacto. En los demás gráficos y en el mismo momento, la información sobre herramientas mostrará los valores de las demás métricas.

El cuadro de mandos también contiene un gráfico con la evolución temporal de los servicios DPI del grupo.

Para ver las métricas detalladas de cada miembro del grupo, haga clic en Ver abonado principal del grupo para ir a la página de métricas de QoE del abonado filtradas por este grupo de abonados.

Para ver la definición del grupo de abonados y/o modificarla, haga clic en Editar grupo de abonados.

Exportación de registros DPI

El producto BQN de Bequant genera información DPI para el tráfico que pasa por él, lo que permite identificar la composición de ese tráfico en términos de servicios y aplicaciones. La información puede visualizarse en la interfaz gráfica del producto BQN. Para facilitar la exportación de esta información para su procesamiento por sistemas de informes externos, este documento describe el comando shell de BQN que lo permite. El comando aquí descrito está disponible a partir de la versión R4.21.3.

Sintaxis del comando


show statistics dpi records all hours {HOURS} direction {all|downlink|uplink} 
       separator {” ”|”;”|”,”} [start {YYYY-mm-DDTHH:mm}]

{HOURS} Number of hours to show
{all|downlink|uplink} Traffic direction:
Downlink: towards end customers.
Uplink: from end customers towards the Internet.
all: both direction
{“ “|”;”|”,”} Separator to use between fields:
“ “: spaces
“;”: semicolon
“,”: colon
{YYYY-mm-DDTHH:MM} Optional. Initial date of the registers.
{Year}-{Month}-{Day}T{hour}:{minute}
If a start date is specified, the command will return the requested number of hours starting from that date.
If no start date is specified, the command will return the latest hours up to the present moment.

Ejemplo:

Registros DPI del14 de Abril de 2024:


show statistics dpi records all hours 24 direction all separator ";" start 2024-04-14T00:00

Formato de salida

El comando devuelve una línea por registro, con los campos de cada registro separados por el carácter elegido. Por ejemplo:


TIME;VER;SUBSCRIBER-ID;CLIENT-IP;CLIENT-PORT;SERVER-IP;SERVER-PORT;DIRECTION;BYTES;DURATION;
ACCESS-RTT;INET-RTT;PROTOCOL;DOMAIN;DPI
2024-04-16T06:58:44.809751-0500;1;"c4:69:f0:90:d9:7d";100.68.150.39;2939;17.253.7.143;443;
DOWNLINK;35667;0.194;4120;84309;tcp;"app-site-association.cdn-apple.com";"apple"
2024-04-16T06:58:46.007509-0500;1;"c4:69:f0:90:d9:7d";100.68.150.110;51807;181.39.187.161;443;
DOWNLINK;72441;0.018;6331;722;tcp;"media.fgye1-1.fna.whatsapp.net";"whatsapp”
. . . 

La primera línea es la cabecera. Los campos son los siguientes:

Field Format Description / Example
TIME YYYY-mm-DDT

HH:mm:SS.ssssss{+|-}

Date of record generation.
{Year}-{Month}-{Day}T{hour}:{minute}:{second}.{microsecond}{offset with UTC time zone}
Example:
2024-03-04T18:19:04.767169+0100
(4th of March, 2024, time 18:19:04, at UTC+1)
VER Integer Output format version. It will change if the format changes in the future, to identify records with the old and new formats.
Example: 1
SUBSCRIBER-ID String Subscriber identifier.
Example: “Sub-1”
CLIENT-IP IPv4 or IPv6 address IP address of the client/subscriber.
Examples:
10.0.0.1
ff01:abcd:ef01:2345::
CLIENT-PORT Integer TCP/UDP port of the subscriber side.
Example: 5463
SERVER-IP IPv4 or IPv6 address IP address of the Internet server.
Examples:
51.116.253.169
2001:4860:4860::8888
SERVER-PORT Integer TCP/UDP port of the Internet server.
Example: 443
DIRECTION DOWNLINK or UPLINK Traffic direction associated to this record.
DOWNLINK
UPLINK
BYTES Integer IP byte total reported by this record.
DURATION Float Duration in seconds of the activity period associated to the reported traffic volume.
Example: 0.194
Dividing by BYTES*8/DURATION yields the average speed of the reported volume. Example:
35667 * 8 / 0.194 = 1,47 Mbps
ACCESS-RTT Integer Access latency (downlink) in microseconds.
Example:
417 (0.417 ms)
INET-RTT Integer Internet latency (uplink) in microseconds.
Example:
28163 (28.163 ms)
PROTOCOL Integer IP protocol number.
Examples:
6 (TCP)
17 (UDP)
DOMAIN String Domain, as it is extracted from the SNI field (Service Name Identifier) by the DPI.
Example: “oca.nflxvideo.net”
DPI String Category that the BQN associated to this domain.
Example: “netflix”

Cuando se utilizan ; o , como separadores, los campos SUBSCRIBER-ID, DOMAIN y DPI se encierran entre comillas dobles. Las comillas dobles dentro de cualquiera de esos campos se escapan con comillas dobles (" es ""), siguiendo la recomendación RFC4180.

Invocación

El comando se invoca desde el shell BQN (no desde el shell Linux del servidor BQN). Basta con un usuario de perfil operador. Por ejemplo:


bqnop@bqn1> show statistics dpi records all hours 24 direction all separator “;”

El comando puede ser invocado remotamente usando ssh:


C:\Users\me> ssh bqnop@arzua 'show statistics dpi records all hours 24 direction all separator ";"

Y también redirigir la salida a un archivo local:


C:\Users\me> ssh bqnop@arzua 'show statistics dpi records all hours 24 direction all separator ";"' > my-dpi.csv

Se recomienda consultar una vez al día, en horas de poco tráfico:


C:\Users\me> ssh bqnop@arzua 'show statistics dpi records all hours 24 direction all separator ";" start 2024-04-15T00:00' > dpi-20240415.csv

Importación de

Los ficheros generados por la salida del comando descrito son directamente importables por herramientas que acepten el estándar CSV (por ejemplo, MSExcel).

Todos los registros se marcan con su fecha y hora de generación y se ciñen al periodo solicitado, pero no se garantiza que se devuelvan en orden de fecha (la razón es que la información se obtiene de diversas fuentes, que pueden alterar el orden). Por lo tanto, si desea realizar un análisis temporal dentro del periodo solicitado, los registros deben ordenarse por fecha una vez importados a la herramienta de elaboración de informes.

Etiquetas de estilo Docs
[.p-highlight] Lorem ipsum... [.p-highlight]

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat. Aenean faucibus nibh et justo cursus id rutrum lorem imperdiet. Nunc ut sem vitae risus tristique posuere.

[.p-highlight-blue] Lorem ipsum... [.p-highlight-blue]

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat. Aenean faucibus nibh et justo cursus id rutrum lorem imperdiet. Nunc ut sem vitae risus tristique posuere.

[.p-highlight-red] Lorem ipsum... [.p-highlight-red]

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat. Aenean faucibus nibh et justo cursus id rutrum lorem imperdiet. Nunc ut sem vitae risus tristique posuere.

Vista previa para el estilo de una sola [.c-highlight]palabra monoespaciada[.c-highlight].
Avance del single word mono-spaced con estilo.
anterior
SIGUIENTE