TWSNMP NEO

Next-generation container-native network manager

View on GitHub
English (英語版はこちら) ライフサイクル(リリース・導入・自動更新) MCP仕様 AIプロンプト

はじめてのTWSNMP NEO

次世代コンテナネイティブ・Webベース ネットワーク管理システム


1. はじめに

TWSNMP NEO は、長年にわたり日本のネットワーク管理で親しまれてきた TWSNMP シリーズの最新進化版です。 コンテナ版 TWSNMP FC のポータビリティと、デスクトップ版 TWSNMP FK の高度な可視化・AI連携機能を完全に統合し、最新の Web 標準(Go 1.27+ / Svelte 5 / TypeScript)で再構築されました。

主な特徴


2. インストールと起動

TWSNMP NEO は、Docker コンテナ、Homebrew、Windows サービス、単一実行バイナリとして多様な環境で動作します。

📖 詳細ガイド: 各プラットフォームごとの詳細なセットアップ手順や自動更新の仕組みについては ライフサイクルガイド(リリース・導入・自動更新) をご覧ください。

Docker による起動(推奨)

最も簡単な起動方法は 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

起動後、ブラウザで http://<ホストのIP>:8080 にアクセスします。

Docker Compose による起動

docker-compose.yml を作成して管理することも可能です:

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
docker compose up -d

Homebrew (macOS / Linux)

macOS や Linuxbrew では Homebrew Tap より手軽に導入可能です:

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

Windows (スタンドアロン & Windows サービス常駐)

GitHub Releases より twsnmpneo_windows_amd64.zip をダウンロード・展開し、管理者権限のコマンドプロンプトや PowerShell から Windows サービスとして登録・常駐化できます:

# サービス登録(OS起動時に自動起動)
.\twsnmpneo.exe service install -service-auto -datastore C:\twsnmpneo\data -port 8080

# サービス開始
.\twsnmpneo.exe service start

Linux (curl インストーラー & systemd サービス常駐)

# curl ワンライナーインストール
curl -sS https://raw.githubusercontent.com/twsnmp/twsnmpneo/main/install/install.sh | sh

# 特権ポート (514/162) & Rawソケット (Ping) 許可
sudo setcap 'cap_net_bind_service,cap_net_raw+ep' /usr/local/bin/twsnmpneo

# 一般プロセスとして直接起動
twsnmpneo -datastore ./data -port 8080

# または Linux systemd サービスとして登録(OS起動時に自動起動)
sudo twsnmpneo service install -auto -datastore /var/lib/twsnmpneo -port 8080
sudo twsnmpneo service start

スマート自動更新 (Self-Updater)

動作環境を自動検出し、CLI や Web UI から安全に自己更新を実行できます:

# 更新チェック
twsnmpneo update -check

# 最新バージョンへ即時更新 & プロセス自動再起動
twsnmpneo update -y

3. 画面構成と基本操作

TWSNMP NEO は直感的なシングルページアプリケーション(SPA)です。


4. マップ画面

ノードとネットワーク(SW-HUB ポートパネル)

ネットワーク(SW-HUB)を右クリックすると専用メニューが開き、情報確認、PING、MIBブラウザー、接続先トポロジー探索、ネットワーク自体の編集、および接続ポートの「ライン編集」を直接実行できます:

登録されているスイッチングハブやネットワークは専用のインベントリ一覧でも管理できます:

ライン接続とトラフィックフロー

ノード間や SW-HUB ポート間の接続線をドラッグまたは Shift+クリックで結びます。ポーリングと連動して、送受信トラフィック量に応じた線の太さやパケットフローアニメーションが動的に変化します。

ライン一覧画面では、接続元・接続先、線幅、検出理由(LLDP/FDB-Edge等)、接続健全性をテーブル形式で確認・編集できます:

描画アイテム(全11種類)

マップ上には監視対象機器だけでなく、自由なレイアウト要素(描画アイテム)を配置できます:

  1. 矩形 / 楕円: エリアのグループ化やゾーン分け
  2. テキスト / ラベル: ネットワーク名や説明文
  3. 静的画像: フロアマップやラック図
  4. クラシックゲージ: アナログ風の針メーター
  5. 円形ラジアルゲージ: CPU/メモリ使用率等のドーナツ表示
  6. 横棒グラフ: ストレージ残量や帯域利用率
  7. 折れ線スパークライン: トラフィックやレスポンス推移
  8. リアルタイム KPI カード: ポーリング値(温度、Ping応答時間、パケット数)の巨大数値表示

配置したすべての描画アイテムは、描画アイテム一覧テーブルでも一元管理・編集できます:

3D 仮想ハードウェアパネル(vpanel)

スイッチやルーターのノードを右クリックして「仮想パネル」を開くと、WebGL による 3D 筐体が表示されます。

マップキャンバスメニューと自動レイアウト

マップの余白(背景)を右クリックすると、キャンバス操作メニューが開きます:

マップ設定と背景画像

マップ設定からマップの全体外観を細かくカスタマイズできます:

位置情報マップ(GIS / MapLibre)

MapLibre GL を採用し、ノードの緯度・経度情報をもとに実際の地理空間上にノードを配置・監視できる本格的な GIS マップビューを提供します。拠点間ネットワークや物理拠点の配置状況を一目で把握できます。


5. 自動発見とトポロジー探索

IPレンジ自動発見

指定したサブネット(例: 192.168.1.1/24)に対して、高速に Ping/SNMP/ARP スキャンを実行し、稼働中のデバイスを自動的にマップ上に登録します。

実行中はプログレスバーとともに、検出されたポート・サービス種別(SNMP、Web、SSH、Mail、File、RDP、LDAP)の内訳がリアルタイムに表示されます:

接続先トポロジー探索(Find Neighbor)

スイッチの ARP テーブル、FDB (MACアドレス学習テーブル)、LLDP / CDP 情報を自動解析し、どのノードが SW-HUB のどのポートに接続されているかを自動判定して結線を生成します。 ワイドなダイアログにより折り返しを解消し、判定理由(LLDP、FDB-Edge、ARP等)と判定確信度(%)がひと目で把握できます:


6. ノード & ポーリング管理

ノードリストとノード詳細

監視対象ノードの一覧、IP/MACアドレス、ベンダー情報、稼働状態をインベントリリストでリアルタイムに検索・管理できます:

ノードを右クリックして「情報」を選択すると、ホストリソースやシステム稼働状況に加え、そのノードに設定されているポーリング一覧が直接確認できます。一覧から各ポーリングの履歴チャートや編集へダイレクトにアクセスでき、上部ボタンからノードプロパティの即時編集も可能です。

また、右上の「AIノード総合診断」ボタンを押すと、ノードの稼働状態や各種ポーリングの警告内容を LLM が自動的に読み解き、原因と推奨対処アクションを Markdown 形式で分かりやすく提示します(日英言語切替対応):

ノードプロパティ編集(2カラム & 共通認証対応)

ノードの編集画面は、見通しの良いワイドな2カラムレイアウトに刷新されています:

多彩なポーリングプロトコル

TWSNMP NEO は以下のプロトコル・方式による死活・性能監視に対応しています:

システム設定内のポーリング設定画面から、標準ポーリング間隔、タイムアウト、リトライ回数、デフォルトSNMPモード、コミュニティ名などの全体デフォルト値を設定できます:

AIポーリング設定アシスタント

自然言語(日本語)で「WebサーバーのCPU使用率が80%を超えたら警告にするポーリングを作って」と入力するだけで、LLM が適切な SNMP OID や閾値判定スクリプトを自動生成する機能です。(※現在は実験的機能として準備中)


7. 診断・運用ツール

Ping / Smokeping / MTR

MIBブラウザ & MIBツリー

標準 MIB (RFC1213, Host Resources, IF-MIB 等) およびベンダー拡張 MIB のツリーを探索できます。 SNMP Get / GetNext / Walk / Table 取得をワンクリックで実行し、表形式データのソートや CSV エクスポートが可能です。

gNMI ツール

次世代ネットワーク機器(gRPC Network Management Interface)の Telemetry 取得や Config 参照を行えます。テーブル列幅のドラッグ調整、リアルタイムインライン検索、10〜100件のページネーション、およびキーボードショートカット(EnterでGet実行、Escapeで閉じる)に対応しています。

Wake-on-LAN (WOL)

マップ上のノード右クリックメニュー、またはノード詳細画面の上部にある「WOL」ボタンから実行できます。 対象ノードの MAC アドレスに対して Magic Packet を送信し、リモートから端末の電源投入(起動)を行います。


8. 分析 & レポートスイート

10系統の強力な分析エンジンを搭載しています:

デバイス分析(LAN / Wi-Fi / Bluetooth / FDB)

MAC OUI ベンダー分析、電波強度、新規接続機器の検出。

IPAM(IPアドレス管理ヒートマップ)

サブネットごとの空き状況・使用率ヒートマップ、IP競合の検出。

フロー & トラフィック(NetFlow / sFlow / Fumble)

Topトーカー、Topプロトコル、スキャンや未応答SYN(Fumble)等の異常通信分析。

ホスト分析(Windowsイベント / プロセス等)

Windowsイベントログオン監査、特権昇格、プロセス・サービス稼働分析。

IoT & センサー(環境センサー / 電力)

温度・湿度・気圧・電力(Wh)の推移グラフと閾値監視。

MQTT レポート

IoT/スマートデバイス向け MQTT のトピック別メッセージ頻度・サイズ統計、クライアント接続状況の集計および AI による傾向分析。

OpenTelemetry (OTel) レポート

分散トレーシングや OTel メトリクスのサービス別集計、レイテンシ傾向、および AI によるボトルネック分析。上部アクションバーから再読み込みや一括削除が行えるほか、メトリック一覧やトレース一覧から対象ノード(IP/ホスト名自動照合)へのワンクリックポーリング作成に対応し、OTel APM 監視体制を即座に構築できます。

TWAgent & AI セキュリティ監査 (twagentneo)

クロスプラットフォーム監視エージェント twagentneo からのテレメトリ、アラート、FIM、SCA 情報を事前設定なしで自動集約し、5つのタブで詳細に分析・監査します:

セキュリティ & 証明書監視

TLS/SSL 証明書の有効期限残日数追跡、失効(CRL/OCSP)状態チェック。

AI 異常検知スコア

各ノード・ポーリングの統計的異常スコアランキング。

各種レポートでのワンクリック「AI診断」

各レポート画面(Syslog、TRAP、NetFlow、IP、ARP、Sensor、MQTT、OTel 等)のツールバーにある「AI診断」ボタンをクリックすると、現在の集計・統計データを AI が即座に読み込み、ボトルネックや異常兆候の分析結果、推奨される対処手順を Markdown 形式で分かりやすく提示します。


9. 高速ログ管理 (Apache Parquet)

TWSNMP NEO は、ログストレージに Apache Parquet 列指向圧縮フォーマットを採用しています。 従来の数倍の圧縮率と、1万件を瞬時に取得する圧倒的な検索速度を実現しています。

対応ログ一覧

レシーバー & デーモン設定

各ログ・パケット受信デーモン(Syslog UDP/TCP:514、SNMP TRAP UDP:162、NetFlow UDP:2055、sFlow UDP:6343、ARP Watch 監視CIDR範囲、OpenTelemetry OTLP gRPC/HTTP:4318、MQTT ブローカー)の有効化・待受ポートは、システム設定内の「レシーバー & デーモン設定」から個別に制御できます。 設定変更時はアプリケーション全体を再起動することなく、対象レシーバーのみを安全に動的リロードします。また、SNMPv3 TRAP の暗号化デコードおよび MIB OID 名前解決にも標準対応しています。

独立したログ保持期間ポリシー & Parquet コンパクション

データベース内のイベントログ(bbolt)と大量の受信ストリーミングログ(Parquet)は、それぞれ独立した保持日数を設定できます。10分ごとのバックグラウンドクリーンアップ処理により、期限切れのイベントログ削除とParquetログファイルの自動ローテーション(日数および最大容量制限)が確実に実行されます。 さらに、bbolt のインメモリキャッシュ(sync.Map)と遅延フラッシュ、タイムスタンプ範囲によるログ検索の高速化、および断片化した Parquet ファイルを自動結合・最適化するコンパクション(Compact)により、長期間の運用でも安定した高速パフォーマンスを維持します。

プローブタグ自動解析 & DNS 逆引きキャッシュ

各種 Syslog プローブ(twpcap, twWifiScan, twBlueScan, twwinlog, twagentneo 等)から送信されたログにおいて、リレーやヘッダ構成によりタグがホスト名やメッセージ本文に混在した場合でも、自動的にプローブタグを検知して type= のKey-Valueを正規化パースします。また、レポート集計時にマップ未登録のIPアドレスについて DNS 逆引き(Reverse Lookup)を行い、TTL 1時間のキャッシュにより高速かつ低負荷にホスト名を自動解決・表示します。

AI原因調査

重大アラートが発生した際、ワンクリックで関連する前後ログを LLM が瞬時に要約・分析し、推定原因と推奨対処手順を Markdown 形式で分かりやすく提示します。


10. 内蔵 PKI (認証局) & TLS 管理

TWSNMP NEO は、外部の証明書管理ツールなしで動作する完全なプライベート PKI 機能を内蔵しています。Webサーバー版(TWSNMP FC)互換の堅牢なアーキテクチャを採用し、左側サイドバーによる直感的な操作が可能です。

Root CA 構築 & 証明書管理

画面から安全に秘密鍵と Root CA 証明書を生成し初期化(RSA / ECDSA 各種鍵長に対応)。発行済み証明書の一覧表示、失効証明書数の把握、横断キーワード検索、カラムソート、ページネーション、CSVエクスポート、PEM証明書の個別ダウンロードおよび失効操作に対応しています。

ブラウザ内 CSR 作成

秘密鍵と CSR を同時に生成し、ZIP形式でまとめて即時ダウンロード。また、アップロードした CSR ファイルに対して CA による署名を行い、PEM 形式の証明書を発行・ダウンロードできます。

CRL / OCSP / SCEP / ACME サーバー運用

ACME 自動更新クライアント & サーバー証明書

TWSNMP NEO 自体の Web UI を HTTPS (TLS) で運用する際、Let’s Encrypt などのパブリック ACME サーバーや内蔵 ACME サーバーから証明書を自動取得・自動更新する ACME クライアント機能(lego 統合)を搭載。既存の PEM 証明書・秘密鍵ファイルの指定や、TWSNMP FC からの証明書インポートにも対応しています。


11. AI & MCP 統合

LLM 設定(ローカル LLM / 各種クラウド AI)

設定メニューからお好みの AI プロバイダー(ローカル LLM tensai、Gemini、OpenAI、Claude、Ollama 等)を柔軟に選択できます。

ローカル LLM & WebGPU アクセラレーション

外部クラウドへの通信や API キー不要で、完全オフラインで動作する組み込み推論エンジン(tensai v0.0.35+)を搭載。Hugging Face からのワンクリックモデルダウンロードや WebGPU による高速推論に対応しています。診断結果はリッチな Markdown 表示、言語切替、スムーズなローディングアニメーションを備えています。 また、外部/ローカル LLM へのリクエストタイムアウトは 15 分に拡張され、Ollama を経由した DeepSeek-R1 や Qwen などの思考モデル(Thinking models)による深い分析出力の自動パースにも標準対応しています。

内蔵 MCP サーバー

Streamable HTTP (/api/mcp) による Model Context Protocol サーバーを標準搭載。42種の運用・診断ツール(ノード/ライン/ポーリング CRUD、即時チェック、Ping/SNMP/MIB、NetFlow/Syslog/TRAP/イベント検索、AI異常スコア、OTel APMメトリクス/トレース、各種レポート、センサー種別フィルタ等)と31種のプロンプトテンプレートを公開しています。Cursor、Claude Desktop、Antigravity などの AI エージェントから TWSNMP NEO に直接接続し、ネットワーク情報の問い合わせ、監視設定の管理、障害診断を自律的に実行させる連携が可能です。

詳細な構想やツール一覧は、MCP サーバー仕様・連携ガイド および AI プロンプトガイド をご覧ください。


12. 公開ダッシュボード (Public Dashboard)

TWSNMP NEO は、ログイン不要で外部共有できる安全な「公開ダッシュボード」機能を搭載しています。社内ポータルやサイネージ、監視ルームの大画面ディスプレイへの投影に最適です。

主な特徴と機能


13. 設定 & システム管理

システム状態 & リソースモニター(2タブ構成)

システム管理画面は、目的に応じて整理された 2 つのタブで構成されています:

公開ダッシュボード設定

システム設定内の「ダッシュボード」タブから、公開ダッシュボードの全体有効化、アクセスキーの再生成、公開対象アイテム(マップ・ポーリング)の追加・編集・並べ替え、表示タイトル、ローテーション間隔、緊急警報(Drama Alert)条件、およびワンクリックでの URL / iframe 埋め込みタグのコピーが行えます:

通知設定(Email / Webhook)

障害検知時や定期レポートの送信先として、以下の通知方式に対応しています:

データベース設定 & 定期バックアップ

バックアップ管理 & 復元運用

システムステータス画面の「バックアップ管理」ボタンから、専用モーダルを開いてバックアップアーカイブの統合管理が行えます。

アイコン管理

標準の Material Design Icons(MDI)に加えて、オリジナルの PNG/JPEG/SVG 画像アイコンの追加・インポート/エクスポートが可能です。

ユーザー管理 & アクセス権限

役割ベースの権限(ADMINISTRATOR / OPERATOR / READ-ONLY)によるマルチユーザー管理と、安全なパスワード設定・運用に対応しています。

URL パラメータによる自動ログイン & クリーンアップ (twsnmpmw 連携)

外部ポータルやマルチウィンドウ管理ツール twsnmpmw 等からのシングルサインオン・直接画面遷移に対応しています:


まとめ

TWSNMP NEO により、軽量・高速でありながら、3D 可視化・大容量ログ分析・AI 支援を兼ね備えた最新のネットワーク運用が手軽にスタートできます。 ぜひ Docker やバイナリでお試しください。