Changelog

To stay up to date and follow the changes, join our Telegram group https://t.me/rrflowapi.

📦 Version 2.1

2025/07/04 - v2.1.1

Minor update based on a subscriber’s suggestion.

  • 🎉 New dashboard: Traffic - Downstream (Manual Filter)
  • Dashboard dedicated to viewing traffic from downstream interfaces (type=0)
  • It is possible to apply manual filters to refine the analysis of the data presented.

2025/07/01 - v2.1.0

Improved data processing, support for executing scripts and SSH commands by status, prevention and fine-tuning.

  • 🔧 Data Processing Improvements
    • The processing of the data_traffic_analysis.json file is now done directly by the improved internal function.
    • It does not allow saving 2 identical (description) names.
    • The processing loop now always searches for the file’s start time, and no longer the application’s start time.
  • 🚦 Execution of Scripts
    • Added support for the status of incident and resolved in the script block, allowing different actions for each situation.
    • The old format of the script block continues to work normally, ensuring backwards compatibility. - 🚦 Executing commands via SSH
    • It is now possible to configure commands to be executed via SSH directly on routers or servers, both in incident and resolved situations.
  • 🐞 Fixes
    • Adjustment in the Bogon ASN validation range: now it correctly considers 65552 to 131071. It no longer goes up to 157370, correcting the incorrect display of “RESERVED [IANA]”.
    • Error sending email alerts.

📦 Version 2.0 – Codename: Fátima

This release marks a significant evolution for the platform, with a complete overhaul of the administrative panel—now more modern, intuitive, and multilingual. Dashboard installation and configuration are fully automated, greatly enhancing the user experience. Grafana integration has also been improved and is now automatic, eliminating manual steps. Several new features and backend optimizations have been implemented.

2025/06/28 - v2.0.4

  • 🐞 Adjusted bandwidth calculation in the analysis chart to use the average of the samples instead of the total connection time, ensuring consistency with the updated time calculations and accurate values in both methods. (Fix applied for v2.0.3.)

2025/06/28 - v2.0.3

  • ✨ Analysis Dashboards.
    • The packet (packets) chart is now displayed as packets per second (pps)
    • Included in the connections report:
      • Average bandwidth (bps_avg)
      • Packets (packets)
      • Packets per second (pps)

2025/06/27 - v2.0.2

  • 🐞 Improved excessive memory usage in NetFlow processing with proxyflow on VMware, due to a VMware-specific bug in kernel pipe handling.

2025/06/26 - v2.0.1

  • 🐞 Translation correction.
  • ✨ Added the Average Band column to the Analysis Dashboards.

2025/06/20 - v2.0.0

  • 🎉 New Administration Panel
    • Fully redesigned interface, now with support for multiple languages.
    • Enhanced home screen with a detailed hardware summary.
    • Fully automated dashboard installation and configuration, including setting the initial “home” dashboard.
    • SNMP data collection per host, with the ability to test connectivity directly from the panel.
    • CDN discovery is now available via the web interface, eliminating the need for manual scripts.
    • Various other visual and functional improvements.
  • ✨ Reworked Dashboards
    • All dashboard names have been revised, making their purpose and connection to JSON configuration files much clearer.
  • ✨ Backend Improvements
    • Multiple optimizations and fixes implemented for greater stability and performance.
  • ✨ Automated Grafana Integration
    • No more manual RR Flow integration with Grafana: the API JSON datasource and Service Token are now created automatically during installation.
    • Grafana language now automatically follows the configuration set in RR Flow API.
    • The “home” dashboard will always be set as the initial page. If it does not exist, it will be installed automatically.
  • ☠️ Changes to External Grafana Integration
    • Automatic integration with external Grafana instances is no longer available in the installer.
    • For external environments, configuration must be done manually after installation.
    • This decision was made due to the inability to provide support for non-standard Grafana environments. The Grafana provided by RR Flow will now be installed by default to simplify support and troubleshooting.
  • 📖 Updated Documentation
    • Documentation has been reviewed and expanded to reflect the new features and changes in this release.
  • 🌐 Updated Databases
    • Geolocation (MaxMind): Updated on 2025-06-21.
    • ASN: Updated on 2025-06-23 (117,961 ASNs).

  • 📍 Supported Languages

    Code Admin Panel Language Dashboard Language Grafana Language
    id-ID Bahasa Indonesia English (United States) Bahasa Indonesia
    cs-CZ Czech English (United States) Czech
    de-DE German English (United States) German
    en-AU English (Australia) English (United States) English (United States)
    en-CA English (Canada) English (United States) English (United States)
    en-GB English (UK) English (United States) English (United States)
    en-US English (United States) English (United States) English (United States)
    es-AR Spanish (Argentina) Spanish (Spain) Spanish (Spain)
    es-CL Spanish (Chile) Spanish (Spain) Spanish (Spain)
    es-CO Spanish (Colombia) Spanish (Spain) Spanish (Spain)
    es-ES Spanish (Spain) Spanish (Spain) Spanish (Spain)
    es-MX Spanish (Mexico) Spanish (Spain) Spanish (Spain)
    es-PE Spanish (Peru) Spanish (Spain) Spanish (Spain)
    es-US Spanish (US) Spanish (Spain) Spanish (Spain)
    es-VE Spanish (Venezuela) Spanish (Spain) Spanish (Spain)
    fr-FR French English (United States) French
    it-IT Italian English (United States) Italian
    hu-HU Hungarian English (United States) Hungarian
    nl-NL Dutch English (United States) Dutch
    pl-PL Polish English (United States) Polish
    pt-BR Portuguese (Brazil) Portuguese (Brazil) Portuguese (Brazil)
    pt-PT Portuguese (Portugal) English (United States) Portuguese (Portugal)
    sv-SE Swedish English (United States) Swedish
    tr-TR Turkish English (United States) Turkish
    ru-RU Russian English (United States) Russian
    ko-KR Korean English (United States) Korean
    zh-CN Chinese (Simplified) English (United States) Chinese (Simplified)
    zh-TW Chinese (Traditional) English (United States) Chinese (Traditional)
    ja-JP Japanese English (United States) Japanese
    • ⚠️ Note: Not all dashboards are fully translated internally; only dashboard names have been prioritized, and English is used as the primary language for internal details.

  • A Special Note:

    • This version is named Fátima in honor of my mother, just as the 1.x series was named Alberi after my father. I am grateful to have both of them well and by my side. I would also like to thank everyone who has purchased a RR Flow license: your support directly helps me provide for the health and well-being of my parents. 🫶

📦 Version 1.9

In this version, I’m refining RR Flow: besides fixing details, I focused on internal optimizations, organizational improvements, and standardization of essential fields for greater robustness and system reliability.

Nfdump v.1.7.6 required

2025/06/06 - v1.9.2

  • 🐞 Fix: The def_addr field now correctly displays the main IP (src or dst), making analysis easier in aggregations by IP.

If you are already on version 1.9.1, perform the minimal update.

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

2025/06/05 - v1.9.1

  • 🎉 Two new dashboards to inspire you to create your own:
    • Traffic Analysis by Protocol
    • Traffic Analysis by Data Volume
  • 🐞 Now the following aggregations work correctly in analysis dashboards:
    • srcas, dstas, insrcmac, outdstmac, indstmac, outsrcmac
  • ✨ New! Support for aggregation by src net and dst net:
    • The /trafstat endpoint now includes:
      • src_net
      • dst_net
    • When aggregating by src net or dst net, the values are also replicated to:
      • src_ip
      • dst_ip
    • The Aggregation selection field in the dashboards now has new options:
      • Source prefix
      • Destination prefix
      • Source/Destination prefix
    • Updated dashboards:
      • Analysis - Manual Filter
      • Analysis - My Prefixes Filter
      • Analysis - Custom Filter
      • Analysis - Internal Prefixes Filter
      • Analysis - Services Filter
      • Analysis - Manual Filter (CGNAT)
  • ⚠️ Reimport the dashboards, or if you prefer, just the updated ones to ensure you have all the new features.
  • ✨ Grafana v12.0.1

2025/05/05 - v1.9.0

  • ✨ Refactoring and Optimization: Deep structural improvements have been made, optimizing performance, module organization, and the efficiency of internal processes.
  • ✨ Normalized fields in the config.json and notify.json files, converting unexpected arrays (grafana, snmp, proxyflow, email, telegram) into single objects.
  • ✨ API Endpoint
    • All endpoints returning JSON data that feed the system were organized under /api/
    • Documentation updated.
  • ✨ Grafana Dark Theme has been restyled.
  • 🐞 (rr-flow-exporter) - Fixed the issue of incorrect dates with proxyflow.
  • 🌐 Update of geolocation databases (MaxMind).
  • 🌐 Update of ASN database.
  • ⚠️ All dashboards had their endpoints updated, so you must reimport all of them and set the Home as the initial dashboard.

📦 Version 1.8

✨ New ASN data support via Proxy Flow

This version fixes the absence of ASN information in exports from routers like MikroTik, Accel-PPP, FortiGate, Linux, among others.
A proxy mechanism was implemented, which listens to flows sent by the router, analyzes the source and destination IPs, and enriches the data with ASN before sending them to the collector.
Although it requires a little more CPU, the impact is controlled and acceptable even in high-traffic scenarios.
The great benefit is allowing filters and groupings by AS, significantly optimizing analysis in RR Flow.

👉 To activate, see the Proxy Flow documentation.

Nfdump v.1.7.6 required

2025/05/12 - v1.8.4

  • 🐞 Fixed the output of first and last values from the /trafstat endpoint, which were displaying incorrect values.

<!– Se você já está na versão 1.8.x, execute a atualização mínima.

curl -sS https://rrflow.com.br/downloads/rr-flow-api-install-mini.sh | bash
``` -->
### 2025/05/12 - v1.8.3

- 🧹 New support for the **maximum_days** variable per flow: defines the maximum number of days data should be kept on disk, acting only if total usage is below the **maximum_disk_gb** limit.
- ⚖️ The retention policy by space (**maximum_disk_gb**) still has priority: if the GB limit is exceeded, more recent data may be removed regardless of the number of days.
- 🛠️ Internal adjustments in the periodic cleanup process to optimize disk usage without compromising the configured minimum retention.

### 2025/05/08 - v1.8.2
- 🐞 Fix: Inconsistent timestamp in data processing of **data_traffic_analysis.json**.
    - Some filters processed from the *data_traffic_analysis.json* file did not display graphs on the **"Bandwidth - Traffic Analysis (DB)"** dashboard. This occurred because the time was based on the data source (router/exporter), which could be unsynchronized with the server. The collection was adjusted to **always use the server's own timestamp**, ensuring temporal consistency in the data saved in the database and shown in the graphs.

### 2025/05/05 - v1.8.1
- 🎉 Grafana **v12.0.0**
- 🎉 Nfdump **v1.7.6**
- 🐞 Adjustments with TTL to support nfdump version 1.7.6.

### 2025/05/03 - v1.8.0
- 🎉 New flow collector and exporter with support for ASN data enrichment, even when the router does not export this information:
    - **rr-flow-collector**
    - **rr-flow-exporter**
- ♻️ Improvement! Now you will find an extra manual filter option on the dashboards below:
    - Analysis – Segmenting into Subnets (IPv4 Manual)
    - Analysis – Segmenting into Subnets (IPv6 Manual)
    - Analysis – Segmenting into Subnets /8 (IPv4)
- 🌐 Update of geolocation databases (MaxMind).
- 🌐 Update of ASN database.
- ⚠️ For versions prior to 1.7.4, it is necessary to:
    - [Reimport the dashboards](https://doc.rrflow.com.br/atualizar/#reimportando-as-dashboars). *If preferred, install only those that had changes.*
    - [Set the Home dashboard](https://doc.rrflow.com.br/atualizar/#reimportando-as-dashboars) for your user.

## 📦 Version 1.7
- ⚠️ It is necessary to reimport interfaces in the admin panel.
    - **Get SNMP data** » **Get Interface Data.**
    - Then adjust the **type** according to [documentation](https://doc.rrflow.com.br/arquivos/#interfacesjson).
- ⚠️ Minimum required NFDump version: v1.7.5

### 2025/04/23 - v1.7.4
- 🐞 Fixed **bps** variable in the **/trafstat** endpoint. It was calculating values based on the selection time, always delivering the average value selected in Grafana, whereas the correct approach is based on connection time.
- 🎉 New **bps_med** variable added to the **/trafstat** endpoint. This shows values based on the selection time.
- ♻️ As a result, the following dashboards were updated:
    - Analysis - Filter (Manual)
    - Analysis - Filter (My Prefixes)
    - Analysis - Filter (Custom)
    - Analysis - Filter (Internal Prefixes)
    - Analysis - Filter (Services)
    - General Analysis - Top ASN & IP Addresses

- ⚠️ [Reimport](https://doc.rrflow.com.br/atualizar/#reimportando-as-dashboars) the dashboards again.
    - If preferred, install only those that had changes.
- ⚠️ [Set the Home dashboard](https://doc.rrflow.com.br/atualizar/#reimportando-as-dashboars) for your user.

### 2025/04/14 - v1.7.3
- 🐞 Fixed **/trafstat** endpoint. Adjusted **bps** calculation to consider the correct time interval provided by Grafana.

### 2025/04/09 - v1.7.2
- 🐞 Fixed **/trafprefix** endpoint. Adjusted calculations for **in_bytes**, **bps**, and **bpp** to consider a fixed time interval based on the [**collection_interval**](https://doc.rrflow.com.br/arquivos/#collection_interval) variable, instead of the *duration* value exported by the router, which was inconsistent due to incorrect time.
- 🐞 Admin Panel » Grafana
    - Fixed behavior of the "**Remove and Reinstall All**" button, which was not shown if the integration URL (`grafana.url` in config.json) did not use the default `localhost:3000, 127.0.0.1:3000, or ::1:3000`.
    - Now, the button is displayed regardless of the configured port, as long as the host remains `localhost, 127.0.0.1 or ::1`.

### 2025/03/27 - v1.7.1
- 🎉 Grafana **v11.6.0**
- 🎉 New API Endpoints: [**/trafprefix**](https://doc.rrflow.com.br/dadosjson/#endpoint-trafprefix)
- 📊 Dashboards:
    - 🆕 New Dashboards using the `/trafprefix` endpoint:
        - 🎉 Bandwidth - Prefixes (Manual Filter)
        - 🎉 Bandwidth - My Prefixes
    - ♻️ Updated:
        - ♻️ Bandwidth - BGP Next Hop
        - ♻️ Bandwidth - Filter (Manual)
    - ❌ Removed *(replaced by optimized versions)*:
        - 🗑 Bandwidth - Interfaces (Aggregated + Prefixes and Fav ASN) My Client
        - 🗑 Bandwidth - Interfaces (Aggregated + Prefixes and Favorite ASN)
        - 🗑 Bandwidth - Interfaces (Aggregated Top ASNs)
        - 🗑 Bandwidth - Interfaces (Aggregated)
        - 🗑 Bandwidth - Interfaces (Aggregated + Manual)
        - 🗑 Bandwidth - Services
        - 🗑 Bandwidth - Filter (Custom)
        - 🗑 Bandwidth - Filter (Internal Prefixes)
        - 🗑 Bandwidth - My Prefixes

- ⚠️ [Reimport](https://doc.rrflow.com.br/atualizar/#reimportando-as-dashboars) dashboards again.
- ⚠️ [Set Home dashboard](https://doc.rrflow.com.br/atualizar/#reimportando-as-dashboars) for your user.
- 🤖 Technical Recommendation: Update your operating system (Debian) to ensure better performance and compatibility.
    - `apt update; apt upgrade -y; apt autoremove -y`

### 2025/03/21 - v1.7.0
- ✨ **Improvements regarding how interfaces are handled in the interfaces.json file**
    - Now, when fetching interface data, the `interfaces.json` will include an extra option: **"type": 0**.
    - It is necessary to adjust upstream interfaces to **"type": 1**.
    - Dashboards with interface selection will only show those marked as **"type": 1**.
    - This way you can see downstream interface names in connection reports.
    - [Read more in the documentation](https://doc.rrflow.com.br/arquivos/#interfacesjson)
- 🌐 Updated geolocation databases (Maxmind).
- 🌐 Updated ASN database.
- 🎉 Grafana v11.5.2
- ✨ Technical Recommendation: Update your operating system (Debian) to ensure better performance and compatibility.
    - `apt update`
    - `apt upgrade -y`
    - `apt autoremove -y`
    - `reboot`

---

## 📦 Version 1.6

Required **Nfdump v.1.7.5**

### 2025/02/14 - v1.6.2
- 🎉 Nokia Support.
    - [Updated Documentation](https://doc.rrflow.com.br/integracoes/#nokia)
- 🎉 Linux Support.
    - [Updated Documentation](https://doc.rrflow.com.br/integracoes/#linux)
- 🌐 Updated geolocation databases.

### 2025/01/03 - v1.6.1
- 🐞 Fix on **/traffile** Endpoint: Resolved an issue where bandwidth graphs processed by the endpoint showed inconsistent values, sometimes lower than expected. For Juniper devices, reported values were completely incorrect.

### 2024/12/23 - v1.6.0 🎅
- 🌐 Updated geolocation databases.
- 🐞 Improvements in data collection processed by data_traffic_analysis.json.
- 🐞 **/traffile** Endpoint: Adjusted handling of zeroed results in JSON output to ensure continuous time intervals in graphs.
- 🎉 API with new Endpoints:
    - ✨ /api/ping/<destination>
    - ✨ /api/trace/<destination>
- 📊 Dashboards:
    - 🎉 New:
        - 🌏 *Analysis - Filter Map (Manual)*
        - ⚙️ *Tools - Traceroute - Ping*
    - ♻️ Renamed:
        - ♻️ *Record and License* 👉 *RR Flow License*
        - ♻️ *ASN Information* 👉 *Tool - ASN Information*
        - ♻️ *Hardware* 👉 *Hardware Information*
    - 🗑 Removed:
        - 🗑 *Hardware and License*

- ⚠️ [Reimport](https://doc.rrflow.com.br/atualizar/#reimportando-as-dashboars) dashboards again.
- ⚠️ [Set Home dashboard](https://doc.rrflow.com.br/atualizar/#reimportando-as-dashboars) for your user.

---

## 📦 Versão 1.5

### 2024/26/11 - v1.5.6
- ✨ Mais otimização nas descobertas de nomes de ASN! 

### 2024/24/11 - 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:
```bash
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 Manual Filters
    • Filtros de NAT mudaram na versão 1.7.5 do NFDUMP. (xip xport xnet)

2024/18/11 - v1.5.3

  • ⚠️ Authentication Update: Migration to new servers to ensure greater redundancy and keep the API always online. Older versions will be discontinued.

2024/15/11 - v1.5.2

  • ✨ WHOIS Service Optimization: Reduced lookup time for new ASN names, providing faster responses and cached queries.

2024/13/11 - v1.5.1

  • 🐞 Telegram Bot Bug Fix: Resolved an error that prevented the bot from loading in cases of an invalid or missing token key.

2024/11/11 - v1.5.0

This version involved a lot of work to adjust many things to work with the new version of nfdump nfdump 1.7.5

  • 🎉 API engine updated to nfdump 1.7.5
    • 🗜 Added zstd as a compression option.

  • 🐞 Filters processed in data_traffic_analysis.json that return no data are now recorded as zero, preventing broken graphs.

  • 🗑 Improved cache cleaning.

  • ☠️ Removed integration with feodotracker (Botnets). Instability and lack of IPv6 support were causing application crashes.

  • 📊 Dashboards:

    • ♻️ Updated
      • Bandwidth - Interfaces (Multiple + Top ASNs)
        • Fixed Incoming (src)/Outgoing (dst) correction
      • Analysis - Filter (Manual)
        • Added TTL column in connections
        • TOP 10 Incoming (SRC) and Outgoing (DST)
      • Analysis - Filter (Manual) CGNAT
        • Added TTL column in connections
      • Analysis - Filter (My Prefixes)
        • Improved filter options
        • Added TTL column in connections
      • Analysis - Services (Interfaces)
        • Improved filter options
        • Added TTL column in connections
    • ✨ Renamed
      • Analysis - Services (Interfaces)
        • Analysis - Filter (Services)
      • General Analysis - ASN + Prefixes (Favorites) My Client
        • General Analysis - Favorite Prefixes and ASN (Client AS)
      • General Analysis - ASN + Prefixes (Favorites)
        • General Analysis - Favorite Prefixes and ASN
      • General Analysis - Top ASN & IPs (Interfaces)
        • General Analysis - Top ASN & IP Addresses
    • ❌ Removed
      • Analysis - Botnet (IP)
      • Analysis - Filter (Interfaces)
        • Same as in Analysis - Filter (Manual)
      • Analysis - Filter (IP)
        • Same as in Analysis - Filter (Manual) just use the filter “ip + IP”
      • General Analysis - Top IPs by ASN (Interfaces)
        • Same as in Analysis - Filter (Manual) just use the aggregation method.

  • Mandatory in this update: mark to update Nfdump packages:

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

[*] RR Flow API (v1.5.0)
[ ] Grafana + Plugins (v11.3.0)
[*] Nfdump Packages (v1.7.5)

  • ⚠️ It is necessary to reimport the Dashboards again, and set the Home Dashboard for your Profile.

  • ⚠️ Set for your user, in Profile, the Home Dashboard to General/Home.

📦 Versão 1.4

2024/01/11 - v1.4.3

  • 🔒 Hidden the values of password_admin_panel and community in the Endpoint: /conf
  • 💾 New Endpoint: /disktest Displays JSON output of disk read and write tests.
  • 🤖 New Telegram bot command: /testedisco, responds with disk read and write test results.
  • 🆕 Support for Grafana 11.3.0

2024/24/10 - v1.4.2

In this version, the focus was on creating features for the Telegram bot

2024/17/10 - v1.4.1

The new version added nearly 2,000 lines, so buckle up — the list is long!

  • 📄 Added file notify.json for alert sending.
    • Default configurations for sending email and Telegram notifications.
  • 📄 Added file data_traffic_analysis.json supporting traffic monitoring and custom alert configuration.
    • 📣 Support for alerts via different notification channels: email, Telegram, and script execution.
    • 💬 Alerts sent to Telegram.
      • Support for sending to multiple users and groups.
      • Support for sending within topics inside groups (format chat_id,topic_id).
      • Support for custom graphs.
    • ✉️ Email alert sending.
      • Support for multiple email recipients.
      • Support for custom graphs.
    • 🖥️ Support for script execution.
      • Support for sending custom variables in the command (e.g., $status, $bps, $bpp, etc.).

  • ⚠️ Now in the Admin Panel in Grafana, clicking Remove and Reinstall All will only remove dashboards with the following TAGs:

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

  • Dashboards:

    • ✨ Bandwidth - Traffic Analysis (BD)
      • Data collected in data_traffic_analysis.json.
    • ❌ Home
      • Remove this dashboard manually as it lacks a TAG.
  • 📔 Updated documentation
  • 📔 New Menu:
  • 📊 Support for Grafana 11.2.x, available for update.
  • 🐞 Bug fixing in Telegram message sending due to special tags:
    • Accepted tags:
      • <b>Bold</b>
      • <i>Italic</i>
      • <pre>Code</pre>
    • Converts special characters > < &

ℹ️ IMPORTANT NOTE ℹ️

  • ⚠️ With the implementation of removal of dashboards containing only the mentioned TAGs, you need to manually remove the Home dashboard and reinstall it.
  • ⚠️ Set for your user, under Profile, the Home Dashboard as General/Home.
  • ⚠️ From version 1.4.0, the default collection interval was changed to 1 minute, defined by the key collection_interval. However, if you were already using a 5-minute interval, this setting will not be changed automatically — your current value remains, ensuring existing configurations are not affected.

📦 Versão 1.3

2024/19/09 - v1.3.0- 🚀 Several improvements in the API engine. (And yes, there were many!)

  • ✨ New documentation related to raw API usage.
  • ✨ Ability to define the collection interval time. collection_interval, defaulting to 5 minutes.
  • ⚙️ When calling the API via URL, if timestart and timestop are not provided, the API automatically fetches the last minutes respecting the collection_interval value.
  • ⚙️ On API startup, any directories not listed in source_path are removed, preventing disk clutter. Be careful when renaming a source.
  • ♻️ Dashboards:
    • ❌ Analysis - Botnet (ASN)
    • ✨ Bandwidth - Interfaces (Multiple + Top ASNs) Manual
    • ♻️ Analysis - Filter (Manual)
    • ♻️ Bandwidth - Interfaces (Multiple)
    • ♻️ Bandwidth - Interfaces (Multiple + Manual Filter)
    • ♻️ Bandwidth - Interfaces (Multiple + Custom Filters)
    • ♻️ Bandwidth - Interfaces (Multiple + My Prefixes)
    • ♻️ Bandwidth - Interfaces (Multiple + Favorite Prefixes and ASN)
    • ♻️ Bandwidth - Interfaces (Multiple + Internal Prefixes)
    • ♻️ Bandwidth - Interfaces (Multiple + Services)
    • ♻️ Bandwidth - Interfaces (Multiple + Top ASNs)
    • ♻️ Bandwidth - Interfaces (Multiple + Top ASNs) Manual
    • ♻️ Bandwidth - Interfaces (Multiple + Top ASNs) My Client
    • ♻️ Bandwidth - Interfaces (Multiple + Top ASNs) Services
    • ♻️ Home

⚠️ ATTENTION: ⚠️
Save your customized dashboards because they will be deleted when reimporting!!!
❗️It is necessary to reimport the dashboards again, and set the Home dashboard for your Profile.

📦 Versão 1.2

2024/29/06 - v1.2.1

  • ⚙️ Warning on the Registration and License dashboard if a newer version is available.
  • ❌ Dashboards that were removed/replaced/added:
    • ❌Bandwidth - Favorite ASN + Prefixes 👉 Now done in: Interfaces (Aggregated + Favorite Prefixes and ASN)
    • ♻️ Return of the Dashboard: Bandwidth - Filter (Manual)
  • ⚙️ Fixed grouping by SRC AS / DST AS where ASN 0 + Private was shown.
  • ⚙️ Added JSON output fields for analysis:
    • bpp: Bytes per packet
  • ♻️ With the new bpp (bytes per packet) value, several dashboards were updated:
    • 🔄 Analysis - Botnet (ASN)
    • 🔄 Analysis - Botnet (IP)
    • 🔄 Analysis - Filter (Interfaces)
    • 🔄 Analysis - Filter (IP)
    • 🔄 Analysis - Filter (Manual)
    • 🔄 Analysis - Filter (Manual) CGNAT
    • 🔄 Analysis - Filter (My Prefixes)
    • 🔄 Analysis - Filter (Custom)
    • 🔄 Analysis - Filter (Internal Prefixes)
    • 🔄 Analysis - Services (Interfaces)
  • 🔄 Some other dashboards received minor tweaks.
  • ⚙️ Added new geolocation features to the API engine for future versions.

⚠️ ATTENTION: ⚠️
Save your custom dashboards because they will be deleted when reimporting!!!
❗️It is necessary to reimport the dashboards again, and set the Home dashboard for your Profile.

2024/12/04 - v1.2.0

  • ✨ New features in the admin panel
    • New button to view logs.
    • API status on login and main screen.
    • Link to documentation.
  • 🙌 IPv6 support in source_path » snmp » ip

  • ⚙️ Added JSON output fields for analysis:

    • mac_src_in: Source MAC Address (Ingress)
    • mac_src_out: Source MAC Address (Egress)
    • mac_dst_in: Destination MAC Address (Ingress)
    • mac_dst_out: Destination MAC Address (Egress)
    • label: Identify or categorize the data flow with a specific tag.
    • tos: Type of Service (ToS) - Priority and type of service requested for the packet.
    • flags: Indicators or states of the packet, such as SYN, ACK, FIN in TCP connections.

  • 🔄 Analysis dashboards include new columns for the above values.

  • ❌ Dashboards to be removed:
    • ❌ Analysis - Filter (Manual) BGP Routes
      • 👉 Now covered in: Analysis - Filter (Manual)

❗️It is necessary to reimport the dashboards again, and set the Home dashboard for your Profile.

📦 Versão 1.1

2024/03/04 - 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 License
    • 🔄 Hardware e License
    • 🔄 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)

2024/11/03 - 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 *”

2024/25/01 - 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

2023/10/10 - 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’].

2023/06/10 - v1.1.2

  • 🐞 Bug fix in the Bandwidth - Interfaces (Multiple … dashboards data.

2023/02/10 - v1.1.1

  • ⚙️ Support added for retrieving Juniper/Junos Peers via SNMP - Contribution by @Maykbn

2023/28/09 - v1.1.0

  • ✨ New Dash: Bandwidth - Interfaces (Multiple)
  • ✨ New Dash: Bandwidth - Interfaces (Multiple + Manual Filter)
  • ✨ New Dash: Bandwidth - Interfaces (Multiple + Favorite Prefixes and ASN)
  • ✨ New Dash: Bandwidth - Interfaces (Multiple + My Prefixes)
  • ✨ New Dash: Bandwidth - Interfaces (Multiple + Custom Filters)
  • 🔄 Renamed Dash: Bandwidth - Interfaces (Top ASNs) to Bandwidth - Interfaces (Multiple + Top ASNs)
  • 🔄 Renamed Dash: Bandwidth - Interfaces to Bandwidth - Interfaces (Aggregated)
  • 🔄 Renamed Dash: Bandwidth - Interfaces (Top ASNs Individual) to Bandwidth - Interfaces (Aggregated Top ASNs)
  • 🔄 Renamed Dash: Bandwidth - Interfaces + (Manual Filter) to Bandwidth - Interfaces (Aggregated + Manual)
  • 🔄 Renamed Dash: Bandwidth - Interfaces + (Favorite Prefixes and ASN) to Bandwidth - Interfaces (Aggregated + Favorite Prefixes and ASN)

❗️You need to reimport the Dashboards again and set the Home Dash for your Profile.

📦 Versão 1.0

2023/09/25 - v1.0.1

  • ⚙️ Removes the ::ffff: prefix from IPv4 addresses mapped in IPv6 when running the API with IPv4+v6 support (“api_bind”: “::”).
  • ⚙️ Improved efficiency in disk and cache cleanup, eliminating the issue of 100% CPU usage at the start of the cleanup routine.
  • ⚙️ Added the ability to remove empty directories after file deletion.

❗️No need to re-import the Dashboards.

2023/09/19 - v1.0.0

  • ⚙️ Core optimizations compared to the RC version.
  • 🍻 RR Flow released.