NetPulse と Home Assistant

得られるもの

自宅のエンティティのひとつになるネットワーク

NetPulse はネットワークの状態を、Home Assistant 用にすでに運用している MQTT ブローカーに書き込みます。そこからルーターとそのメトリクスは、照明や温度センサーと同じように、ダッシュボードや自動化、アラートで利用できます。

全体の健全性（スコアとラベル）、オンライン／合計クライアント数、オンライン／合計ルーター数、未読アラートを持つ1つのデバイス。

ルーターごとに1つのデバイスで、オンライン状態、健全性、CPU、メモリ、温度、クライアント数を表示。インストールにリンクされ、パネル内でグループ化されます。

すべてのアラートは発火した瞬間にイベントとして公開されます（温度、WAN ダウン、新規デバイス...）。あとは好きな自動化に変換するだけです。

NetPulse は書き込むだけで、聞きません。つまりパブリッシャーです。Home Assistant からはネットワークを読むことができます。ルーターを操作するには、NetGrip（そのパネル）を使います。NetGrip も MQTT を話し、コマンドを受け付けます。

はじめかた

初期状態では無効です。有効にするまで NetPulse は何も公開しません。設定は環境変数（オンボックスモードでは UCI オプション）で行います。

NETPULSE_MQTT_ENABLED=1
NETPULSE_MQTT_HOST=10.0.0.10
NETPULSE_MQTT_USER=netpulse
NETPULSE_MQTT_PASS=...
NETPULSE_MQTT_INSTANCE=casa

最初の状態が公開されるまで、最大で1インターバルかかります。

エンティティ

インストール用に1つ、ルーターごとに1つ、最初のデバイスにぶら下がります。自動作成されるエンティティは次のとおりです：

デバイス	エンティティ	種類	単位
NetPulse <instancia>	Health score	センサー
	Clients online	センサー
	Routers online	センサー
	Unread alerts	センサー
	NetPulse version	センサー（診断）
各ルーター	Online	バイナリ（接続性）
	Health	センサー
	CPU usage	センサー	%
	Memory usage	センサー	%
	Temperature	センサー	°C
	Clients	センサー（診断）

ルーターで NetGrip が MQTT を有効にして動いている場合、Home Assistant に公開するのは NetGrip で、NetPulse は公開しません。ルーターごとに見えるデバイスは1つだけです。

Home Assistant 内のルーターデバイス。エンティティはディスカバリーによって作成されます。

さらに: NetGrip

NetPulse は公開するだけですが、NetGrip（そのパネル）を動かすルーターは MQTT 経由でコマンドも受け付けます。NetGrip を有効にすると、Home Assistant はルーターを見るだけでなく、操作できます。

アクション	コマンドトピック	値
ゲスト Wi-Fi	`netgrip/<router>/command/guest_wifi`	ON / OFF
banIP	`netgrip/<router>/command/banip`	ON / OFF / RELOAD
IPv6	`netgrip/<router>/command/ipv6`	ON / OFF
SQM	`netgrip/<router>/command/sqm`	ON / OFF
再起動	`netgrip/<router>/command/reboot`	PRESS

各ルーターは結果を netgrip/<router>/result に返します。さらに独自の17個のセンサーを公開します：バンドごとのクライアント数、WiFi 信号の最小値と平均、ローカルネットワークのトラフィック。

ローカルネットワークのトラフィックとインストールの健全性を表示する Home Assistant ダッシュボード。

NetPulse をインストールし、インスタンスをブローカーに向ければ、1分でネットワークが Home Assistant の中に入ります。