Skip to content

Releases: NodeSniff/nodesniff-linux-agent

v1.1.99

Choose a tag to compare

@NodeSniff NodeSniff released this 21 Mar 15:35

🛰️ 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*)
  • Added new metric field net_iface to 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

Choose a tag to compare

@NodeSniff NodeSniff released this 23 Jan 15:02

🛰️ 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

Choose a tag to compare

@NodeSniff NodeSniff released this 13 Oct 20:25

🛰️ 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

Choose a tag to compare

@NodeSniff NodeSniff released this 08 Oct 16:08

🛰️ 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

Choose a tag to compare

@NodeSniff NodeSniff released this 30 Jun 15:05

🛰️ 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 .py scripts
  • Out-of-the-box support for:
    • CPU
    • Memory
    • Disk I/O
    • Load Average
    • Top processes (rtop_process.py)

📦 Contents

  • nsagent.py – the main agent
  • metrics/ – modular metric collectors
  • README.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! 🚀