Changelog

Para ficar por dentro e acompanhar as alterações, participe do nosso grupo no Telegram https://t.me/rrflowapi.


📦 Versão 1.5

26/11/2024 - v1.5.6

  • ✨ Mais otimização nas descobertas de nomes de ASN!

24/11/2024 - v1.5.4

  • ✨ As descobertas de ASN agora serão realizadas por meio de consultas RDAP, devido a problemas identificados no serviço WHOIS. No entanto, o WHOIS será utilizado como fallback caso o RDAP falhe.
  • 🐞 Caso esteja demorando muito no carregamento dos nomes de ASN, recomendo que faça:
cd /opt/rr-flow-api/geo/
rm /opt/rr-flow-api/geo/asn-cache-names.json
wget https://rrflow.com.br/downloads/arquivos/asn-cache-names.json
  • 📊 Dashboards:
    • ♻️ Análise - Filtro (Manual) CGNAT
      • Adicionado colunas dst nat / src nat
  • 📔 Documentação atualizada: Interpretando Filtros Manuais
    • Filtros de NAT mudaram na versão 1.7.5 do NFDUMP. (xip xport xnet)

18/11/2024 - v1.5.3

  • ⚠️ Atualização de Autenticação: Migração para novos servidores com o objetivo de garantir maior redundância e manter a API sempre online. Versões vais antigas deixarão

15/11/2024 - v1.5.2

  • ✨ Otimização do Serviço WHOIS: Redução do tempo de busca por novos nomes de ASN, proporcionando respostas mais ágeis, e consulta em cache.

13/11/2024 - v1.5.1

  • 🐞 Correção de Bug no Bot do Telegram: Resolução de erro que impedia o carregamento do bot em casos de chave de token inválida ou não configurada.

11/11/2024 - v1.5.0

Nesta versão o tive bastante trabalho, para ajustar muita coisa para trabalhar com a nova versão do nfdump nfdump 1.7.5

  • 🎉 Motor da API atualizado para nfdump 1.7.5
    • 🗜 Adição de zstd como opção de compressão.
  • 🐞 Filtros processados em data_traffic_analysis.json que não retornarem dados agora são gravados com zero, não quebrando com os gráficos.

  • 🗑 Limpeza de cache melhorada.

  • ☠️ Adeus integração com feodotracker (Botnes) Instabilidade e falta de suporte IPv6 estavam fazendo a aplicação travar.

  • 📊 Dashboards:

    • ♻️ Atualizadas
      • Largura de banda - Interfaces (Múltiplas + Top ASNs)
        • Correção de Entramdo(src)/Saindo(sdt)
      • Análise - Filtro (Manual)
        • Adicionado coluna TTL em conexões
        • TOP 10 Entrada (SRC) e Saída (DST)
      • Análise - Filtro (Manual) CGNAT
        • Adicionado coluna TTL em conexões
      • Análise - Filtro (Meus Prefixos)
        • Opções de filtros apriorados
        • Adicionado coluna TTL em conexões
      • Análise - Serviços (Interfaces)
        • Opções de filtros apriorados
        • Adicionado coluna TTL em conexões
    • ✨ Renomadas
      • Análise - Serviços (Interfaces)
        • Análise - Filtro (Serviços)
      • Análise Geral - ASN + Prefixos (Favoritos) Meu Cliente
        • Análise Geral - Prefixos e ASN Favoritos (Cliente AS)
      • Análise Geral - ASN + Prefixos (Favoritos)
        • Análise Geral - Prefixos e ASN Favoritos
      • Análise Geral - Top ASN & IPs (Interfaces)
        • *Análise Geral - Top ASN & Endereços IPs *
    • ❌ Removeidas
      • Análise - Botnet (IP)
      • Análise - Filtro (Interfaces)
        • Faz o mesmo em Análise - Filtro (Manual)
      • Análise - Filtro (IP)
        • Faz o mesmo em Análise - Filtro (Manual) basta utilizar no filro “ip + IP”
      • Análise Geral - Top IPs por ASN (Interfaces)
        • Faz o mesmo em Análise - Filtro (Manual) basta utilizar a forma de agregar.
  • Obrigatório nesta atualização marcar para atualizar os pacotes do Nfdump:

curl -sS https://rrflow.com.br/downloads/rr-flow-api-install.sh | bash

[*] RR Flow API (v1.5.0)
[ ] Grafana + Plugins (v11.3.0)
[*] Pacotes do Nfdump (v1.7.5)
  • ⚠️ É preciso reimportar novamente as Dashboards, e definir da Dash Home para seu Profile

  • ⚠️ Defina para seu usuário, em Profile, a Home Dashboard com General/Home.


📦 Versão 1.4

01/11/2024 - v1.4.3

  • 🔒 Ocultado os valores de password_admin_panel e community no Endpoint: /conf
  • 💾 Novo Endpoint: /disktest Exibe saida JSON de teste de leitura e escrita em disco.
  • 🤖 Novo comando no bot do telegram: /testedisco, responde com teste de leitura e escrita em disco.
  • 🆕 Suporte Grafana 11.3.0

24/10/2024 - v1.4.2

Nesta versão o foco foi criar funcionalidades para o bot do telegram


17/10/2024 - v1.4.1

A nova versão teve quase 2 mil linhas adicionadas, então segura aí que a lista é grande!

  • 📄 Adicionado arquivo notify.json para envio de alertas.
    • Configurações padrões para envio de e-mail e Telegram.
  • 📄 Adicionado arquivo data_traffic_analysis.json com suporte à configuração de monitoramento de tráfego e alertas customizados.
    • 📣 Suporte para alertas com diferentes canais de notificação: e-mail, Telegram e execução de scripts.
    • 💬 Envio de alertas para o Telegram.
      • Suporte ao envio para múltiplos usuários e grupos.
      • Suporte ao envio em tópicos dentro de grupos (formato chat_id,topic_id).
      • Suporte a gráficos personalizados.
    • ✉️ Envio de alertas por E-mail.
      • Suporte ao envio para múltiplos e-mails.
      • Suporte a gráficos personalizados.
    • 🖥️ Suporte para execução de scripts.
      • Suporte ao envio de variáveis personalizadas no comando (ex.: $status, $bps, $bpp, etc.).
  • ⚠️ Agora no painel de Administração no Grafana, ao clicar em Remover e Reinstalar Todas, serão removidas apenas as Dashboards com as seguintes TAGs:

    • ☠️ RR-FLOW-M
    • ☠️ RR-FLOW
    • ☠️ RR-INFO
    • ☠️ RR-FLOW-HOME
    • ☠️ RR FLOW
  • Dashboards:

    • Largura de banda - Análise de tráfego (BD)
      • Dados coletados em data_traffic_analysis.json.
    • Home
      • Remova manualmente essa Dash, pois está sem TAG.
  • 📔 Documentação atualizada
  • 📔 Novo Menu:
  • 📊 suporte para Grafana 11.2.x, disponível para atualização.
  • 🐞 Bug ao enivar mensagem no telegram devido algumas tags especiais
    • Aceita:
      • <b>Negrito</b>
      • <i>Itálico</i>
      • <pre>Código</pre>
    • Converte > < &

ℹ️ NOTA IMPORTANTE ℹ️

  • ⚠️ Com a implementação da remoção de dashboards contendo apenas as TAGs mencionadas, é necessário remover as dashboards Home manualmente, e ser feita sua instalação.

  • ⚠️ Defina para seu usuário, em Profile, a Home Dashboard com General/Home.

  • ⚠️ A partir da versão 1.4.0, o intervalo de coleta padrão foi ajustado para 1 minuto, definido pela chave collection_interval. No entanto, para quem já utilizava o intervalo de 5 minutos, essa configuração não será alterada automaticamente — o valor atual continuará o mesmo, garantindo que a mudança não afete as configurações existentes.


📦 Versão 1.3

19/09/2024 - v1.3.0

  • 🚀 Varias melhorias no motor da API. (E sim foram muitas!)
  • ✨ Nova documentação relacionado a utilização da API de forma “crua”.
  • ✨ Possibilidade de definir o o tempo de do intervalo de coleta. collection_interval, que tem por padão o valor 5 minutos.
  • ⚙️ Ao chamar a API via URL, quando não informado timestart e timestop, automaticamente é buscado pelos ultimo(s) minutos respeitando o valor de collection_interval.
  • ⚙️ Ao iniciar API remover quaisquer diretórios que não estejam listados em source_path. Evitando que fique lixo no disco, cuidado ao renomear um source.
  • ♻️ Dashboards:
    • ❌ Análise - Botnet (ASN)
    • ✨ Largura de banda - Interfaces (Múltiplas + Top ASNs) Manual
    • ♻️ Análise - Filtro (Manual)
    • ♻️ Largura de banda - Interfaces (Múltiplas)
    • ♻️ Largura de banda - Interfaces (Múltiplas + Filtro Manual)
    • ♻️ Largura de banda - Interfaces (Múltiplas + Filtros personalizados)
    • ♻️ Largura de banda - Interfaces (Múltiplas + Meus prefixos)
    • ♻️ Largura de banda - Interfaces (Múltiplas + Prefixos e ASN Favoritos)
    • ♻️ Largura de banda - Interfaces (Múltiplas + Prefixos Internos)
    • ♻️ Largura de banda - Interfaces (Múltiplas + Serviços)
    • ♻️ Largura de banda - Interfaces (Múltiplas + Top ASNs)
    • ♻️ Largura de banda - Interfaces (Múltiplas + Top ASNs) Manual
    • ♻️ Largura de banda - Interfaces (Múltiplas + Top ASNs) Meu Cliente
    • ♻️ Largura de banda - Interfaces (Múltiplas + Top ASNs) Serviços
    • ♻️ Home

⚠️ ATENÇÃO: ⚠️
Salve suas dashboards personalizadas pois ao reimportar as mesmas serão excluidas!!!
❗️É preciso reimportar novamente as Dashboards, e definir da Dash Home para seu Profile


📦 Versão 1.2

29/06/2024 - v1.2.1

  • ⚙️ Aviso na dashboard Registro e Licença se tem uma versão mais recente.
  • ❌ Dashboards que foram removidas/substituídas/Adicionadas:
    • ❌Largura de banda - ASN + Prefixos Favoritos 👉 Faz o mesmo em: Interfaces (Agregadas + Prefixos e ASN Favoritos)
    • ♻️ Volta da Dashboard: Largura de banda - Filtro (Manual)
  • ⚙️ Corrigido agrupamento por SRC AS / DST AS onde mostrava ASN 0 + Private.
  • ⚙️ Adicionados os campos de saídas JSON para análise::
    • bpp: Bytes por pacote
  • ♻️ Com o novo valor de bpp (bytes por pacote), várias dashboards foram atualizadas:
    • 🔄 Análise - Botnet (ASN)
    • 🔄 Análise - Botnet (IP)
    • 🔄 Análise - Filtro (Interfaces)
    • 🔄 Análise - Filtro (IP)
    • 🔄 Análise - Filtro (Manual)
    • 🔄 Análise - Filtro (Manual) CGNAT
    • 🔄 Análise - Filtro (Meus Prefixos)
    • 🔄 Análise - Filtro (Personalizado)
    • 🔄 Análise - Filtro (Prefixos Internos)
    • 🔄 Análise - Serviços (Interfaces)
  • 🔄 Algumas outras dashboards tiveram alguns ajustes “finos”.
  • ⚙️ Adicionado novos recurso de geolocalização ao motor da API para futuras versões.

⚠️ ATENÇÃO: ⚠️
Salve suas dashboards personalizadas pois ao reimportar as mesmas serão excluidas!!!
❗️É preciso reimportar novamente as Dashboards, e definir da Dash Home para seu Profile


12/04/2024 - v1.2.0

  • ✨ Novidade no painel de administração
    • Novo botão para visualizar os logs.
    • Status da API na tela de login e principal.
    • Link para documentação.
  • 🙌 Suporte IPv6 em source_path » snmp » ip
  • ⚙️ Adicionados os campos de saídas JSON para análise::

    • mac_src_in: Endereço MAC de Origem (Entrada)
    • mac_src_out: Endereço MAC de Origem (Saída)
    • mac_dst_in: Endereço MAC de Destino (Entrada)
    • mac_dst_out: Endereço MAC de Destino (Saída)
    • label: Identificar ou categorizar o fluxo de dados com uma etiqueta específica.
    • tos: Tipo de Serviço (ToS) - Prioridade e o tipo de serviço solicitado para o pacote.
    • flags: Indicadores ou estados do pacote, como SYN, ACK, FIN em conexões TCP.
  • 🔄 Dashs de Análise contam com novas colunas dos valores acima.

  • ❌ Dashboards a serem removidas:
    • ❌ Análise - Filtro (Manual) BGP Rotas
      • 👉 Faz o mesmo em: Análise - Filtro (Manual)

❗️É preciso reimportar novamente as Dashboards, e definir da Dash Home para seu Profile


📦 Versão 1.1

03/04/2024 - v1.1.6

  • 🔨 Ajustes para que os filtros entendam rodas “default”.
    • ::/0 para 2000::/3
    • net 0.0.0.0/0 para net 0.0.0.0/1 OR net 128.0.0.0/1
  • 🐞 Corrijido CDN77 para não aparecer em CDNs
  • ♻️ Atualizações Grafana / Plugins
  • ♻️ Com a atualização do plugin volkovlabs-echarts-panel 6.0.0 varias dashbords foram atualizadas para melhor funcionamento.
    • 🔄 Hardware
    • 🔄 Registro e Licença
    • 🔄 Hardware e Licença
    • 🔄 Análise - Filtro (IP)
    • 🔄 Análise - Filtro (Manual)
    • 🔄 Análise - Interfaces + Serviços
    • 🔄 Análise Geral - ASN + Prefixos (Favoritos)
    • 🔄 Análise Geral - ASN + Prefixos (Favoritos) Meu Cliente
    • 🔄 Análise Geral - Top ASN & IPs (Interfaces)
    • 🔄 Largura de banda - ASN + Prefixos Favoritos
    • 🔄 Largura de banda - BGP Peer
    • 🔄 Largura de banda - Filtro (Personalizados)
    • 🔄 Largura de banda - Filtro (Prefixos Internos)
    • 🔄 Largura de banda - Interfaces (Agregadas + Manual)
    • 🔄 Largura de banda - Interfaces (Agregadas + Prefixos e ASN Fav) Meu Cliente
    • 🔄 Largura de banda - Interfaces (Agregadas + Prefixos e ASN Favoritos)
    • 🔄 Largura de banda - Interfaces (Agregadas Top ASNs)
    • 🔄 Largura de banda - Interfaces (Agregadas)
    • 🔄 Largura de banda - Interfaces (Múltiplas + Filtro Manual)
    • 🔄 Largura de banda - Interfaces (Múltiplas + Filtros personalizados)
    • 🔄 Largura de banda - Interfaces (Múltiplas + Meu prefixos)
    • 🔄 Largura de banda - Interfaces (Múltiplas + Prefixos e ASN Favoritos)
    • 🔄 Largura de banda - Interfaces (Múltiplas + Top ASNs)
    • 🔄 Largura de banda - Interfaces (Múltiplas + Top ASNs) Meu Cliente
    • 🔄 Largura de banda - Interfaces (Múltiplas)
    • 🔄 Largura de banda - Meus Prefixos
  • ❌ Dashboards a serem removidas:
    • ❌ Análise - Serviços
      • 👉 substituída: Análise - Serviços (Interfaces)
    • ❌ Análise - Interfaces + Serviços
      • 👉 substituída: Análise - Serviços (Interfaces)
    • ❌ Análise Geral - Top ASN & IPs
      • 👉 substituída: Análise Geral - Top ASN & IPs (Interfaces)
    • ❌ Largura de banda - Filtro (Manual)
      • 👉 substituída: Largura de banda - Interfaces (Múltiplas + Filtro Manual)

❗️É preciso reimportar novamente as Dashboards, e definir da Dash Home para seu Profile

❗️Recomendo atualizar o grafana (v10.4.x)

❗️Recomendo atualizar o nfdump (v1.7.4)


11/03/2024 - v1.1.5

  • 🔩 Novo Scrip: Descobrindo CDNs de um prefixo
  • ⚙️ Nova função /trafsubnet para retornar todos/intervalo dos prefixos /8 (IPv4)
  • ⚙️ Nova função /trafnet8 para retornar dados de prefixos (IPv4/IPv6)
  • ✨ Nova Dashboard: Análise - Segmentando em Sub-redes 8 (IPv4)
  • ✨ Nova Dashboard: Análise - Segmentando em Sub-redes (IPv4 Manual)
  • ✨ Nova Dashboard: Análise - Segmentando em Sub-redes (IPv6 Manual)

❗️Recomendo atualizar o grafana (v10.3.x)

❗️Recomendo atualizar o nfdump (v1.7.4)

❗️Não é preciso reimportar todas as Dashboards, apenas instale as “Análise - Segmentando em Sub-redes *”


25/01/2024 - v1.1.4

  • ⚙️ Script de instalação/atualização transparente. (Retorna todas as saídas)
  • ⚙️ Melhorias nos comandos nfdump executados pelo motor da API.
  • Nova Dashboard: Largura de banda - Interfaces (Múltiplas + Top ASNs) Meu Cliente
  • Nova Dashboard: Análise Geral - ASN + Prefixos (Favoritos) Meu Cliente
  • Nova Dashboard: Informações ASN

❗️Recomendo atualizar o grafana (v10.3.1)

❗️É preciso reimportar novamente as Dashboards, e definir da Dash Home para seu Profile


10/10/2023 - v1.1.3

  • 🐞 Correção da dashboard Análise Geral - Top ASN & IPs quando retornava AS = 0.
  • 🐞 Traduz ::/0 para ::/1 Bug #474 - solução temporária.
  • 💾 Adicionado botão para backup no Painel Admin (Serviços).
  • ⚙️ Melhorias nos comandos nfdump executados pelo motor da API.
  • Nova Dashboard: Largura de banda - Interfaces (Múltiplas + Prefixos Internos)
  • ⚙️ Unidades de medida padronizadas em bits: [‘b’, ‘Kb’, ‘Mb’, ‘Gb’, ‘Tb’].

06/10/2023 - v1.1.2

  • 🐞 Correção dos Dados nas Dashboards Largura de banda - Interfaces (Múltiplas …

02/10/202 - v1.1.1

  • ⚙️ Suporte para obter os Peer do Juniper/Junos via SNMP - Contribuição @Maykbn

28/09/2023 - v1.1.0

  • Dash nova: Largura de banda - Interfaces (Múltiplas)
  • Dash nova: Largura de banda - Interfaces (Múltiplas + Filtro Manual)
  • Dash nova: Largura de banda - Interfaces (Múltiplas + Prefixos e ASN Favoritos)
  • Dash nova: Largura de banda - Interfaces (Múltiplas + Meu prefixos)
  • Dash nova: Largura de banda - Interfaces (Múltiplas + Filtros personalizados)
  • 🔄 Dash renomeada: Largura de banda - Interfaces (Top ASNs) para Largura de banda - Interfaces (Múltiplas + Top ASNs)
  • 🔄 Dash renomeada: Largura de banda - Interfaces para Largura de banda - Interfaces (Agregadas)
  • 🔄 Dash renomeada: Largura de banda - Interfaces (Top ASNs Individual) para Largura de banda - Interfaces (Agregadas Top ASNs)
  • 🔄 Dash renomeada: Largura de banda - Interfaces + (Filtro Manual) para Largura de banda - Interfaces (Agregadas + Manual)
  • 🔄 Dash renomeada: Largura de banda - Interfaces + (Prefixos e ASN Favoritos) para Largura de banda - Interfaces (Agregadas + Prefixos e ASN Favoritos)

❗️É preciso reimportar novamente as Dashboards, e definir da Dash Home para seu Profile


📦 Versão 1.0

25/09/2023 - v1.0.1

  • ⚙️ Remove o prefixo ::ffff: de um endereços IPv4 mapeados em IPv6, ao rodar API com suporte IPv4+v6 (“api_bind”: “::”)
  • ⚙️ Aprimoramento da eficiência na limpeza de disco e cache, eliminando o problema de uso de 100% da CPU durante o início da rotina de limpeza.
  • ⚙️ Adicionada a capacidade de remover diretórios vazios após a exclusão de arquivos.

❗️Não é preciso importar novamente as Dashboards


19/09/2023 - v1.0.0

  • ⚙️ Otimizações do core em relação a versão RC.
  • 🍻 Lançado RR Flow