TWSNMP NEO

Next-generation container-native network manager

View on GitHub

日本語マニュアルはこちら (Japanese)

Getting Started with TWSNMP NEO

Next-Generation Container-Native & Web-Based Network Management System


1. Introduction

TWSNMP NEO represents the next generation of the renowned TWSNMP network management system series. It consolidates the container portability of TWSNMP FC and the advanced visual and AI capabilities of TWSNMP FK, built from the ground up on modern web architecture (Go 1.27+, Svelte 5 with Runes, and TypeScript).

Core Highlights


2. Installation & Startup

TWSNMP NEO runs either as a Docker container or as a standalone lightweight executable binary.

Running with Docker

docker run -d \
  --name twsnmpneo \
  --restart always \
  -p 8080:8080 \
  -p 514:514/udp \
  -p 162:162/udp \
  -p 2055:2055/udp \
  -p 6343:6343/udp \
  -v $(pwd)/data:/data \
  ghcr.io/twsnmp/twsnmpneo:latest

After startup, open your browser and go to http://<host-ip>:8080.

Running with Docker Compose

Create a docker-compose.yml file:

services:
  twsnmpneo:
    image: ghcr.io/twsnmp/twsnmpneo:latest
    container_name: twsnmpneo
    restart: always
    ports:
      - "8080:8080"       # Web UI & REST / MCP API
      - "514:514/udp"     # Syslog UDP
      - "162:162/udp"     # SNMP TRAP UDP
      - "2055:2055/udp"   # NetFlow / IPFIX
      - "6343:6343/udp"   # sFlow
    volumes:
      - ./data:/data

Launch with:

docker compose up -d

Homebrew (macOS / Linux)

brew install twsnmp/tap/twsnmpneo
twsnmpneo -datastore ./data -port 8080

Windows (Standalone & Background Service)

Download twsnmpneo_windows_amd64.zip from GitHub Releases and register as a native Windows service:

# Register as service (Automatic start on boot)
.\twsnmpneo.exe service install -service-auto -datastore C:\twsnmpneo\data -port 8080

# Start service
.\twsnmpneo.exe service start

Linux (curl Installer & systemd Service)

# One-liner curl install
curl -sS https://raw.githubusercontent.com/twsnmp/twsnmpneo/main/install/install.sh | sh

# Grant network capabilities
sudo setcap 'cap_net_bind_service,cap_net_raw+ep' /usr/local/bin/twsnmpneo

# Run directly
twsnmpneo -datastore ./data -port 8080

# Or register as a Linux systemd background service
sudo twsnmpneo service install -auto -datastore /var/lib/twsnmpneo -port 8080
sudo twsnmpneo service start

Smart Self-Updater

TWSNMP NEO detects its runtime environment (Docker, Homebrew, Standalone) and provides seamless self-updates:

# Check for updates
twsnmpneo update -check

# Update in-place and safely restart
twsnmpneo update -y

3. User Interface Overview

TWSNMP NEO is engineered as a responsive Single Page Application (SPA).


4. Map Screen

Nodes and Networks (SW-HUB Port Panel)

Right-clicking any network (SW-HUB) container opens a dedicated context menu providing direct access to information inspection, PING, MIB browser, neighbor topology finder, container property edits, and batch port-line editing:

Switching hubs and networks can also be managed via the dedicated inventory list:

Connection Lines & Packet Flow Animation

Connect nodes and switch ports via drag-and-drop or Shift+click. When bound to traffic polling metrics, line widths dynamically scale with bandwidth utilization, and packet flow dots animate in real time.

Lines can also be audited and managed in the Lines inventory table (Source, Destination, Width, Info/Port discovery reason, and Connection Health):

Draw Items (11 Types)

Enrich your topology map with functional and aesthetic widgets:

  1. Rectangles / Ellipses: Zone grouping and network perimeter boundaries
  2. Text / Labels: Custom headers and descriptions
  3. Static Images: Floor blueprints, office maps, or rack layouts
  4. Classic Gauge: Analog dial needle meters
  5. Radial Gauge: Donut charts for CPU / memory utilization
  6. Bar Gauge: Horizontal resource meters (storage, bandwidth)
  7. Sparkline: Time-series micro-charts
  8. Real-Time KPI Cards: High-impact numeric metric displays with color thresholding

All configured draw items can also be audited and managed in the Draw Items inventory list:

3D Virtual Hardware Panel (vpanel)

Right-click any switch node and select Virtual Panel to launch the 3D WebGL hardware representation.

Map Canvas Menu & Automatic Layout

Right-clicking the empty map background opens the canvas context menu:

Map Settings & Background Images

Configure global map appearance and underlying canvas properties:

GIS Location Map (MapLibre)

Powered by MapLibre GL, the GIS Location view visualizes node physical distribution across real-world geographic map layers based on each node’s latitude and longitude (Loc property). Ideal for wide-area networks (WAN) and multi-site campus infrastructure monitoring.


5. Auto-Discovery & Topology Exploration

IP Range Auto-Discovery

Scan subnets (e.g., 192.168.1.0/24) using simultaneous ICMP Ping, SNMP walk, and ARP discovery to populate maps automatically.

During execution, real-time discovery progress and categorized service detection counters (SNMP, Web, SSH, Mail, File, RDP, LDAP) are displayed:

Neighbor Topology Finder (Find Neighbor)

Inspects switch ARP caches, Bridge MIB FDB tables, and LLDP/CDP neighbor tables to automatically identify and connect nodes to their exact switch ports. The widened dialog eliminates text truncation and displays detection reasons (LLDP, FDB-Edge, ARP) alongside confidence percentages (%):


6. Node & Polling Management

Node List & Node Details

View and manage all monitored nodes, IP/MAC bindings, hardware vendors, and operational states in a real-time searchable inventory list:

Right-clicking any node and selecting “Info” opens the Node Details view, displaying system health metrics and an inline list of all configured pollings. Users can inspect polling trend charts, jump directly into polling edits, or launch node editing via the dedicated top-level action button.

Clicking the AI Node Health Diagnosis button triggers an LLM evaluation of node status, active polling warnings, and risk factors, rendering root cause explanations and recommended remediation actions in structured Markdown with bilingual (Japanese/English) toggling:

Node Property Editor (2-Column & Shared Auth)

The node configuration dialog features an expansive two-column layout:

Extensive Polling Protocols

Global default polling parameters (interval, timeout, retry count, SNMP mode, community string) can be configured under System Configuration:

AI Polling Setup Assistant

Describe monitoring requirements in natural language (e.g., “Create a polling that alerts if CPU utilization exceeds 85%”), and the AI automatically generates the appropriate OID, polling type, and threshold expression. (Experimental feature under development)


7. Diagnostic & Operational Tools

Ping / Smokeping / MTR

MIB Browser & MIB Tree Explorer

Browse standard RFC MIBs and vendor private MIB trees. Perform Get / GetNext / Walk / Table operations, sort table columns, and export data directly to CSV.

gNMI Tool

Query modern telemetry streams and inspect configurations over gRPC. Features resizable table columns, inline real-time search, pagination (10 to 100 items), and keyboard shortcuts (Enter to Get, Escape to close).

Wake-on-LAN (WOL)

Execute directly from the node’s right-click context menu on the map or via the “WOL” button at the top of the Node Details modal. Broadcasts Magic Packets to the target MAC address for instant remote power-on.


8. Analytics & Reporting Suite

TWSNMP NEO incorporates 10 dedicated analytics engines:

Device Analytics (LAN / Wi-Fi / Bluetooth / FDB)

Vendor OUI breakdown, signal strength, and rogue device tracking.

IPAM (IP Address Management Heatmap)

Multi-subnet utilization heatmaps and IP conflict detection.

Flow & Traffic Analysis (NetFlow / sFlow / Fumble)

Top talkers, top ports, and Fumble anomalous connection tracking.

Host Analysis (Windows Events / Processes)

Windows Security event auditing, privilege escalation, and active processes.

IoT & Environmental Sensors (Temperature / Power)

Temperature, humidity, pressure, and energy consumption (Wh) trends.

MQTT Reports

IoT/Smart device message volume statistics by topic, client connections, and AI trend summaries.

OpenTelemetry (OTel) Reports

Distributed trace summaries, service latencies, and AI bottleneck diagnostics. Features a top header action bar for reload, report, and deletion, along with one-click polling creation directly from metric and trace tables (with automatic hostname and IP address node matching).

TWAgent & AI Security Audit (twagentneo)

Integrates rich telemetry and AI security audits from cross-platform twagentneo agents across MQTT, Syslog (RFC 5424), and SNMP TRAP without prior manual configuration:

TLS/SSL Certificate Monitoring

Expiration countdown and revocation status verification.

AI Anomaly Detection Scores

Statistical anomaly scoring and ranking across nodes and pollings.

One-Click “AI Diagnosis” Across All Reports

Click the “AI Diagnosis” button on any report toolbar (Syslog, TRAP, NetFlow, IP, ARP, Sensor, MQTT, OTel) to trigger instant LLM analysis of the current statistical data, producing bottleneck insights and actionable remediation steps in structured Markdown with smooth loading animations.


9. High-Speed Log Management (Apache Parquet)

Built on Apache Parquet columnar compression, TWSNMP NEO processes massive log volumes with exceptional speed and minimal storage overhead.

Supported Log Types

Receivers & Daemons Settings

Log and packet receiving daemons (Syslog UDP/TCP:514, SNMP TRAP UDP:162, NetFlow UDP:2055, sFlow UDP:6343, ARP Watch CIDR, OpenTelemetry OTLP gRPC/HTTP:4318, MQTT Broker) can be enabled or configured under Receivers & Daemons settings. Configuration updates dynamically reload and restart target daemons without restarting the application. Full support for SNMPv3 TRAP decryption and MIB OID name resolution is built-in.

Independent Log Retention Policy & Parquet Compaction

Database event logs (bbolt) and high-volume streaming logs (Parquet) feature independent retention periods. A background cleaner runs every 10 minutes to automatically purge expired bbolt event records and rotate Parquet files based on both age and disk quotas. In addition, in-memory caching (sync.Map) with deferred batch flushing, fast timestamp range query pruning, and automated background file compaction (Compact) ensure peak query speeds and low disk fragmentation across years of operation.

Probe Tag Auto-Parsing & Cached Reverse DNS

Automatically recognizes and normalizes syslog probe tags (twpcap, twWifiScan, twBlueScan, twwinlog, twagentneo, etc.) even when upstream relays embed or prepend tags to hostnames, extracting clean type= key-value payloads. In addition, report generation automatically executes reverse DNS lookups for unregistered IP nodes, caching hostnames with a 1-hour TTL for high-performance zero-delay visualization.

AI Root Cause Diagnosis

When critical events occur, one-click AI analysis summarizes correlated preceding and succeeding logs to identify the root cause and provide clear remediation steps in Markdown.


10. Built-in PKI (Certificate Authority) & TLS Management

A complete, self-contained Private PKI system embedded directly within your network manager. Modeled after the production-grade TWSNMP FC Web server architecture, it offers an intuitive left-sidebar interface with full protocol server integration.

Root CA Setup & Certificate Ledger

Generate Root CA keys and certificates securely (supporting RSA and ECDSA key curves) with explicit initialization. Features unified keyword search, revoked certificate counts, column sorting, pagination, CSV export, individual PEM download, and revocation actions.

In-Browser CSR Generation

Simultaneously generate private keys and CSRs with immediate ZIP package downloads. Issue and download signed PEM certificates from uploaded CSR files.

CRL / OCSP / SCEP / ACME Services

ACME Auto-Renewal Client & TLS Certificates

When operating TWSNMP NEO over HTTPS (TLS), the built-in ACME client (powered by lego) can automatically acquire and renew certificates from public ACME providers like Let’s Encrypt or the internal ACME server. It also supports manual PEM certificate/key file paths and seamless certificate migration from TWSNMP FC.


11. AI & MCP Integration

LLM Configuration (Local LLM / Cloud AI Services)

Configure AI providers (Local tensai LLM, Gemini, OpenAI, Claude, Ollama) and parameters directly from the settings.

Local LLM & WebGPU Acceleration

TWSNMP NEO includes an offline inference engine (tensai v0.0.35+) requiring zero external cloud dependencies or API keys. Supports one-click Hugging Face model downloads, expanded model presets, hardware-accelerated local WebGPU inference, rich Markdown output formatting, language switching, and smooth loading animations. HTTP timeouts for local and external LLMs are extended to 15 minutes, with built-in output parsing for reasoning and thinking models (such as DeepSeek-R1 and Qwen) via Ollama.

Native Streamable HTTP MCP Server

TWSNMP NEO provides a built-in Model Context Protocol (MCP) server over Streamable HTTP (/api/mcp). 42 diagnostic and management tools (node/line/polling CRUD, immediate polling check, Ping/SNMP/MIB, NetFlow/Syslog/Trap/Event logs, AI anomaly scores, OTel APM metrics/traces, report summaries, sensor filters) and 31 prompt templates are exposed directly to AI agents like Cursor, Claude Desktop, and Antigravity to inspect network status, query logs, manage monitoring configurations, and execute diagnostic tools autonomously.

Refer to the MCP Specification & Guide and AI Prompts Guide for architecture details.


12. Public Dashboard & Embed System

TWSNMP NEO features a secure, token-authenticated public dashboard designed for external sharing, NOC video walls, and team monitors without login credentials.

Key Features


13. Settings & System Administration

System Status & Resource Monitor (Two-Tab Layout)

The system administration interface is organized into two dedicated tabs:

Public Dashboard Configuration

Configure the public dashboard via the “Dashboard” tab in System Configuration: enable/disable public access, regenerate keys, add and reorder public items (map and pollings), set custom titles and rotation intervals, configure Drama Alert trigger rules, and copy URLs or iframe embed snippets with a single click:

Notifications (Email / Webhook)

Receive instant alerts and periodic reports across supported channels:

Database Settings & Scheduled Backups

Backup Management & Disaster Recovery

Open the dedicated Backup Manager modal directly from the System Status tab to inspect and manage all database archives.

Icon Management & Custom Assets

Manage built-in Material Design Icons (MDI) and import/export custom PNG/JPEG/SVG image icons for map nodes and topology elements.

User Account Management & Access Control

Manage multi-user access with granular role-based permissions (ADMINISTRATOR, OPERATOR, READ-ONLY) and secure credential management.

URL Parameter Auto-Login & History Sanitization (twsnmpmw Integration)

Seamlessly integrates with multi-window managers and centralized monitoring portals like twsnmpmw:


Conclusion

TWSNMP NEO delivers a robust, container-native network observability platform with 3D visualization, big data log storage, and native AI integration. Start managing your network today using Docker or standalone binaries!