Documentazione BQN
Documentazione BQN

Gruppi di abbonati

Un gruppo di abbonati è un insieme di abbonati. Un abbonato può essere associato a un gruppo tramite un indirizzo IP o un ID abbonato. Un abbonato può appartenere a un massimo di otto gruppi di abbonati diversi.

Il BQN può mostrare le metriche di rete per gruppo di abbonati. A seconda di come vengono definiti i gruppi, queste metriche consentono di analizzare i punti di accesso, le sottoreti di rete o qualsiasi categorizzazione dei clienti che possa essere mappata in gruppi.

Creare gruppi di abbonati

Per creare un gruppo di abbonati, andare su Stato->Abbonati->Gruppi di abbonati e cliccare su Aggiungi gruppo di abbonati ...

A un gruppo di abbonati viene assegnato un nome, senza spazi.

È possibile definire i membri dell'abbonamento:

  • Per indirizzo IP, cliccando su Aggiungi indirizzo IP...
  • Per ID abbonato, cliccando su Aggiungi ID abbonato...

Gli indirizzi IP e/o gli ID possono essere aggiunti caricando un file di testo con una voce per riga. Le opzioni di caricamento del file si trovano nel menu in alto a destra. Esempi:

  • L'opzione di menu Unisci indirizzo IP da file... aggiunge gli indirizzi IP contenuti nel file a quelli già esistenti nel gruppo.
  • L'opzione di menu Sostituisci gli ID abbonati con il file... sostituisce l'insieme degli ID abbonati attuali con quelli contenuti nel file caricato.

La tabella a destra, Indirizzi IP correnti, mostra tutti gli indirizzi IP che fanno parte del gruppo, sia perché aggiunti direttamente, sia perché associati a un ID utente che fa parte del gruppo. La tabella indica anche quali indirizzi IP hanno traffico(Attivo sì).

I gruppi di abbonati creati sono elencati nella tabella Stato->Abbonati->Gruppi di abbonati e possono essere modificati cliccando sull'icona di modifica.

Vedere Metriche del gruppo di abbonati

In Stato->Abbonati->Gruppi di abbonati, un grafico nella parte superiore della pagina mostra le metriche dei gruppi creati:

Le metriche possono riguardare le direzioni downlink o uplink e un periodo di tempo fino a tre mesi.

Le metriche disponibili sono:

  • Velocità media.
  • Flussi attivi.
  • Flussi creati al minuto.
  • Latenza.
  • Ritrasmissione.
  • Congestione.
  • % di traffico che procede alla massima velocità.

Queste metriche sono simili a quelle mostrate per un abbonato (per maggiori dettagli, vedere la descrizione della dashboard Abbonato nella sezione visibilità della rete per i dettagli).

Per impostazione predefinita, nel grafico vengono visualizzati fino a trenta gruppi. È possibile decidere quali gruppi includere selezionando o meno le relative caselle di PLOT.

È possibile utilizzare un filtro per selezionare solo i gruppi che hanno come membro un indirizzo IP o un ID utente:

Facendo clic sul nome di un gruppo di abbonati, viene visualizzata una dashboard del gruppo di abbonati, con le metriche in grafici separati:

Gestire i gruppi di abbonati da API REST

Oltre all'interfaccia grafica, è possibile utilizzare l'API REST di BQN per gestire i gruppi di abbonati.

Per aggiungere un IP 10.0.0.35 esistente a un gruppo di abbonati "city-north":


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”]}'

Il gruppo di abbonati viene creato automaticamente se non esiste.

L'elenco dei gruppi deve sempre riflettere l'elenco completo dei membri. Ad esempio, per aggiungere un IP 10.0.0.35 a un gruppo di abbonati "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”]}'

Se l'IP ha appartenenze a un gruppo, queste verranno restituite da 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"
}

L'appartenenza a uno specifico gruppo di abbonati può essere ottenuta come segue:


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" ]
}

E per ottenere l'elenco completo dei gruppi di abbonati:


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" ]
    }
  ]
}

È possibile aggiungere a un gruppo gli abbonati in base ai loro ID, inviando un PORT con l'elenco degli ID al punto finale del gruppo di abbonati:


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”]}’

Per maggiori dettagli, consultare il riferimento all'API REST.

precedente
AVANTI