Changelog

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

📦 Versão 1.5

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

📔 Documentação atualizada
- 🤖 Bot 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:
- 🎨 Tabela de cores para personalizar seus gráficos
- 🔢 Converter Bytes para personalizar seus gráficos
📊 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