Changelog
Para ficar por dentro e acompanhar as alterações, participe do nosso grupo no Telegram https://t.me/rrflowapi.
📦 Versão 1.6
Obrigatório Nfdump v.1.7.5
03/01/2025 - v1.6.1
- 🐞 Correção no Endpoint /traffile: Resolvido um problema onde os gráficos de largura de banda processados pelo endpoint apresentavam valores inconsistentes, sendo inferiores ao esperado em algumas situações. No caso de dispositivos Juniper, os valores reportados estavam completamente incorretos.
23/12/2024 - v1.6.0 🎅
- 🌐 Atualização das bases de dados de geolocalização.
- 🐞 Melhorias na coleta de dados processados por data_traffic_analysis.json
- 🐞 Endpoint /traffile: Ajustado o tratamento de resultados zerados na saída JSON para garantir intervalos de tempo contínuos nos gráficos.
- 🎉 API com novos Endpoints:
- ✨ /api/ping/
- ✨ /api/trace/
- ✨ /api/ping/
-
📊 Dashboards:
- 🎉 Novas:
- 🌏 Análise - Mapa Filtro (Manual)
- ⚙️ Ferramentas - Traceroute - Ping
- ♻️ Renomeadas:
- ♻️ Registro e Licença 👉 Licença RR Flow
- ♻️ Informações ASN 👉 Ferramenta - Informações ASN
- ♻️ Hardware 👉 Informação do Hardware
- 🗑 Removidas:
- 🗑 Hardware e Licença
- 🎉 Novas:
-
⚠️ Reimporte novamente as Dashboards.
- ⚠️ Defina a dash Home para seu usuário.
📦 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
- ♻️ Análise - Filtro (Manual) CGNAT
- 📔 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
- Largura de banda - Interfaces (Múltiplas + Top ASNs)
- ✨ 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 *
- Análise - Serviços (Interfaces)
- ❌ 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.
- ♻️ Atualizadas
-
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
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.).
- Suporte ao envio de variáveis personalizadas no comando (ex.:
-
⚠️ 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
.
- Dados coletados em
- ❌ Home
- Remova manualmente essa Dash, pois está sem TAG.
- ✨ Largura de banda - Análise de tráfego (BD)
- 📔 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
>
<
&
- Aceita:
ℹ️ 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)
- ❌ Análise - Filtro (Manual) BGP Rotas
❗️É 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)
- ❌ Análise - Serviços
❗️É 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