Documentos BQN

Assinante Dashboad

O painel de controlo do assinante inclui um conjunto muito completo de informações úteis sobre o desempenho atual e passado do assinante. É o local ideal para analisar e diagnosticar os problemas comunicados no acesso aos dados do assinante.

Pode ser alcançado clicando no ID do subscritor ou no endereço IP do subscritor em qualquer uma das seguintes janelas:

• Status->Subscritores
• Status->Flows->Por Assinante
• Status->RADIUS/REST/Billing->Subscriptores

O painel de bordo do assinante contém muita informação, por isso use a barra de deslocamento do lado direito para navegar através dele.

‍

O painel de bordo contém as seguintes informações:

• Parâmetros da sessão principal do assinante (incluindo a taxa e as políticas de monitorização aplicadas, IP e ID do assinante, etc.). Clique em Detalhes adicionais para ver mais informações. Clique em ViewSubscriber Groups (Exibir grupos de assinantes ) para acessar a lista de grupos dos quais este assinante é membro. As métricas do assinante podem ser comparadas com as dos grupos, para avaliar se a QoE está dentro dos valores normais.
• Ícones de marcação com um resumo das métricas mais recentes.
• Gráficos com a evolução ao longo do tempo das principais métricas do assinante: velocidades médias e máximas, latências, retransmissões de pacotes (perdas), tráfego a alta velocidade, congestionado e limitado pelo ACM, reduções da latência e das perdas graças ao ACM e número de fluxos (criados por minuto e activos).

• Gráfico com a utilização do serviço do subscritor ao longo do tempo.
• Latências de Internet sentidas por este assinante para os serviços mais utilizados. Clicando na barra do gráfico, passa-se para o histograma com a distribuição das latências e, a partir daí, para a evolução do histograma ao longo do tempo.
• Tabela com os fluxos activos do assinante. A política de fluxo é fornecida (clique no nome da política para ir para a definição da política). Se disponível, também mostra o domínio DPI (coluna DOMAIN) e a categoria DPI do fluxo (coluna DPI).

Os gráficos anteriores mostram a evolução temporal da velocidade média e máxima, do número de fluxos e da latência de acesso. Para a latência de acesso, é também incluída a média da rede como referência, para determinar se o assinante está abaixo ou acima da qualidade média da rede.

Os gráficos seguintes descrevem a retransmissão do pacote no lado do acesso, incluindo também a média da rede como referência. Os últimos três gráficos contêm informações sobre a funcionalidade de Gerenciamento Automático de Congestionamento para esse assinante.

Três gráficos de dispersão mostram a possível correlação entre a velocidade e as medições de latência, perdas e congestionamento. Por exemplo, no gráfico de velocidade vs latência, um ponto é um par velocidade-latência medido ao mesmo tempo. Uma linha vermelha mostra a possível correlação entre os dois (a linha que melhor se ajusta aos pontos):

‍

Para monitorizar o subscritor mais de perto, coloque o interrutor do modo Em direto em Ligado. Aparecerão gráficos com a evolução atual das principais métricas. É apresentada uma tabela de fluxos, incluindo a composição do DPI. Pode ser apresentado um período de tempo máximo (último número de minutos). Este é configurável para 2, 5 ou 10 minutos, utilizando o seletor junto ao interrutor do modo Em direto. Quando o período de tempo for atingido, por exemplo, após 5 minutos, os gráficos continuarão a ser actualizados, mostrando a janela dos últimos cinco minutos.

‍

Uma tabela de fluxos também será incluída e será continuamente actualizada. Os fluxos são ordenados na tabela com os fluxos activos em primeiro lugar e, entre eles, os fluxos mais rápidos. São apresentadas as categorias e os domínios DPI. As velocidades não nulas são destacadas a azul para facilitar a identificação dos fluxos activos. É possível exibir os gráficos de vida com mais espaço vertical clicando no ícone Layout ↕.

‍

O modo em direto terminará quando o interrutor do modo em direto for colocado em Off ou após quinze minutos.

‍

Identificador de assinante (ID)

Para facilitar a identificação de uma sessão de subscritores, é suportado um campo de identificação de subscritores. O ID de subscritor pode ser utilizado ao solicitar métricas, para obter informação histórica mesmo quando o subscritor mudou de endereço IP ao longo do tempo.

Existem várias fontes possíveis para a identificação do subscritor:

• Endereço de acesso MAC (esta é a predefinição). Em algumas redes, o endereço MAC pode ser o mesmo para todos os assinantes (por exemplo, se todo o tráfego vier da mesma porta do router), mas noutras redes, pode identificar os pontos de acesso dos assinantes.
• Endereço IP de acesso do assinante. Para configurar o endereço IP para preencher o ID de assinante, vá a Administração->Configurações gerais->Fonte de ID de assinante predefinida.
• Um sistema externo: o sistema externo pode utilizar a API REST do BQN, RADIUS ou um dos nossos sistemas de facturação.

‍

Métricas de QoE do Assinante

Status->Subscritores dá acesso à lista de subscritores activos juntamente com as suas métricas (se o subscritor de interesse não estiver listado, escreva o endereço IP no campo do filtro).

‍

Para facilitar a identificação dos assinantes com problemas de qualidade da experiência, utilizamos mapas de calor e limiares de alerta.

‍

É fornecido um mapa de calor para o subconjunto de assinantes cujas métricas são representadas no gráfico. O mapa de calor representa uma escala de intensidade de cor que mapeia o intervalo de métricas. Isso é mostrado com uma escala de cores à esquerda do gráfico de métricas. Quanto maior o número, maior a intensidade da cor. Cada subscritor tem uma linha com a evolução da métrica ao longo do tempo. Clicando na linha, o assinante é desplotado e clicando novamente, o assinante volta a ser plotado. Um duplo clique deixa visível apenas esse assinante. Um clique com o botão direito do rato permite aceder ao painel de controlo do assinante.

Uma coluna MÉDIA à esquerda do mapa de calor mostra o valor médio da métrica, para cada assinante, durante o período de tempo selecionado. Os assinantes podem ser ordenados por esse valor médio em ordem crescente ou decrescente.

A escala de cores é ajustável. Se arrastar os valores mínimo e máximo, a gama de cores será focada nesse intervalo métrico, deixando os valores abaixo e acima pintados nas cores mais claras e mais escuras, respetivamente. Isto ajuda a focar a análise, fazendo zoom nesse intervalo métrico. O valor MÉDIO será ajustado ao intervalo selecionado, com os valores fora do intervalo arredondados para os limites do intervalo.

Relativamente aos limiares de aviso, a coluna AVISO na tabela de métricas mostra uma pontuação com o número de métricas acima do seu limiar de aviso. Ordene a tabela para que os valores WARN mais altos sejam mostrados primeiro.

Para evitar destacar assinantes que estão simplesmente inactivos, é aplicado um limiar à velocidade média(limiar de aviso MEAN-Mbps, na janela superior direita). Se um cliente não atingir pelo menos esta velocidade média, não receberá uma pontuação de aviso e não será realçado. O limiar pode ser alterado, mas em geral isto não é necessário.

Status->Subscribers->QoE Metrics contém as informações que estavam em Status->Subscribers nas versões anteriores.

‍

Lotes de caixas

Para facilitar o acompanhamento da qualidade do acesso dos assinantes, cinco gráficos de caixa resumem a distribuição destas métricas-chave:

• MAX-Mbps: velocidade máxima em Mbps.
• RTT-ms: latência de acesso em milissegundos.
• RTX: taxa de perda de pacotes em percentagem
• VELOCIDADE MÁX: percentagem do tráfego que circula à velocidade máxima ou perto dela.
• CONGESTIONAMENTO: percentagem do tráfego que sofre de congestionamento.

Um gráfico de caixa é um resumo da distribuição de um conjunto de valores. Mostra os valores máximo e mínimo, a mediana (valor que separa a metade inferior da metade superior) e o^1º e^3º quartis (valores que separam os 25% inferiores e os 25% superiores, respetivamente):

‍

Os valores exactos dos percentis são apresentados no lado direito de um boxplot.

‍

Limiares de advertência

Um limiar configurável ajuda a identificar quais os assinantes que estão com problemas. Por exemplo, se o limiar RTT for fixado em 20ms, o gráfico da caixa ficará vermelho todos os valores entre 20ms e o máximo. Na tabela, os valores RTT acima do limiar serão também sombreados a vermelho, tornando muito fácil identificar os clientes afectados. A tabela pode ordenar a coluna métrica para mostrar primeiro os maiores valores (clicar na etiqueta da coluna para o fazer).

‍

O valor do limiar de aviso é mostrado no topo da parcela de caixa. Para o ajustar, clicar no ícone do lápis no canto superior direito do gráfico da caixa.

‍

Percentis de destaque

Também é possível ver o quartil de um valor, ajustando o botão de colorir no canto superior direito da página. Os códigos dos quartis são:

• ^1º quartil: azul
• ^2º quartil (até à mediana): verde
• ^3º quartil: laranja
• ^4º quartil (do^3º ao máximo): vermelho

‍

Tabela de subscritores activos

As informações fornecidas no quadro são as seguintes:

• IP-ADDR: endereço IP do assinante.
• SUBS-ID: identificador de subscritor. Endereço MAC por padrão, embora possa ser preenchido utilizando informações externas do sistema (ver secções RADIUS e Facturação).
• RATE-POLICY: nome da política de tarifas aplicada a este assinante.
• TOTAL-MBYTES: volume total de tráfego desta sessão de subscritores, em megabytes.
• ACTIVE-FLOWS: número total de fluxos de tráfego (principalmente ligações TCP e fluxos UDP) deste assinante que estão activos (troca de tráfego).
• CURR-Mbps: velocidade actual em Mbps.
• MAX-Mbps: velocidade máxima em Mbps durante um período de um dia.
• RTT-ms: latência mínima de acesso em milissegundos durante um período de um dia.
• RTX: percentagem média de perdas de pacotes durante um período de um dia.
• MAX-SPEED: percentagem de tráfego com uma velocidade próxima da velocidade máxima, ao longo de um dia.
• CONGESTIONAMENTO: percentagem de tráfego a sofrer congestionamento, durante um dia.
• LIFETIME: duração até ao momento desta sessão de subscritor.

Um clique no endereço IP ou ID do subscritor leva ao painel de instrumentos do subscritor, com dados históricos até três meses.

‍

Métricas ao longo do tempo

A página de métricas QoE mostra a evolução temporal das métricas de alguns assinantes seleccionados:

‍

O gráfico mostrará, por defeito, os primeiros 10 assinantes da tabela de métricas, e uma coluna PLOT na tabela indica os assinantes incluídos no gráfico. É possível mostrar até 50 subscritores ao mesmo tempo, seleccionando a respectiva caixa de verificação e actualizando o gráfico (ícone de recarga no canto superior direito do gráfico). Se se anular a seleção da marca de verificação, o assinante será retirado do gráfico.

O gráfico mostrará as métricas dos IPs ou IDs de assinantes filtrados na tabela de métricas, pelo que pode utilizar os selectores de política de taxas ou de grupo de assinantes para ver a evolução das suas métricas específicas.

Clicar com o botão direito do rato num IP ou ID da legenda do gráfico conduzirá ao painel de controlo desse assinante.

‍

Top Assinantes por Utilização

A entrada de menu Statistics->Subscribers Analysis->Hourly Volume exibe os assinantes com o maior consumo de tráfego ao longo do tempo. A utilização pode ser mostrada por endereço IP ou por ID de Subscritores utilizando a selecção apropriada. O exemplo seguinte mostra a utilização por IP-Addr:

Pode aceder a uma página do painel de controlo do assinante clicando com o botão direito do rato no endereço IP ou no ID do assinante na legenda do gráfico.

As Estatísticas->Análise de Subscritores->Volume Total mostra o total no período que está a ser considerado. O exemplo seguinte mostra a utilização por ID de subscritor:

Pode aceder a uma página do painel de controlo do assinante clicando no endereço IP ou no ID do assinante no gráfico circular.

Também é possível exportar para um ficheiro CVS com a utilização de um máximo de 500 assinantes de topo.

‍

Tráfego e Assinantes por Política

Statistics->Subscribers->Per Policy mostra a divisão dos subscritores nas diferentes políticas de tarifas.

Statistics->Subscribers->Per Policy mostra a divisão do volume de tráfego nas diferentes políticas de tarifas:

Estatísticas->Subscritores->Por política também pode mostrar a divisão do volume de tráfego nas diferentes políticas de fluxo:

‍

Tráfego por serviço

Em Statistics->Service Analysis existe informação sobre a composição do tráfego.

O BQN mostra a composição global do tráfego por serviço em Statistics->Service Analysis->Total Volume por Serviço.

A evolução horária pode ser obtida em Statistics->Service Analysis->Hourly Volume por Serviço.

por padrão, todas as amostras DPI são consideradas pelos relatórios(Todos os UDRs), tanto as amostras geradas automaticamente pelo BQN como as geradas pelas políticas de monitorização. Se as políticas de monitorização gerarem tantas amostras que possam causar um enviesamento no relatório, essas amostras podem ser excluídas, seleccionando Only auto UDRs. Este poderá ser o caso se vários subscritores tiverem uma política de monitorização que gere UDRs para todo o seu tráfego e os torne sobre-representados na mistura de amostras de tráfego.

‍

Latência por serviço

Para ver a latência por serviço, vá a Statistics->Service Analysis->Latency per Service.

Para ver a distribuição da latência de um determinado serviço, clique no ícone do gráfico de barras na coluna DETALHES:

A distribuição mostra a percentagem de medições que se enquadram nos diferentes intervalos da gama de valores de latência.

Para ver a evolução ao longo do tempo dessas latências da Internet, clique na ligação Distribuição por tempo no canto superior direito do gráfico:  

Para cada intervalo de tempo, o gráfico mostra as percentagens relativas de cada intervalo de latência

Esta latência por análise de serviço, quer globalmente quer ao longo do tempo, pode ser aperfeiçoada através de filtragem com um endereço IP (ou intervalo) de endereço de assinante, ou por um endereço IP do lado da Internet (ou intervalo), o que lhe permitirá estudar a latência de diferentes serviços provenientes de diferentes fornecedores, e especificamente para certos assinantes:

‍

Principais subscritores por serviço

É possível identificar os principais subscritores de um determinado serviço, tanto os ID ou endereços de subscritores (access-side IPs) como os endereços de servidores de conteúdo através da Internet.

Em Statistics->DPI Service Analysis->Total Volume Per Service, clique no sector do serviço cujos IPs principais pretende visualizar. Será apresentado um histograma dos principais endereços IP, com os endereços IP do servidor na parte superior e os endereços dos assinantes na parte inferior. O histograma mostra a percentagem do volume total do serviço desse endereço IP.

Também é possível mostrar as identificações dos assinantes de topo utilizando o selector na parte inferior da página.

Os endereços são clicáveis: os IPs do servidor conduzirão à distribuição da latência para esse IP do servidor e os IPs ou IDs dos assinantes irão para o painel de controlo dos assinantes.

Para obter um ficheiro CVS com as percentagens dos volumes do servidor ou dos assinantes, clique no ícone Exportar.

‍

Métricas Globais de Tráfego

Statistics->Throughput->Overview mostra a evolução temporal do tráfego total, somando as duas direcções e todos os wires.

‍Statistics->Throughput->Protocols mostra a evolução temporal da taxa de transferência de tráfego, discriminada por:

• Direcção: ligação descendente (DN) e ligação ascendente (UP).
• Versão IP: IPV4, IPV6 ou Sem IP.
• L4 Tipo de protocolo: TCP, UDP ou outro protocolo IP.
• Contornar o tráfego.

‍

A evolução ao longo do tempo por interface de rede está disponível em Statistics->Throughput->Interfaces.

É possível verificar quanto tráfego está a ser processado de acordo com cada uma das políticas configuradas. Para políticas de Fluxos de Subscritores , pode ser verificado em Statistics->Throughput->Subscriber Flows Policies e de forma semelhante para Subscriber Rate Policies e Subscriber Monitoring Policies.

O gráfico em Estatísticas->Sistema->Latências mostra o RTT de acesso (RTT-Access). É a média de todos os fluxos do valor mínimo por fluxo.

‍

Além disso, Statistics->System->Retransmissions mostra a percentagem média de retransmissões na rede de acesso:

Para ver o número de fluxos por política e por protocolo, clicar em Statistics->Flow->Per Policy e Statistics->Flow->Per Protocol respectivamente.

Também pode ver o número instantâneo de fluxos por protocolo em Status->Flows->Por Protocolo e por subscritor em Status->Flows->Por subscritor.

Rendimento vitalício dos assinantes principais

‍

Vá a Status->Subscribers->Throughput para ver em tempo real o débito dos maiores subscritores por volume de utilização:

‍

‍

DoS

O BQN detecta ataques de Negação de Serviço. Para o fazer, os limiares de DoS devem ser configurados em Configuração->DoS:

• Taxa de apertos de mão falhados Downlink. SYNs por segundo sem uma resposta na direcção dos assinantes (inicializados a partir da Internet). Um valor típico é 50.
• Taxa de apertos de mão falhados. SYNs por segundo sem uma resposta inicializada por um assinante. Um valor típico é 50.
• Taxa mínima. Taxa mínima de velocidade que pode ser considerada um ataque volumétrico. O valor exacto depende da velocidade da rede, mas um valor típico é de 50 Mbps.
• Multiplicador da política de taxas de assinantes. Se o assinante tiver uma política de taxas conhecida, um limiar é definido como multiplicador *limite de descida do link. Um multiplicador típico é 3. Por exemplo, um assinante com um plano de 20Mbps terá um limite DoS de 3*20=60Mbps.

‍

Os eventos do DoS são mostrados em Statistics->DoS Attacks. Em DoS Attacks Over Time, os eventos de ataque DoS são mostrados mostrando o seu tipo, a sua duração e parâmetros tais como o IP do subscritor afectado e o IP principal que contribui para o ataque.

Em Detalhes de ataques DoS são listados todos os eventos DoS, com informações sobre a hora, o tipo de evento, o endereço IP afetado, a direção do ataque (entrada ou saída) e a sua duração. Em Ataques SYN podem ser encontrados ataques do tipo SYN, com o número de SYN falhados e a sua taxa por segundo. Em Volume Attacks há uma lista de ataques volumétricos, com informações do volume de tráfego e sua taxa média.

‍

Métricas do grupo de assinantes

Métricas de QoE do grupo de assinantes

Para ver as métricas por grupo de subscritores, vá a Status->Subscribers->Subscriber Groups (também acessível a partir de Statistics->Subscribers->Subscriber Groups).

No topo da página, existe um seletor com a direção do tráfego, o período de tempo a considerar e a métrica a apresentar. Por defeito, é apresentada a velocidade média da ligação descendente no último dia.

Um gráfico mostra a evolução temporal da métrica selecionada para os primeiros 10 grupos de assinantes por utilização de tráfego. Se não forem definidos grupos de assinantes, apenas serão apresentados os grupos predefinidos de todos os assinantes, com métricas de todo o tráfego combinado que passa pelo servidor BQN.

Abaixo do gráfico, um mapa de calor apresenta a métrica com uma linha por grupo de subscritores. O mapa de calor representa uma escala de intensidade de cor que mapeia o intervalo da métrica. Isso é mostrado com uma escala de cores à esquerda do gráfico. Quanto maior o número, maior a intensidade da cor.

Clicar numa linha do mapa de calor remove o grupo do gráfico e clicar novamente coloca o grupo de volta. Um clique duplo deixa apenas esse grupo visível. Um clique com o botão direito do rato vai para o painel de controlo do grupo de subscritores.

A escala de cores é ajustável. Se arrastar os valores mínimo e máximo, a gama de cores será focada nesse intervalo métrico, deixando os valores abaixo e acima pintados nas cores mais claras e mais escuras, respetivamente. Isto ajuda a focar a análise, fazendo zoom nesse intervalo métrico. O valor MÉDIO será ajustado ao intervalo selecionado, com os valores fora do intervalo arredondados para os limites do intervalo.

Colocar o rato sobre uma célula do mapa de calor mostra o seu tempo e valor exactos.

Na parte inferior da página, existe uma tabela que lista os grupos de assinantes. As informações da tabela são as seguintes:

• SUBSCRIBER-GROUP: o nome do grupo de subscritores. Clicando no nome, acede-se ao painel de controlo do grupo.
• SUBS-ACTIVE: conta o número de assinantes membros desse grupo que têm uma sessão ativa no servidor BQN. Clicando nesta opção, acede-se à página QoE do assinante filtrada por este grupo de assinantes, de modo a que as métricas de cada membro do grupo possam ser aí verificadas.
• FL-ACTIVE: número de fluxos activos que fazem parte do tráfego deste grupo.
• LIM-Mbps: limite do débito definido nessa direção, em Mbps (n/a se não for definido qualquer limite).
• RATE-POLICY: nome da política de débito que está a ser aplicada a este grupo (n/a se não houver política definida). A definição da política é a que estabelece o limite indicado em LIM-Mbps.
• FL-CREATED: fluxos criados até à data pertencentes a este grupo de assinantes.
• MBYTES: volume total de tráfego deste grupo de assinantes até à data, em megabytes.
• CURR-Mbps: velocidade actual em Mbps. 
• MEAN-Mbps: velocidade média móvel em Mbps (calculada a cada 10 minutos).
• RTT-ms: média móvel da latência em milissegundos. Se for selecionada a direção de ligação descendente, a latência apresentada é do lado do acesso (em direção aos assinantes). Se for selecionada a direção de ligação ascendente, é mostrada a latência do lado da Internet.
• RTX: a média móvel da percentagem de retransmissões TCP (diretamente relacionada com as perdas de pacotes). Se for selecionada a direção downlink, a retransmissão apresentada é do lado do acesso (para os assinantes). Se for selecionada a direção de ligação ascendente, é mostrada a retransmissão do lado da Internet.
• VELOCIDADE MÁXIMA: média móvel da percentagem de tráfego com uma velocidade próxima da velocidade máxima.
• CONGESTIONAMENTO: média móvel da percentagem de tráfego congestionado.
• LIFETIME: duração até à data deste grupo de subscritores.

Uma coluna PLOT na tabela indica os grupos incluídos no gráfico e no mapa de calor. Podem ser mostrados até 50 grupos de subscritores ao mesmo tempo, selecionando a respectiva caixa de seleção de plotagem. O gráfico será atualizado automaticamente após alguns segundos. Se anular a seleção da caixa de verificação, esse grupo será removido do gráfico e do mapa de calor.

É possível utilizar um filtro, para selecionar apenas os grupos que têm como membro um endereço IP ou um ID de assinante:

Se tivermos acedido à página de métricas de QoE do grupo a partir de um painel de controlo do assinante (clicando em Ver grupos de assinantes no painel de controlo do assinante), as métricas do assinante serão apresentadas juntamente com as métricas dos grupos de que é membro:

‍

Painel de controlo do grupo de assinantes

‍

Se clicar no nome de um grupo de assinantes na página QoE do grupo de assinantes, será apresentado um painel de controlo do grupo de assinantes, com as métricas em gráficos separados:

O dashboad mostra a evolução temporal ao longo do período selecionado das seguintes métricas do grupo de assinantes:

• Velocidades médias de ligação descendente e ascendente.
• Movimentos criados e movimentos activos.
• Latências de acesso e de Internet.
• Acesso e retransmissões de pacotes da Internet.
• Percentagem de tráfego congestionado.
• Percentagem de tráfego a uma velocidade próxima da máxima.

Contém também gráficos de dispersão com a relação entre a velocidade média e as medições de latência, retransmissão e congestionamento. Uma linha vermelha mostra a possível correlação entre os dois. Estes gráficos ajudam a identificar as velocidades em que outras métricas de QdE se podem deteriorar (e talvez atenuá-las, limitando a velocidade global desse grupo).

Se colocar o rato em cima de um ponto do gráfico, uma dica de ferramenta apresentará o seu valor exato. As dicas de ferramentas nos outros gráficos no mesmo ponto no tempo mostrarão os outros valores métricos.

O painel de controlo também contém um gráfico com a evolução temporal dos serviços DPI do grupo.

‍

Para ver as métricas detalhadas de cada membro do grupo, clique em See main subscriber in group (Ver assinante principal no grupo ) para aceder à página Subscriber QoE metrics (Métricas de QoE do assinante) filtrada por este grupo de assinantes.

Para ver a definição do grupo de assinantes e/ou efetuar alterações, clique em Editar grupo de assinantes.

‍

Exportação de registos DPI

‍

O produto Bequant BQN gera informação DPI para o tráfego que o atravessa, permitindo identificar a composição desse tráfego em termos de serviços e aplicações. As informações podem ser visualizadas na interface gráfica do produto BQN. Para facilitar a exportação dessas informações para processamento por sistemas de relatórios externos, este documento descreve o comando shell do BQN que permite isso. O comando aqui descrito está disponível a partir da versão R4.21.3.

Sintaxe do comando

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

‍

Exemplo:

Registos da DPI de¹⁴ de abril de 2024:

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

Formato de saída

O comando devolve uma linha por registo, com os campos de cada registo separados pelo carácter escolhido. Por exemplo:

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”
. . . 

A primeira linha é o cabeçalho. Os campos são os seguintes:

Quando ; ou , são utilizados como separadores, os campos SUBSCRIBER-ID, DOMAIN e DPI são colocados entre aspas duplas. As aspas duplas dentro de qualquer um desses campos são escapadas com aspas duplas (" é ""), seguindo a recomendação do RFC4180.

Invocação

O comando é invocado a partir da shell BQN (não a partir da shell Linux do servidor BQN). É suficiente um utilizador com perfil de operador. Por exemplo:

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

O comando pode ser invocado remotamente utilizando o ssh:

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

E também redirecionar a saída para um ficheiro local:

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

Recomenda-se que a consulta seja efectuada uma vez por dia, em alturas de pouco tráfego:

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

‍

Importação

Os ficheiros gerados pela saída do comando descrito são diretamente importáveis por ferramentas que aceitam a norma CSV (por exemplo, MSExcel).

Todos os registos estão marcados com a sua data e hora de geração e aderem ao período solicitado, mas não é garantido que sejam devolvidos por ordem de data (a razão é que a informação é obtida de várias fontes, o que pode alterar a ordem). Por conseguinte, se pretender efetuar uma análise temporal dentro do período solicitado, os registos devem ser ordenados por data depois de importados para a ferramenta de elaboração de relatórios.

‍