Releases: NodeSniff/nodesniff-linux-agent
Releases · NodeSniff/nodesniff-linux-agent
Release list
v1.1.99
🛰️ NodeSniff Linux Agent v1.1.99
Network accuracy update focused on reliable traffic measurement in environments with Docker, VPNs, and virtual interfaces.
✅ Improvements
- Introduced default route interface detection to identify the primary outbound network interface.
- Network traffic is now collected from the active interface instead of global system counters.
- Added smart fallback mechanism when default interface cannot be determined.
- Fallback aggregation now excludes non-relevant interfaces to avoid noisy data.
- Excluded virtual and auxiliary interfaces from traffic calculation:
- loopback (
lo) - Docker (
docker*,br-*) - virtual interfaces (
veth*) - tunnels (
tun*,tap*) - VPN/WireGuard (
wg*) - libvirt (
virbr*) - ZeroTier / Tailscale (
zt*,tailscale*)
- loopback (
- Added new metric field
net_ifaceto indicate which interface is used for traffic measurement. - Improved accuracy of network metrics across containerized and VPN-enabled systems.
- Preserved existing data collection and reporting logic — no behavioral changes.
⚙️ Version Info
- Agent version: 1.1.99
- Minimum dashboard version: unchanged (compatible with current releases)
- License: GPLv3 (non-commercial use)
v1.1.4
🛰️ NodeSniff Linux Agent v1.1.4
Maintenance & reliability update focused on logging, networking resilience, and modular extensibility.
✅ Improvements
- Introduced rotating log handler (max 256 KB per file, 3 backups) to prevent uncontrolled log growth.
- Added automatic cleanup of old logs older than LOG_RETENTION_DAYS (default: 7 days).
- Logs stored under /var/log/nodesniff/top_processes.log with consistent permissions.
- Improved public IP detection with multiple fallback providers to handle external service outages.
- Increased resilience of network lookups — agent no longer fails on single provider errors.
- Added informational log entry after each cache update for better traceability.
- Preserved existing data collection and reporting logic — no behavioral changes.
- Introduced modular metrics architecture — agent now supports pluggable metric modules.
- Added new disk.py metric module (beta) located under the metrics/ directory.
- Module documentation coming soon.
⚙️ Version Info
- Agent version: 1.1.4
- Minimum dashboard version: unchanged (compatible with current releases)
- License: GPLv3 (non-commercial use)
v1.1.3
🛰️ NodeSniff Linux Agent v1.1.3
Maintenance update improving file path handling and logging reliability.
✅ Improvements
- Updated default log path to /var/log/nodesniff/nsagent.log for better security and Linux compliance.
- Agent now automatically creates the /var/log/nodesniff directory if it does not exist.
- Fixed permission-related startup errors when running as unprivileged nodesniff user.
- Improved setup instructions and troubleshooting documentation.
- Compatible with NodeSniff Dashboard v1.2 and higher.
⚙️ Version Info
- Agent version: 1.1.3
- Minimum dashboard version: 1.2
- License: GPLv3 (non-commercial use)
Thank you for using NodeSniff! 🚀
v1.1.2
🛰️ NodeSniff Linux Agent v1.1.2
Maintenance update improving reliability, compatibility, and cleanup logic.
✅ Improvements
- Fixed duplicate or malformed CPU name strings (e.g. removed “None CPU @ …”).
- --clean flag now safely terminates any existing background agent instance before performing cleanup.
- Enhanced reliability of systemd service installation and removal.
- Improved error handling and logging consistency.
- Fully compatible with NodeSniff Dashboard v1.2, including alerting and scheduled email digests.
⚙️ Version Info
- Agent version: 1.1.2
- Minimum dashboard version: 1.2
- License: GPLv3 (non-commercial use)
Thank you for using NodeSniff! 🚀
v1.1.1
🛰️ NodeSniff Linux Agent v1.1.1
Initial public release of the lightweight NodeSniff monitoring agent for Linux systems.
✅ Features
- Fast and minimal resource usage
- Metrics collected via modular system (
metrics/directory) - Auto-discovery of system info (hostname, IP, OS, platform)
- Designed to run as a systemd service
- Secure token-based authentication (
/opt/nodesniff/nsagent.token) - Pluggable metrics: easy to add/remove
.pyscripts - Out-of-the-box support for:
- CPU
- Memory
- Disk I/O
- Load Average
- Top processes (
rtop_process.py)
📦 Contents
nsagent.py– the main agentmetrics/– modular metric collectorsREADME.md,LICENSE,requirements.txt
⚠️ Requirements
- Python 3.6+
- Packages:
psutil,requests,python-dotenv
🔒 Token Required
Before running the agent, make sure /opt/nodesniff/nsagent.token exists and contains a valid X-Company-Key.
Agent will refuse to start otherwise.
Thank you for using NodeSniff! 🚀