Documentos BQN

Grupos de abonados

Un grupo de abonados es un conjunto de abonados. Un abonado puede asociarse a un grupo mediante una dirección IP o un identificador de abonado. Un abonado puede pertenecer hasta a ocho grupos de abonados diferentes.

El BQN puede mostrar métricas de red por grupo de abonados. Dependiendo de cómo se definan los grupos, esas métricas permiten el análisis por puntos de acceso, subredes de red o cualquier categorización de clientes que pueda asignarse a grupos.

‍

Crear grupos de abonados

Para crear un grupo de abonados, vaya a Estado->Abonados->Grupos de abonados. También se puede acceder desde Configuración->Grupos de abonados .

Clockon Añadir grupo de abonados...

Un grupo de abonados recibe un nombre, sin espacios.

Se pueden definir miembros abonados:

• Por dirección IP, pulsando en Añadir dirección IP...
• Por ID de abonado, haciendo clic en Añadir ID de abonado...

Las direcciones IP y/o IDs pueden añadirse cargando un fichero textual con una entrada por línea. Las opciones de carga de archivos se encuentran en el menú de la parte superior derecha. Ejemplos:

• La opción de menú Combinar direcciones IP desde archivo... añadirá las direcciones IP contenidas en el archivo a las ya existentes en el grupo.
• La opción de menú Sustituir identificadores de abonado por fichero... sustituirá el conjunto actual de identificadores de abonado por los contenidos en el fichero cargado.

‍

La tabla de la derecha, Direcciones IP actuales, muestra todas las direcciones IP que forman parte del grupo, ya sea porque se han añadido directamente o porque están asociadas a un identificador de abonado que forma parte del grupo. La tabla también indica qué direcciones IP tienen tráfico(Activo sí).

Los grupos de abonados creados aparecen en la tabla Estado->Abonados->Grupos de abonados y pueden editarse pulsando el icono de edición.

‍

Ver métricas de grupos de abonados

En Estado->Suscriptores->Grupos de suscriptores o en Estadísticas->Suscriptores->Grupos de suscriptores, una tabla muestra los grupos de suscriptores definidos y sus métricas.

‍

Para ver los gráficos con la evolución temporal de las métricas de los grupos principales, active el interruptor Mostrar evolución temporal de las métricas.

‍

El gráfico mostrará por defecto los 10 primeros grupos de abonados, y una columna PLOT en la tabla indica los grupos incluidos en el gráfico. Se pueden mostrar hasta 30 grupos de abonados 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 deselecciona la casilla, el grupo desaparecerá del gráfico.

Las métricas pueden ser para el sentido descendente o ascendente, y para un periodo de tiempo de hasta tres meses.

Las métricas disponibles son:

• Velocidad media.
• Flujos activos.
• Flujos creados por minuto.
• Latencia.
• Retransmisión.
• Congestión.
• % de tráfico que circula a velocidad máxima.

Estas métricas son similares a las que se muestran para un abonado (para más detalles, consulte la descripción del panel de control del abonado en la sección Visibilidad de la red ).

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

‍

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

‍

Al filtrar por dirección IP, una columna PERMANENTE indica si el grupo de abonados se ha asignado a esta dirección IP mediante CLI o REST (permanente) o mediante RADIUS o Facturación (no permanente). Por lo tanto, las asignaciones a un grupo de abonados mediante REST o CLI tienen prioridad sobre RADIUS y Facturación, por lo que puede utilizarlas para ajustar la pertenencia a un grupo de abonados,

También es posible ir a esta página haciendo clic con el botón derecho del ratón en el nombre del grupo de abonados en la leyenda del gráfico o en el propio gráfico.

‍

Gestión de grupos de abonados desde REST API

Además de la interfaz gráfica de usuario, se puede utilizar la API REST de BQN para gestionar los grupos de abonados.

‍

Para añadir una IP existente 10.0.0.35 a un grupo de abonados "ciudad-norte":

curl -k -u myuser:mypassword -X PUT https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35 -H "Content-Type: application/json" --data '{"subscriberGroups": ["city-north”]}'

‍

El grupo de abonados se creará automáticamente si no existe.

La lista de grupos debe reflejar siempre la lista completa de miembros. Por ejemplo, para añadir una IP existente 10.0.0.35 a un grupo de abonados "vip":

curl -k -u myuser:mypassword -X PUT https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35 -H "Content-Type: application/json" --data '{"subscriberGroups": ["city-north”, “vip”]}'

‍

Si la IP tiene membresías de grupo, serán devueltas por un GET:

curl -k -u myuser:mypassword -X GET https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35

{
  "subscriberIp" : "10.0.0.35",
  "subscriberId" : "sub-12",
  "subscriberGroups" : [ "city-north", "vips" ],
  "policyRate" : "Plan-200Mbps"
}

‍

La pertenencia a un determinado grupo de abonados puede obtenerse del siguiente modo:

curl -k -u myuser:mypassword -X GET https://192.168.0.121:3443/api/v1/subscriberGroups/city-north

{
  "subscriberGroupName" : "city-north",
  "memberSubscriberIps" : [ "10.0.0.35", "10.0.0.15", "10.0.0.25", "10.0.0.10" ]
}

‍

Y para obtener la lista completa de grupos de abonados:

curl -k -u myuser:mypassword -X GET https://192.168.0.121:3443/api/v1/subscriberGroups

{
  "items" : [
    {
      "subscriberGroupName" : "city-north",
      "memberSubscriberIps" : [ "10.0.0.35", "10.0.0.15", "10.0.0.25", "10.0.0.10" ]
    },
    {
      "subscriberGroupName" : "vips",
      "memberSubscriberIps" : [ "10.0.0.35", "10.0.0.15", "10.0.0.25", "10.0.0.20" ]
    }
  ]
}

‍

Puede añadir a un grupo abonados por sus IDs, enviando un PUERTO con la lista de IDs al punto final del grupo de abonados:

curl -k -u myuser:mypassword -X POST https://192.168.0.121:3443/api/v1/subscriberGroups/city-north -H "Content-Type: application/json" --data '{memberSubscriberIds: [“sub-1”, “sub-2”, “sub-3”]}’

Consulte la referencia de la API REST para obtener más detalles.

‍

Gestión de grupos de abonados desde RADIUS

BQN en el despliegue de proxy RADIUS puede gestionar grupos de abonados. Consulte el capítulo RADIUS para obtener más información.