Repository navigation
Releases
v0.7.0
🇯🇵 日本語
TWSNMP NEO v0.7.0 をリリースしました!🎉
本バージョンでは、内蔵 MCP (Model Context Protocol) サーバーの 42 ツール・31 プロンプトへの大幅拡張および CLI アクセス制御フラグの追加、受信デーモンのバインドエラー検出・SystemView 表示対応、さらに Playwright による E2E テストスイートとドキュメントスクリーンショット/デモ録画の自動化 を導入しました。
🌟 主な新機能・改善点
1. 内蔵 MCP サーバーの拡張(42 ツール / 31 プロンプト)& CLI フラグ
- ノード / ライン / ポーリング CRUD ツール追加:
add_node、update_node、delete_node、add_line、delete_line、add_polling、update_polling、delete_pollingを追加し、AI エージェントからネットワークトポロジーや監視設定を自律的に構築・管理できるようになりました。 - 診断・検索・AI 異常検知ツール強化: 即時ポーリング実行(
check_polling)、NetFlow 検索(search_netflow)、AI 異常検知スコア取得(get_ai_anomaly_list)などのツールを追加・改善し、全 42 ツール・31 プロンプトテンプレートを提供します。 - 起動時アクセス制御フラグ:
-mcpFrom(TWSNMP_MCPFROM)および-mcpMode auth|noauth(TWSNMP_MCPMODE)を追加し、CLI 引数や環境変数から MCP サーバーのアクセス許可 IP/CIDR と認証モードを上書き指定できるようになりました。 - ドキュメント・仕様書更新: 42 ツールおよび CLI フラグに合わせて MCP 仕様・連携ガイド、AI プロンプトガイド、
SPEC.md/SPEC-ja.md、READMEを更新しました。
2. 受信デーモンのバインドエラー検出 & SystemView 表示
- バインドエラーの即時検知: Syslog、SNMP TRAP、NetFlow、sFlow、ARP Watch、OpenTelemetry、MQTT の各受信デーモンにおいて、ポート競合(
address already in use)や権限不足などのバインドエラー発生時にerrorステータスと詳細なエラーメッセージを記録します。 SystemViewでの可視化: システムステータス画面の該当レシーバーカードがエラー表示となり具体的な原因メッセージを確認できるほか、システム全体のデーモン稼働状態もERRORとして即座に通知されます。
3. Playwright E2E テスト & ドキュメント自動化基盤
- E2E テストスイート導入:
e2e/配下に Playwright を用いた自動テスト(認証・RBAC、全画面スモーク、3D VPanel、マップキャンバス操作、公開ダッシュボード、i18n/テーマ切替)を追加し、GitHub Actions CI(CI / Test)に統合しました。 - デモ録画 & スクリーンショット自動撮影:
mise run record-demoおよびmise run capture-docsによるデモ動画録画・日英ドキュメント画像自動取得に対応しました。
🇺🇸 English
TWSNMP NEO v0.7.0 is now released! 🎉
This release significantly expands the built-in MCP (Model Context Protocol) server to 42 tools and 31 prompts with new CLI access-control flags, adds receiver bind error detection and reporting in SystemView, and introduces a Playwright E2E test suite with automated demo recording and bilingual documentation screenshot capture.
🌟 Key New Features & Improvements
1. Expanded Built-in MCP Server (42 Tools / 31 Prompts) & CLI Flags
- Node, Line & Polling CRUD Tools: Added
add_node,update_node,delete_node,add_line,delete_line,add_polling,update_polling, anddelete_polling, enabling AI agents to autonomously build and manage network topologies and monitoring rules. - Enhanced Diagnostics, Search & AI Anomaly Tools: Added and improved tools including immediate polling execution (
check_polling), NetFlow search (search_netflow), and AI anomaly score retrieval (get_ai_anomaly_list), bringing the total to 42 tools and 31 prompt templates. - CLI Access Control Flags: Added
-mcpFrom(TWSNMP_MCPFROM) and-mcpMode auth|noauth(TWSNMP_MCPMODE) to override MCP IP/CIDR allowlists and authentication modes at startup. - Updated Documentation: Updated the MCP Server Specification & Guide, AI Prompts Guide,
SPEC.md/SPEC-ja.md, andREADMEfiles for all 42 tools.
2. Receiver Bind Error Detection & SystemView Reporting
- Bind Error Propagation: Protocol receivers (Syslog, SNMP TRAP, NetFlow, sFlow, ARP Watch, OpenTelemetry, MQTT) now capture and report bind failures (e.g., port conflicts or insufficient permissions) with
status: "error"and diagnostic error details. SystemViewError Visibility: Affected receiver cards highlight errors with the exact failure reason, and the overall system daemon status reflectsERRORimmediately.
3. Playwright E2E Test Suite & Documentation Automation
- Automated E2E Verification: Added a Playwright E2E suite under
e2e/covering auth/RBAC, 9-view smoke tests, 3D VPanel, map canvas interactions, Public Dashboard, and i18n/theme switching, integrated into GitHub Actions CI (CI / Test). - Demo Recording & Screenshot Capture: Added
mise run record-demoandmise run capture-docsfor automated demo walkthrough videos and bilingual documentation screenshots.
📦 Commits & Changelog
- 5365bdb chore(release): bump version to v0.7.0 and update docs
- ffdcc1f docs(mcp): update specifications, guides, and README for 42 MCP tools
- 84e2423 feat(e2e): add Playwright E2E test suite, demo recording, and doc screenshot automation
- 7f155f7 feat(mcp): fix tool issues, add node/line/polling CRUD and CLI flags
- 4e2d6b8 fix(receiver): report bind errors in daemon status and SystemView
v0.6.0
🇯🇵 日本語
TWSNMP NEO v0.6.0 をリリースしました!🎉
本バージョンでは、運用監視室の大型ディスプレイや外部共有に最適な 「公開ダッシュボード (Public Dashboard)」 を新設したほか、OpenTelemetry APM & AI/LLM 監視ポーリング、内蔵 MCP サーバーの 25+ ツールへの拡張、プロトコルレシーバーの動的管理 & SNMPv3 Trap デコード対応、Parquet ログ検索とコンパクションの大幅な高速化、および 全画面でのステータス表示・カラー統一 など、多数の新機能とパフォーマンス改善を実施しました。
🌟 主な新機能・改善点
1. 公開ダッシュボード & 外部埋め込みシステム (Public Dashboard)
- セキュアなトークン公開アクセス (
/dashboard/:key): ランダムなアクセスキーに基づく認証不要の読み取り専用公開 URL。レスポンス時にノード IP/MAC アドレス、認証情報、LLM API キー等の機密情報を自動マスキング(サニタイズ)して安全に配信します。 - 複数アイテム登録 & 自動ローテーション: ネットワークマップ全体や、重要サーバーの特定ポーリング(応答時間、トラフィック、CPU 負荷等)を複数アイテムとして登録可能。指定秒数ごとにタブを自動ローテーション表示します。
- twFathom 風モダン KPI カード: 5 段階状態(HIGH, LOW, WARN, REPAIR, NORMAL)の均等グリッドピル表示により視認性と余白バランスを最適化。ノード状態、ポーリング状態、24時間受信ログ、AI 異常検知スコア・件数を一目で俯瞰できます。
- 日英バイリンガル対応 (i18n): ヘッダー部のワンクリック言語切替ボタンにより日本語と英語を即座にトグル可能(ブラウザ設定を永続化)。
- TV ドラマ風緊急警報画面 (Drama Alert Overlay): ハザードストライプ、赤点滅パルス背景、異常対象・測定値・発生回数・初検/終検時刻表示、DISMISS ボタンを備えたフルスクリーン警報オーバーレイ。Web Audio API による合成電子警告音(ビープ音)の自動再生にも対応(アイテム毎に設定可能)。
- 外部サイト埋め込み(iframe)対応:
Content-Security-Policy: frame-ancestors *に対応し、社内ポータルや Wiki へ自由に埋め込み可能。?embed=trueクエリによるコンパクト表示モードをサポート。
2. OpenTelemetry (OTel) APM & AI/LLM 監視ポーリング
- OTelPoller によるネイティブ APM 監視:
metric: Gauge / Sum 等の直接集計・評価(gauge, sum, min, max, count, elapsed)。trace: 期間内エラー率、P95 所要時間、HTTP 4xx/5xx および gRPC エラーの自動検知。heartbeat: OTel テレメトリの途絶検知。
- OTelView からのワンクリックポーリング作成: メトリック・トレース一覧テーブルから、対象ノード(ホスト名・IP 自動照合)へのポーリング設定を 1 クリックで自動入力・作成可能に。
- HTTP ポーリング拡張による AI/LLM エンドポイント監視:
- OpenAI 互換 API(
/v1/models)および Ollama(/api/tags)の死活、応答時間(rtt_ms)、利用可能モデル数(models)を直接監視。 - フィルター設定からの認証トークン(Bearer / API Key)自動抽出・付与。
metrics/jsonによる動的 JSON メトリクスの抽出・判定。
- OpenAI 互換 API(
3. 内蔵 MCP (Model Context Protocol) サーバーの 25+ ツール拡張
- AI エージェント(Cursor, Claude Desktop, Antigravity 等)から TWSNMP NEO を自律制御する MCP ツール群を大幅拡張。
- OTel APM:
get_otel_metrics,get_otel_traces - レポート集約:
get_report_summary(各種レポート件数の一括取得) - センサー種別フィルタ:
get_sensor_listのtype_filter引数対応
- OTel APM:
4. プロトコルレシーバーの動的管理 & SNMPv3 Trap デコード
- 動的レシーバー再起動: システム設定でレシーバー設定(ポート、有効/無効)を変更した際、アプリケーション全体を再起動することなく、対象デーモンのみを安全に動的リロード。
- SNMPv3 Trap 対応: SNMPv3 TRAP の暗号化デコードおよび MIB OID 名前解決をサポート。
5. 高速ログストレージ & データストア最適化
- インメモリキャッシュ & 遅延フラッシュ: bbolt の
sync.Mapキャッシュとバッチフラッシュによる書き込み・検索の高速化。 - Parquet コンパクション & 並列スキャン: 断片化した Parquet ログファイルの自動結合(Compact)と、行数キャッシュ(
fileRowsCache)によるログ件数スキャンの並列高速化。 - API アクセスログ最適化: 低速クエリ(>=1s)およびエラー応答のみを記録するように絞り込み、ログの肥大化を防止。
6. UI & ステータス表示の統一
- 英語大文字表記への完全統一: ノード状態、ポーリング状態/レベル、イベントログ、各種レポート等、全画面で重要度・状態を英語大文字(
HIGH,LOW,WARN,INFO,NORMAL,REPAIR,OFF,UNKNOWN)に統一。 - WARN 配色の Amber 統一: 警告カラーを厳格に Amber(
#f59e0b)に統一し視認性を向上。 - ライン接続ヘルス表示: ライン接続一覧(LineList)でのリンク稼働状態・ヘルス状態の統合表示。
- gNMI 診断ツールの強化: テーブル列幅ドラッグ調整、リアルタイム検索、ページネーション、キーボードショートカット対応。
- 診断ダイアログの安定化: バックグラウンドでのマップ自動更新時に各種診断ダイアログがリセットされないよう改善。
7. AI & 定期日報レポートの強化
- LLM タイムアウト延長 & 思考モデル対応: タイムアウトを 15 分に延長し、Ollama 経由の思考モデル(DeepSeek-R1 や Qwen 等の thinking models)の出力自動パースに対応。
- 定期日報での警告イベント集約: 毎朝の日報レポート(HTMLメール / Webhook)において、同一の警告イベントを自動集約(
count=N)し、超過時は省略表示するスマートレポート機能を追加。
🇺🇸 English
We are excited to announce the release of TWSNMP NEO v0.6.0! 🎉
This release introduces the brand-new Public Dashboard, designed for NOC video walls and external sharing, along with OpenTelemetry APM & AI/LLM Endpoint Polling, Expanded MCP Server (25+ tools), Dynamic Receiver Management with SNMPv3 Trap Decoding, Significant Parquet Search & Compaction Optimizations, and Standardized Severity Status Badges across all views.
🌟 Key Features & Enhancements
1. Public Dashboard & Embed System
- Secure Token-Based Public Access (
/dashboard/:key): Read-only public dashboard accessed via a randomized URL token. Automatically sanitizes and masks sensitive information (IP/MAC addresses, credentials, LLM API keys) before transmission. - Multiple Item Registration & Auto-Rotation: Register multiple items (topology map, specific node pollings such as latency, traffic, or CPU load) with custom display titles and automatic rotation intervals.
- twFathom-Style Modern KPI Cards: Equal-width 5-level severity pills (HIGH, LOW, WARN, REPAIR, NORMAL) optimizing readability and spacing. Real-time overview across node states, polling states, 24-hour log ingestion, and AI anomaly scores.
- Bilingual Internationalization (i18n): Instant JA/EN toggle button in the header with persistent browser storage, localizing metrics, chart tooltips, and alert overlay messages.
- TV-Drama Style Emergency Alert Overlay (Drama Alert): Eye-catching full-screen hazard overlay with hazard stripes, red pulsing background, incident telemetry, and DISMISS button. Synthesizes audible emergency beep sirens via browser Web Audio API (configurable per item).
- External Embedding (iframe): Built-in
Content-Security-Policy: frame-ancestors *and compact mode (?embed=true) for seamless embedding into internal portals and wikis.
2. OpenTelemetry (OTel) APM & AI/LLM Polling
- Native APM Evaluation via OTelPoller:
metric: Evaluates OTel metrics (Gauge/Sum) with calculation of gauge, sum, min, max, count, and elapsed time.trace: Evaluates distributed traces for error rates, P95 latencies, and HTTP 4xx/5xx / gRPC errors.heartbeat: Detects telemetry loss / agent heartbeat termination.
- One-Click Polling Creation from OTelView: Prepopulated polling creation buttons directly within metric and trace tables, automatically matching hostnames and IP addresses.
- HTTP Polling for AI/LLM Endpoint Monitoring:
- Monitors availability, response latency (
rtt_ms), and available model count (models) for OpenAI-compatible (/v1/models) and Ollama (/api/tags) endpoints. - Automatic extraction of authentication tokens (Bearer / API Key) from filter parameters.
- Dynamic JSON metric extraction via
metrics/json.
- Monitors availability, response latency (
3. Native Streamable HTTP MCP Server (25+ Tools)
- Expanded Model Context Protocol (MCP) server for autonomous AI agents (Cursor, Claude Desktop, Antigravity, etc.):
- OpenTelemetry APM:
get_otel_metrics,get_otel_traces - Analytics Summary:
get_report_summary(aggregating record counts across all report types) - Sensor Type Filters:
get_sensor_listwith optionaltype_filter
- OpenTelemetry APM:
4. Dynamic Receiver Management & SNMPv3 Trap Decoding
- Dynamic Receiver Reloading: Updates to receiver configurations (ports, enable/disable) dynamically reload and restart target daemons without restarting the application.
- SNMPv3 Trap Decoding: Full support for SNMPv3 TRAP decryption and MIB OID name resolution.
5. High-Speed Log Storage & Performance Optimizations
- In-Memory Caching & Deferred Flush:
sync.Mapcaching and deferred batch flushing for bbolt datastore. - Parquet Compaction & Parallel Scans: Automated background Parquet file compaction and parallel count scanning using file row caches (
fileRowsCache). - Access Log Filtering: Limits HTTP access logs to slow queries (>=1s) and error responses to prevent log bloat.
6. Standardized UI & Diagnostic Enhancements
- Standardized Severity Badges: Unified uppercase English status indicators (
HIGH,LOW,WARN,INFO,NORMAL,REPAIR,OFF,UNKNOWN) across all tables and modals, with strict Amber (#f59e0b) coloring for warnings. - Line Connection Health: Integrated operational health status in the Line List view.
- gNMI Diagnostic Tool: Added resizable table column widths, inline real-time search, pagination, and keyboard shortcuts.
- Diagnostic Dialog Stability: Prevents active diagnostic modals from resetting during background map refreshes.
7. AI & Daily Report Enhancements
- Extended LLM Timeout & Thinking Models: HTTP timeout extended to 15 minutes, with built-in output parsing for reasoning/thinking models (e.g. DeepSeek-R1, Qwen) via Ollama.
- Deduplicated Events in Daily Reports: Daily operational reports automatically group identical warning events (
count=N) with smart omission handling.
📦 Commits & Changelog
• 79d18f5 docs: update screenshots and documentation for v0.6.0 release
• 6f396e4 docs(dashboard): update public dashboard documentation and screenshots
• 8c33299 fix(config): add i18n support to public dashboard settings tab
• c1054dd fix(ai): extend LLM timeout, group report events, and support thinking models
• e98d4d6 fix(log): fix log count badges resetting to 0 and optimize parquet count scan
• edf3295 feat(ui): unify level/status display, amber warn color, and line health integration
• b660176 feat(dashboard): improve public dashboard KPI layout, add i18n support, and fix node icon font fallback
• f40ace6 chore(release): bump version to v0.6.0 and update docs
• 7e9b68b fix(dashboard): fix draw items rendering and background image loading on public map
• 8a9e8c3 feat(otel,mcp,polling): add OTel APM & AI/LLM polling, expand MCP tools, and integrate UI
• 37b516e perf(datastore): optimize bbolt/parquet log search, add parquet compaction and fix otel panic
• 5375bc0 feat(dashboard): add public dashboard with multi-item rotation, drama alerts, and optimized kpi performance
• ef40deb feat(receiver): support dynamic receiver management, SNMPv3 trap decoding, and live UI reload
• 442325f feat(gnmi): enhance GNMIToolDialog with table column widths, pagination, search, and shortcuts
• 1b2a93d fix(ui): prevent diagnostic dialogs from resetting on background map refreshes
v0.5.0
🇯🇵 日本語
TWSNMP NEO v0.5.0 をリリースしました!🎉
本バージョンでは、運用管理者が安心して長期稼働を行えるよう、トランザクション安全なデータベース定期バックアップ・世代管理・リストア機能、ログ保存期間ポリシーの個別分離、外部ポータルやマルチウィンドウ連携(twsnmpmw)を容易にする URL パラメータ自動ログイン、および Syslog プローブ解析と DNS 逆引きキャッシュの強化 を追加しました。
🌟 主な新機能・改善点
1. データベース定期バックアップ & リストア管理
- トランザクション整合性スナップショット:
bbolt.Tx.CopyFileにより、稼働中の書き込みによるデータベース破損リスクを完全排除した安全なスナップショットバックアップを実現。 - 柔軟な自動定期バックアップ:
- 実行モード(毎日 / 1回のみ / 即時実行後毎日 / 無効)と実行時刻(HH:MM)を設定可能。
- 1〜30世代の自動世代管理・ローテーションに対応。
- 設定・トポロジーのみ保存(軽量
ConfigOnlyモード):- 大容量のイベントログや OTel トレースを除外し、ノード、ライン、ポーリング、マップ設定情報のみを瞬時にバックアップ。
- Web UI バックアップ管理モーダル:
- システム画面の「DBバックアップ」ボタンより、保存済みアーカイブ一覧の閲覧、即時バックアップ実行(フル / 設定のみ)、ダウンロード、削除が可能。
- CLI メンテナンス & オフライン復元:
-backup <dir>: 稼働中データベースの即時スナップショット作成。-restore <file>: オフラインでの安全なデータベース復元(既存DBの自動退避バックアップ付き)。-compact <file>: 長期運用による bbolt データベースの空き領域(フラグメンテーション)の回収・圧縮。
2. ログ保存期間ポリシーの個別分離
- イベントログと大容量受信ログの独立管理:
- システム設定の「データベース」タブにて、bbolt イベントログ保存期間(デフォルト: 30日) と Parquet 受信ストリーミングログ保存期間(デフォルト: 14日) を個別に設定可能に。
- 10分ごとのバックグラウンド定期処理により、古いイベントログのパージと Parquet ファイルの容量・日数ベースの自動ローテーションを確実に実行。
3. URL パラメータ自動ログイン & 履歴クリーンアップ (twsnmpmw 連携)
- シームレスなシングルサインオン & ダイレクト遷移:
?token=<JWT>または?user=<ID>&password=<PASS>によるアクセス時自動認証。?view=<画面名>(map,logs,reports,system等)による初期表示画面のダイレクト指定に対応。
- セキュリティクリーンアップ:
- 認証完了後、
window.history.replaceStateによりブラウザのアドレスバー履歴から認証パラメータを即座に自動除去。URL共有や履歴残存による認証情報の漏洩リスクを防止。 - マルチウィンドウ統合マネージャー
twsnmpmwや各種運用ポータルとのセキュアな連携を強化。
- 認証完了後、
4. Syslog プローブタグ自動解析 & DNS 逆引きキャッシュ
- プローブタグの柔軟抽出:
twpcap,twWifiScan,twBlueScan,twwinlog,twagentneo等からの送信ログにおいて、リレーやSyslogサーバによりタグがホスト名やメッセージ本文に混在した場合でも、自動的にプローブタグを認識してtype=のKey-Valueを正規化パース。
- DNS 逆引きキャッシュ:
- レポート集計処理(
pcapパケット解析やフロー解析等)において、マップ未登録のIPアドレスについて自動的に DNS 逆引き(Reverse DNS Lookup)を行いホスト名を解決・表示。TTL 1時間のキャッシュにより高速かつ低負荷に動作。
- レポート集計処理(
5. 定期日報レポートの機能拡充
- 毎朝の定期日報レポート(HTMLメール / Webhook送信)において、従来の bbolt データベースサイズに加え、Apache Parquet 列指向ログストレージの合計容量・使用状況の集計情報を自動掲載。
🌐 English
We are thrilled to announce the release of TWSNMP NEO v0.5.0! 🎉
This release introduces enterprise-grade database backup, rotation & disaster recovery, independent log retention policies, URL parameter auto-login with history sanitization for external portal and multi-window integration (twsnmpmw), and enhanced syslog probe parsing with cached reverse DNS lookups.
🌟 Key Highlights
1. Database Scheduled Backup, Rotation & Disaster Recovery
- Transaction-Safe Live Snapshots: Employs
bbolt.Tx.CopyFileto create atomic, live database snapshots without service downtime or risk of file corruption. - Automated Backup Scheduling:
- Configurable schedule modes (Daily, Once, Run Once & Daily, or Disabled) and customizable trigger time (HH:MM).
- Automated generation rotation supporting retention of 1 to 30 generations.
- Lightweight Config-Only Backup Mode (
ConfigOnly):- Saves an ultra-fast snapshot containing topology nodes, lines, pollings, and configurations while omitting voluminous event logs and OTel traces.
- Integrated Web UI Backup Manager:
- Inspect backup archives (names, sizes, creation dates), trigger on-demand backups (Full or Config-Only), download archives, and remove older backups directly from the System Status tab.
- Offline CLI Maintenance:
-backup <dir>: On-demand live backup snapshot.-restore <file>: Safe offline restoration with automatic timestamped pre-restore safety archiving of the active database.-compact <file>: Offline bbolt compaction to reclaim unused disk space and resolve fragmentation.
2. Independent Log Retention Policies
- Separated Retention Periods:
- Configure retention days independently for bbolt Event Logs (default: 30 days) and Parquet Streaming Logs (default: 14 days) within the Database settings tab.
- An automated 10-minute background cleaner purges expired event records and rotates columnar Parquet files based on both age and disk quotas.
3. URL Parameter Auto-Login & History Sanitization (twsnmpmw Integration)
- Deep-Linking & Single Sign-On:
- Supports automatic login via
?token=<JWT>or?user=<username>&password=<password>. - Direct initial view selection via
?view=<view_name>(map,logs,reports,system, etc.).
- Supports automatic login via
- Automatic History Sanitization:
- Sanitizes and purges all credential query parameters from the browser address bar (
window.history.replaceState) immediately after authentication to protect credentials from residing in browser history or leaking via copied links. - Seamlessly integrates with multi-window managers like
twsnmpmwand external dashboards.
- Sanitizes and purges all credential query parameters from the browser address bar (
4. Syslog Probe Tag Auto-Parsing & Cached Reverse DNS Lookups
- Resilient Probe Tag Normalization:
- Reliably extracts and normalizes syslog tags for probe telemetry (
twpcap,twWifiScan,twBlueScan,twwinlog,twagentneo, etc.) even when intermediate relays embed or alter tags within hostnames, safely parsingtype=key-value payloads.
- Reliably extracts and normalizes syslog tags for probe telemetry (
- Cached Reverse DNS:
- Automatically resolves hostnames for unregistered IP nodes across packet and flow reports with a 1-hour TTL in-memory cache for high performance.
5. Storage Metrics in Daily Operational Reports
- Daily summary reports sent via email or webhooks now include aggregated disk utilization for both bbolt and Parquet log repositories.
📦 Commits & Changelog
- ba71793 chore(release): bump version to v0.5.0 and update documentation for database backup
- 8cccdf1 feat(auth): support URL parameter auto-login and cleanup for twsnmpmw integration
- 02f9aa9 feat(backup): add scheduled database backup, rotation, and restore management
- 7fc9331 feat(datastore): separate log retention periods for bbolt and parquet
- 2073c15 feat(logreport): enhance syslog probe tag parsing and add DNS reverse lookup with cache
- 36d7eef feat(report): add log storage size to periodic report
- cf723af fix(.gitignore): correct data directory entry for build artifacts
- 5cfbbe5 fix(backup): fix missing i18n translations in BackupManagerModal
- 40d88d7 fix(test): use private IP in TestPcap to prevent DNS resolution differences
v0.4.0
TWSNMP NEO v0.4.0 Release Notes
English
TWSNMP NEO v0.4.0 introduces the complete TWAgent (twagentneo) Integration & AI Security Audit suite, Security Configuration Assessment (SCA) aligned with CIS benchmarks, report analytics performance optimizations, cross-view UI layout standardization, and critical security and dependency upgrades.
🌟 Highlights & New Features
-
TWAgent & AI Security Telemetry (
twagentneoIntegration):- Zero-Config Multi-Protocol Ingestion: Automatically receives, parses, and classifies
twagentneotelemetry, alerts, FIM (File Integrity Monitoring), and SCA (Security Configuration Assessment) over MQTT, Syslog (RFC 5424), and SNMP TRAP without prior manual configuration. - Dedicated Agent Report Suite (
AgentReport.svelte):- Agent Inventory & Telemetry (
twAgentInfo): Real-time heartbeat (LWT/heartbeat), OS/architecture details, live CPU, memory, disk, and network rates. Features one-click topology node registration and recommendedtwagentneopolling creation directly from the inventory. - AI Security & Compliance Alerts (
twAgentAlert): Cross-protocol Sigma rule detections with local LLM (tensai) triage (IsThreat: YES/NO), severity scoring, Japanese explanations, and actionable remediation advice. - File Integrity Monitoring (
twAgentFIM): Real-time tracking of file creations, modifications, deletions, and permission changes with SHA256 hashes. - Security Configuration Assessment (
twAgentSCA): CIS benchmark-aligned security audits (file permissions, leftover files, plaintext credentials/secrets, and system/service configurations) with masked proof, remediation guidance, and AI triage. - Process TCP Connections (
twAgentTCP): Outbound and inbound active TCP socket destinations per process with GeoIP country mapping and statistical anomaly deviation scoring.
- Agent Inventory & Telemetry (
- Sensor Monitor & Remote ARP Ingestion: Agent metrics feed sensor monitor charts (
type: twagentneo) for historical performance trends, while remote ARP feeds remote subnet ARP Watch, device inventory, and IPAM tables. - Extended Polling Modes: Syslog, SNMP TRAP, and MQTT polling modes now support
twagentneoalert and telemetry evaluations.
- Zero-Config Multi-Protocol Ingestion: Automatically receives, parses, and classifies
-
Report Performance & Large-scale Query Optimization:
- Category Lazy Loading: Dynamically loads report data only when a specific category tab is viewed, significantly speeding up initial report rendering and lowering memory usage.
- Query-time Parquet Pruning: Skips old Parquet log files outside the requested time window during queries, reducing disk I/O and query latency.
-
UI/UX Consistency & Operational Enhancements:
- Standardized Table Controls: Unified search filter boxes to the top-left and pagination page-size selectors to the bottom-left across all tabular views.
- MQTT Payload Inspection: Added a copy button for expanded payloads in MQTT topic statistics and received logs, and adjusted column widths to display full topic paths clearly.
- Network Interface Management: Added SNMP settings to NetworkDialog and real-time interface port state polling.
- Map Optimization: Suppressed redundant node update event log generation during map marker repositioning.
🔒 Security & Dependency Upgrades
- Echo Web Framework: Updated to
v4.16.2resolving known security vulnerabilities. - Vite: Updated to
8.3.5resolving Dependabot advisories. - Transitive Overrides: Patched
zodandpostcss-selector-parservulnerabilities in frontend dependencies.
日本語
TWSNMP NEO v0.4.0 では、クロスプラットフォーム監視エージェント TWAgent (twagentneo) との統合 & AI セキュリティ監査スイート、CIS ベンチマーク準拠のセキュリティ設定診断 (SCA)、レポート分析の遅延読み込みと Parquet クエリ高速化、各種テーブル UI の操作性統一、ならびに依存ライブラリのセキュリティ更新を実施しました。
🌟 主な新機能・機能強化
-
TWAgent 連携 & AI セキュリティ監査スイート (
twagentneo統合):- マルチプロトコル自動受信・ゼロコンフィグ集約: MQTT、Syslog (RFC 5424)、SNMP TRAP 経由で送信される
twagentneoのテレメトリ、アラート、FIM (ファイル整合性監視)、SCA (セキュリティ設定診断) を事前設定なしで自動受信・分類。 - 専用エージェントレポート画面 (
AgentReport.svelte):- エージェント一覧 & テレメトリ (
twAgentInfo): 稼働状態(LWT / ハートビート)、OS・バージョン情報、CPU/メモリ/ディスク/ネットワーク帯域をリアルタイム表示。未登録エージェントのノードおよび推奨ポーリングをワンクリックでトポロジーマップへ自動登録。 - AI セキュリティ & コンプライアンスアラート (
twAgentAlert): Sigma ルール検知とローカル LLM (tensai) のハイブリッド判定による脅威判定(真の脅威判定IsThreat: YES/NO)、重要度、日本語サマリー、推奨是正措置を提示。 - ファイル整合性監視 (
twAgentFIM): 重要ファイルやディレクトリの作成・更新・削除・パーミッション変更(SHA256ハッシュ付き)のイベント履歴を追跡。 - セキュリティ設定診断 (
twAgentSCA): CIS ベンチマークに準拠したパーミッション、不要ファイル、平文クレデンシャル、サービス設定の診断結果とマスク済みエビデンス、AIによる原因・対策サマリーを集計。 - プロセス別外向きTCP接続 (
twAgentTCP): プロセスごとの接続先IP、宛先ポート・サービス名、GeoIP 国別情報と偏差スコア(平均50、標準偏差10)による異常通信検知。
- エージェント一覧 & テレメトリ (
- センサーモニター & リモート ARP 統合: エージェントメトリクスをセンサーモニター(
type: twagentneo)に自動反映し、リモートサブネットの ARP テーブルを ARP Watch、デバイス分析、IPAM へ統合。 - ポーリング機能の拡張: Syslog、SNMP TRAP、MQTT ポーリングに
twagentneoアラート・テレメトリ監視モードを追加。
- マルチプロトコル自動受信・ゼロコンフィグ集約: MQTT、Syslog (RFC 5424)、SNMP TRAP 経由で送信される
-
レポート分析のパフォーマンス大幅最適化:
- カテゴリ別遅延読み込み (Lazy-load): 閲覧するレポートカテゴリのデータのみをオンデマンドで取得し、初期表示負荷とメモリ使用量を大幅に低減。
- Parquet クエリの時間範囲プルーニング: クエリ指定期間外の古い Parquet ログファイルを読み込み対象から除外することで、ディスク I/O と検索レイテンシを大幅に短縮。
-
UI/UX 操作性の統一と改善:
- テーブル操作部の統一: すべてのテーブル画面で検索入力欄を「左上」、ページサイズ選択を「左下」に統一。
- MQTT ペイロード操作改善: トピック統計・ログ一覧で展開したペイロードのワンクリックコピー機能を追加し、トピック列幅を拡大してフルパスを見やすく調整。
- ネットワークダイアログ改善: NetworkDialog に SNMP 設定を追加し、ポート状態のポーリングに対応。
- マップ描画の最適化: マップ上のノード位置移動時に発生していた冗長なノード更新イベントログを抑制。
🔒 セキュリティ & 依存関係の更新
- Echo Web フレームワーク:
v4.16.2に更新し既知の脆弱性を解消。 - Vite:
8.3.5に更新し Dependabot セキュリティアラートに対応。 - 依存関係の脆弱性修正: フロントエンドの
zodおよびpostcss-selector-parserの脆弱性をオーバーライドにより解消。
Changelog
• 49b59a6 chore(release): prepare v0.4.0 release with twagentneo integration and docs update
• d73a909 feat(agent): integrate twagentneo monitoring, automatic reporting, and one-click map provisioning
• 5ab4d0f feat(agent): support twagentneo Security Configuration Assessment (SCA)
• a6c2bb8 feat(mqtt): allow copying expanded payload in topic stats and logs
• 4d1e165 fix(agent): preserve and merge multi-protocol FIM/alert ingestion and display MQTT badges
• 25e20d5 fix(deps): update echo to v4.16.2 and override zod/postcss-selector-parser to fix security vulnerabilities
• a4f2a68 fix(deps): update vite to 8.3.5 to resolve dependabot security vulnerabilities
• af1d441 fix(logreport): resolve syntax error and fix SCA ingestion for syslog, mqtt, and trap
• daf4763 fix(map): suppress node update event log when moving nodes
• 405129a fix(mqtt): adjust column widths in received logs to display full topic names
• 0abbe6c fix(network): add SNMP settings to NetworkDialog and poll port states
• 4a81237 fix(report): adjust padding in table cells for improved layout consistency
• a92f3f0 fix(ui): unify table search to top-left and pagination page size to bottom-left across views
• 1790ece perf(report): lazy-load report data by category and skip old parquet files on query
v0.3.0
TWSNMP NEO v0.3.0 Release Notes
English | 日本語
English
TWSNMP NEO v0.3.0 introduces full-featured GIS Location Mapping powered by MapLibre GL, complete parity with TWSNMP FK polling state evaluations, enhanced daemon/receiver status indicators on the system dashboard, and comprehensive UI consistency improvements.
🌟 Highlights & New Features
-
GIS Location Mapping (MapLibre GL):
- Visualizes nodes across interactive geographic map tiles based on node latitude and longitude coordinates (
Locproperty). - Built-in map style presets: Geospatial Information Authority of Japan (GSI Pale, Standard, Photo), CARTO (Dark / Light), OSM Bright, MIERUNE Mono, and OSM Standard, alongside custom style JSON/URLs.
- Direct node placement: Assign unplaced nodes via the top toolbar dropdown or right-click any point on the map canvas.
- Marker drag-and-drop repositioning with instant persistent coordinate saving.
- One-click "Save Default View" to persist initial center coordinates and zoom level.
- Editing lock toggle to prevent unintentional marker dragging during monitoring.
- Quick-access Map Settings dialog and System Configuration "GIS Map" integration.
- Visualizes nodes across interactive geographic map tiles based on node latitude and longitude coordinates (
-
TWSNMP FK Aligned Polling & Diagnostic Evaluation:
- Polling failures caused by connection errors, timeouts, or script syntax issues now transition to
unknownstate, precisely matching TWSNMP FK behavior. - Metric threshold breaches, interface down events, or reboot detections accurately trigger the configured failure level.
- Node health status evaluation updated with robust state prioritization (
high>low>warn>repair>normal>unknown). - Repaired/recovering nodes now update immediately on the map canvas without waiting for full reload cycles.
- Polling failures caused by connection errors, timeouts, or script syntax issues now transition to
-
Server Daemon & Receiver Status Indicators:
- Added live running/disabled status indicators and port information for all background receivers (Syslog, SNMP Trap, NetFlow, sFlow, ARP Watch, OpenTelemetry, MQTT Broker, and PING engine) on the System Overview dashboard.
- Cleaned up duplicate PING entries in KPI panels and enhanced server timezone display.
-
UI Consistency & Layout Refinements:
- Normalized padding and alignment across report tables (MQTT, OpenTelemetry, Node Details, Neighbor Finder).
- Enforced uniform semantic versioning with leading
vprefixes across all update modals and views. - Retained the user's active sub-tab across periodic background map refreshes in the Node Details dialog.
🛠️ Improvements & Bug Fixes
- Polling Manager: Fixed evaluation logic across SNMP, SSH, HTTP, TCP, gNMI, DNS, NTP, and external pollings to correctly reflect connection failure vs threshold violation.
- Node Detail Modal: Corrected diagnostic state evaluation so that
repairstatus is counted as recovered rather than critical. - CI/CD: Added release workflow concurrency controls to prevent duplicate release runs and asset upload race conditions.
- Documentation: Added bilingual documentation for the GIS Location View, configuration dialogs, and updated system screenshots.
日本語
TWSNMP NEO v0.3.0 では、MapLibre GL を採用した本格的な GIS 位置情報マップ の搭載、TWSNMP FK 準拠のポーリング状態評価 への統一、システム画面での 受信デーモン・レシーバー稼働インジケーター の追加、各種 UI の調整・改善が行われました。
🌟 主な新機能・ハイライト
-
GIS 位置情報マップ (MapLibre GL):
- ノードの緯度・経度(
Locプロパティ)をもとに、実世界の地理空間上にノードを配置・監視できるインタラクティブな地図ビューを搭載。 - 豊富な地図タイルプリセット: 国土地理院(淡色地図、標準地図、写真)、CARTO(Dark / Light)、OSM Bright、MIERUNE Mono、OSM Standard、およびカスタムスタイルJSON/URLに対応。
- 直感的なノード配置: 上部ツールバーの未配置ノード一覧からのワンクリック配置、地図余白の右クリックによるノード配置ダイアログ。
- マーカーのドラッグ&ドロップによる位置変更と即時永続化。
- 現在の中心座標とズームレベルをデフォルト表示位置として保存する「初期表示保存」機能。
- 監視中の誤操作を防ぐ位置ロック / 編集可能モード切替。
- 地図画面からワンクリックで開くクイック地図設定ダイアログおよびシステム環境設定への統合。
- ノードの緯度・経度(
-
TWSNMP FK 準拠のポーリング & 状態集約評価:
- 接続失敗、タイムアウト、スクリプト構文エラー等の通信不能時は
unknown(不明)状態へと遷移し、TWSNMP FK の評価仕様に統一。 - メトリクス閾値超過、インターフェース停止、再起動検知時は設定された障害レベルを正しく反映。
- ノード状態集約優先度を強化(
high>low>warn>repair>normal>unknown)。 - 復帰(repair)状態のノードがマップキャンバスへ即座に反映されるよう定期同期を改善。
- 接続失敗、タイムアウト、スクリプト構文エラー等の通信不能時は
-
受信デーモン & レシーバー稼働インジケーター:
- システムステータス画面に、各種バックグラウンド受信デーモン(Syslog、SNMP Trap、NetFlow、sFlow、ARP Watch、OpenTelemetry、MQTTブローカー、PINGエンジン)の稼働状態(稼働中 / 無効)とポート情報をリアルタイム表示するインジケーターを追加。
- KPI パネル内の重複 PING 項目を整理し、サーバータイムゾーン表示を最適化。
-
UI 整合性・テーブルレイアウトの調整:
- 各種レポートテーブル(MQTT、OpenTelemetry、ノード詳細、接続先探索)のパディングとテキスト折り返しを最適化。
- バージョン表示における
vプレフィックスの統一。 - ノード詳細モーダルでマップ定期更新が走った際にも、現在選択中のアクティブタブを維持するよう改善。
🛠️ 不具合修正・改善
- ポーリングエンジン: SNMP、SSH、HTTP、TCP、gNMI、DNS、NTP 等の全ポーリング種別において、通信不能エラーと閾値超過エラーの判定ロジックを修正。
- ノード詳細モーダル: 復旧(repair)状態が誤って重大障害としてカウントされていた判定を修正。
- CI/CD: リリースワークフローに concurrency 制御を追加し、重複実行によるアセット競合を防止。
- ドキュメント: GIS 位置情報画面および設定ダイアログの解説を日・英両ドキュメントに追加し、最新のシステムスクリーンショットに刷新。
Changelog
- 479cc0a chore(release): prepare v0.3.0 release with GIS location mapping and docs update
- 478e960 fix: adjust padding in various report tables for improved layout consistency
- 03ac7f0 feat(location): improve GIS map configuration, node placement and app confirmation modal
- c3cb13a fix(node-detail): preserve active tab on map refresh and align diagnostic state evaluation with node state
- c73f53c fix(polling): align failure and unknown state evaluation with TWSNMP FK
- 2647990 fix(system): refine receiver status indicators, remove duplicate PING from KPI, and adjust timezone display
- f9ba927 fix: ensure consistent 'v' prefix in release versions and UI display
- a6e7c98 ci: add concurrency control to release workflow to prevent duplicate run race conditions
v0.2.0
TWSNMP NEO v0.2.0 Release Notes
English
TWSNMP NEO v0.2.0 is a major feature release introducing expanded AI diagnostic capabilities, hybrid telemetry (MQTT and OpenTelemetry), official Homebrew and OS service management, automated ACME/TLS certificate renewal, and a streamlined modern UI.
🌟 Highlights & New Features
- Advanced AI Diagnostics & Model Expansion:
- Upgraded to
tensai v0.0.35with preset support for modern models (Gemma 3, Qwen 2.5, DeepSeek-R1, Llama 3.3, Claude 3.5 Sonnet, and more). - Diagnostic responses now render rich GitHub-style Markdown with interactive wait animations and bilingual prompt optimization.
- One-click AI cause diagnosis integrated across Node Details and Reports (Event Analytics, MQTT, OpenTelemetry, Flow/Fumble).
- Upgraded to
- Hybrid Telemetry & Observability:
- MQTT Reporting & Logging: Real-time message streaming, topic hierarchy analytics, QoS breakdown, and client tracking.
- OpenTelemetry Ingestion: Ingest and visualize OpenTelemetry logs, metrics, and traces with hybrid analytics.
- Packaging, Service Integration & Self-Update:
- Homebrew Tap: Install effortlessly on macOS and Linux via
brew install twsnmp/tap/twsnmpneo. - OS Service Management CLI: Native service installation, automatic startup, and lifecycle management for Linux (
systemd) and Windows (winsvc). - Smart Self-Updater: Environment-aware in-place binary update via GitHub Releases with CLI rollback capabilities (
twsnmpneo update --rollback). - One-line Installer: Automated installation script via
curl -fsSL https://raw.githubusercontent.com/twsnmp/twsnmpneo/main/install.sh | sh.
- Homebrew Tap: Install effortlessly on macOS and Linux via
- PKI & Certificate Automation:
- Integrated ACME (Let's Encrypt) client for automated TLS certificate issuance and renewal via HTTP-01/TLS-ALPN-01 challenges.
- Enhanced CA dashboard displaying active/revoked certificate metrics and colored server statuses.
- Topology & Map Enhancements:
- Streamlined right-click context menus with unified action labels and conditional Wake-on-LAN (WOL).
- Redesigned "Find Neighbor" dialog with confidence badges and concise neighbor detection reasoning.
- Expanded 2-column Node Edit modal with protocol toggles and independent shared credential selection.
- System Screen Modernization:
- Split into a 2-tab layout: Overview Status and dedicated Resource Monitor (CPU, Memory, Disk, Goroutines, GC heap metrics).
🛠️ Improvements & Bug Fixes
- i18n: Resolved an issue where AI summaries, node details, and polling details displayed Japanese text when English language was selected.
- Map: Fixed canvas freeze caused by async image promises in p5.js and removed legacy packet dot animations to align with TWSNMP FC.
- MQTT: Fixed missing rows in topic statistics tables.
- PKI: Resolved server data races during ACME route registration and ensured clean port release upon ACME server shutdown.
- CI/CD: Added release workflow concurrency controls to prevent duplicate release asset upload collisions.
日本語
TWSNMP NEO v0.2.0 は、AI障害原因診断の強化、MQTTおよびOpenTelemetryのハイブリッドテレメトリ対応、HomebrewやOSサービス(systemd/Windowsサービス)連携、ACME自動証明書更新、UI/UXの刷新を含むメジャーアップデートです。
🌟 主な新機能・ハイライト
- AI障害原因診断の強化とプリセットモデル拡充:
- 推論エンジン
tensai v0.0.35を採用し、最新モデル(Gemma 3, Qwen 2.5, DeepSeek-R1, Llama 3.3, Claude 3.5 Sonnet など)のプリセットを追加。 - AI診断結果のMarkdownリッチ表示、待機アニメーション、日英両言語に応じたプロンプト最適化を実装。
- ノード詳細および各種レポート画面(イベントログ分析、MQTT、OpenTelemetry、フロー/Fumble分析など)からワンクリックでAI原因診断を実行可能に。
- 推論エンジン
- ハイブリッドテレメトリ&レポート拡張:
- MQTT レポート&ログ: トピック階層分析、クライアント接続状況、QoS内訳のリアルタイム可視化。
- OpenTelemetry 対応: OTel ログ、メトリクス、トレースの受信と統合分析。
- 配信・サービス管理・セルフアップデート:
- Homebrew Tap 対応: macOS / Linux 環境で
brew install twsnmp/tap/twsnmpneoによる簡単な導入が可能に。 - OSサービス管理CLI: Linux(
systemd)および Windows(winsvc)のサービス登録・自動起動・削除をCLIコマンドから操作可能。 - 環境認識型セルフアップデート: Web UIからのワンクリックアップデートおよびCLIからのロールバック機能(
twsnmpneo update --rollback)に対応。 - ワンラインインストーラー:
curl -fsSL https://raw.githubusercontent.com/twsnmp/twsnmpneo/main/install.sh | shでの簡単セットアップ。
- Homebrew Tap 対応: macOS / Linux 環境で
- PKI・証明書自動更新(ACME):
- ACME(Let's Encrypt等)によるWebサーバー証明書の自動発行・自動更新に対応。
- 認証局(CA)画面での失効証明書数カウント表示およびサーバー稼働状態の視認性向上。
- マップ・トポロジー操作性の向上:
- ノード・ライン・ネットワークの右クリックメニューを整理(情報・編集・削除の統一、WOLの条件付き表示、再確認の配置最適化)。
- 「接続先を探す」ダイアログの横幅拡大・理由表示の簡潔化と確信度表記の追加。
- ノード編集ダイアログの2カラム化、プロトコル表示制御、共通認証情報の独立化。
- システム画面の再構成:
- 「ステータス」と「リソースモニター」(CPU、メモリ、ディスク、Goroutine、GC状態)の2タブ構成に刷新。
🛠️ 不具合修正・改善
- 多言語対応 (i18n): 英語モード選択時にAI診断結果やノード詳細、ポーリングサマリの一部が日本語のまま表示される問題を修正。
- マップ描画: p5.jsにおける非同期画像読み込み時の描画停止バグを修正、およびTWSNMP FCに合わせてマップライン上のパケットアニメーションを整理。
- MQTT: トピック統計テーブルの行が表示されない不具合を修正。
- PKI: ACMEサーバーとHTTPサーバーのルート登録におけるデータ競合およびサーバー停止時のポート解放漏れを修正。
- CI/CD: リリースワークフローの同時実行制御(concurrency)を追加し、アセットアップロード時の競合を防止。
v0.2.0-test
Changelog
- b850241 docs(spec): AI関連の共通UIおよび操作仕様をSPEC.mdに追記
- 734596a feat(ai): AI診断画面のマークダウン表示対応・モーダルUI改善・言語切替とWAITアニメーションの追加
- 370a9b0 feat(ai): tensaiパッケージ更新(v0.0.35)とプリセットモデル拡充および推論・UIの改善
- e14aea0 feat(ai): twsnmpfkを参考にしたAI連携機能の拡充とノード診断の最適化・多言語対応
- 7b69ef8 feat(node): ノード編集画面の横幅拡大・2カラム化、プロトコル表示制御、複数URL入力および共通認証情報の独立化
- 0cc0eec feat(pki): CAステータスに失効証明書数を追加しサーバー状態の背景色表示を改善
- f0d9231 feat(pki): twsnmpfk v2.5.0のPKI関連拡張とバグ修正のバックポート
- 7821976 feat(release): add Homebrew tap support, curl installer, and environment-aware self-update
- 850833e feat(report): MQTTとOpenTelemetryのレポート機能およびAI分析を追加 (ハイブリッド構成)
- 7dbe214 feat(report): 各種レポート画面へのAI診断機能の追加とエラーハンドリングの改善
- 3833f4f feat(service): Linux systemd サービス登録・削除・自動起動CLI対応
- f74b843 feat(service): Windows サービス対応およびセルフアップデート安全再起動の実装
- c3083b7 feat(tls): add ACME auto-renewal via lego, file cert support, and FC cert migration
- 481f471 feat(updater): Add ETag conditional requests and rate-limit fallback for GitHub API
- f7ff783 feat: Add self-update mechanism with GitHub releases and CLI rollback
- c446b55 feat: ノード詳細モーダルの診断情報を設定済みポーリング表示へ改善しノード編集ボタンを追加
- b513ab7 fix(ci): fix TestDetectEnvironment in go test and support workflow_dispatch tag in release.yml
- c30a675 fix(map): p5.jsにおけるPromise画像の描画エラーおよび描画ループ停止の不具合を修正
- b715ce9 fix(mqtt): トピック統計テーブルの行が表示されない不具合を修正
- 50ea8df fix(node): ノード詳細および編集ダイアログの型エラーと警告を修正
- 0617c1c fix(notify): align interval and cmd execution with twsnmpfk/fc and prevent browser autofill
- ab8d83a fix(pki): ACMEサーバーとHTTPサーバーのルート登録におけるデータ競合を修正
- cad3b7b fix(pki): ACMEサーバー停止時にポートが解放されない問題を修正
- a03e7cc fix(report): レポート画面のAI診断モーダルにおけるTypeScript型エラーを修正
- 969df4b style(pki): テーブルのセルパディングを調整し、表示を改善
v0.1.0 - Next-Generation Network Management System
TWSNMP NEO v0.1.0
We are proud to announce the first official release of TWSNMP NEO (v0.1.0)!
TWSNMP NEO is the next-generation integrated Network Management System (NMS), combining the capabilities of TWSNMP FC and TWSNMP FK with modern web technologies (Svelte 5 + WebGL/Canvas), Apache Parquet columnar log storage, native AI & Model Context Protocol (MCP) server integration, and an embedded Private PKI certificate authority.
🚀 Key Highlights & Features (English)
1. Modern Web UI & Rich Visualizations
- High-Performance Canvas Map: Node icons (Material Design Icons / custom images), auto-layout, packet-flow animations proportional to traffic, animated line styles, and 11 distinct draw items (KPI cards, sparklines, gauges, shapes, images).
- Interactive 3D Virtual Panel (
vpanel): 3D switching hub rendered via WebGL with realistic RJ45 port textures, Link UP/DOWN LEDs, Gigabit activity LEDs, POWER LEDs, and mouse-driven rotation controls. - Apache ECharts Analytics: Response times, traffic statistics, IPAM heatmap, and time-series log aggregations.
2. Ultra-Fast Columnar Log Storage with Apache Parquet
- High Efficiency: Syslog, SNMP Traps, NetFlow (v5/v9/IPFIX), sFlow v5, ARP Watch, OpenTelemetry, MQTT, and Polling time-series logs stored in columnar Parquet format.
- Scalable Performance: Sub-second queries across tens of thousands of records with multi-criteria filtering and automatic rotation.
3. Native AI & Built-in MCP Server
- Streamable HTTP MCP Server (
/api/mcp): Exposes 22+ operational diagnostic tools and 19 prompt templates to AI agents (Cursor, Claude Desktop, Antigravity, etc.). - Multi-LLM Integration (
tensai): Seamlessly connects to Gemini, OpenAI, Claude, and local Ollama / WebGPU models. - One-Click AI Assist: Event log root-cause analysis, natural-language polling generator, and node health diagnosis.
4. Comprehensive Protocol Receivers & Built-in PKI
- Protocol Receivers: Syslog (UDP/TCP/TLS RFC 3164/5424), SNMP Trap (v1/v2c/v3), NetFlow, sFlow, ARP Watch, OpenTelemetry (OTLP), and MQTT broker.
- Integrated Private PKI: Root CA setup, in-browser CSR generation, certificate issuance, CRL, OCSP, SCEP, and ACME HTTPS server.
- Diagnostic Suite: Real-time ICMP/UDP Ping, Smokeping, MTR traceroute with AI analysis, MIB Browser / Tree, gNMI, and Wake-on-LAN (WOL).
5. Seamless TWSNMP FC Migration
- Integrated CLI flag
-import-fcto effortlessly migrate and compact legacy TWSNMP FC database files and configurations into TWSNMP NEO.
🇯🇵 主な新機能と特徴(日本語)
1. 最新Web技術 & 3D ビジュアライゼーション
- 高速マップキャンバス: ノードアイコン(MDIフォント/カスタム画像)、トラフィック量に応じたパケットアニメーション、11種の描画アイテム(KPIカード、スパークライン、ゲージ等)を搭載。
- 3D 仮想ハードウェアパネル(
vpanel): WebGLによる3Dスイッチングハブ描画。Link UP/DOWN LED、1Gbps+ LED、POWER LED、マウスによる3D回転・自動回転に対応。 - Apache ECharts 分析: レスポンス推移、トラフィック量、IPAMヒートマップ、各種ログの時系列・ヒストグラム分析。
2. Apache Parquet による超高速ログ基盤
- Syslog、SNMP TRAP、NetFlow、sFlow、ARP Watch、OpenTelemetry、MQTT、ポーリング時系列ログを列指向圧縮形式(Parquet)で効率的に保存・高速クエリ。
3. ネイティブ AI & 内蔵 MCP (Model Context Protocol) サーバー
- Streamable HTTP MCP サーバー (
/api/mcp): 22種以上の運用・診断ツールと19種のプロンプトテンプレートをAIエージェント(Cursor、Claude Desktop等)に提供。 - マルチLLMエンジン (
tensai): Gemini, OpenAI, Claude, ローカル Ollama への接続に対応。 - ワンクリック AI アシスト: イベントログの原因分析、自然言語によるポーリング自動生成、ノード健全性診断。
4. 充実したプロトコルレシーバー & 内蔵 PKI
- プロトコルレシーバー: Syslog, SNMP Trap, NetFlow, sFlow, ARP Watch, OpenTelemetry, MQTT
- 内蔵 PKI 認証局: Root CA構築、ブラウザ内CSR作成、証明書発行、CRL / OCSP / SCEP / ACME サーバー
- 診断ツール: リアルタイムPing、Smokeping、MTR(AI解説付き)、MIBブラウザ、gNMI、Wake-on-LAN (WOL)
5. TWSNMP FC からの移行ツール
-import-fcフラグにより、旧 TWSNMP FC の設定・データベースを簡単に移行・最適化可能。
📦 Quick Start / クイックスタート
Docker (Recommended)
docker run -d \
--name twsnmpneo \
--restart unless-stopped \
--net host \
-v $(pwd)/data:/data \
ghcr.io/twsnmp/twsnmpneo:v0.1.0Standalone Binary
Download the binary for your platform from the assets below, extract, and execute:
# Linux / macOS
./twsnmpneo --datadir ./data
# Windows
.\twsnmpneo.exe --datadir .\dataOpen http://localhost:8080 in your web browser. Default credentials: twsnmp / twsnmp.