Link Health
os-linkhealth · アプライアンスのハードウェア
すべての物理ポートを監視し、劣化しているケーブルやトランシーバを筐体に印刷されたラベルで示します。
メニューの場所
- os-xgs-npu をインストールした場合: XGS: Link Health
- os-xgs-npu がない場合: Interfaces: Link Health
判定は光学的な測定値ではなく、ウィンドウ期間内のポートのハードウェアエラーカウンタの変化から行います。このプラグインは、リンクがアップと表示され、トランシーバの測定値もすべて正常なまま、10G ファイバーが受信フレームの 3.81% を破損させた件をきっかけに書かれました。
ポートの状態は down、disabled、idle、ok、watch、warn、fail のいずれかです。静かなポートは判定に十分なフレームを運ぶまで idle（良くも悪くもない）のままで、リンクのないポートがアラートになることはありません。
ポートには筐体に印刷された名前が付きます。os-xgs-npu のある Sophos XGS アプライアンスでは、コプロセッサのポートと装着された拡張モジュールが起動時に命名されます。表は XGS の 35 ボードと 14 の FleXi モジュールを含み、XGS 3300、XGS 136、XG 330 はソケットごとに確認済みです。
機能
-
ポートごとの判定
ウィンドウ内の 100 万フレームあたりのエラーフレーム数、ポートが広告する最高速度より低い速度へのダウンシフト、全二重リンクでのコリジョン、1 時間あたりのリンクフラップ。
-
描画された前面パネル
レイアウトから描いたアプライアンスの前面で、各ソケットは判定の色で表示されます。実機と照合されていないレイアウトは、ページにそう表示されます。
-
識別
リンクを切らずにソケット自身の LED を点滅させ（既定 30 秒）、印刷されたラベルとインターフェース名を結び付けます。Sophos XGS アプライアンスではコプロセッサ自身のツールが点滅させます。
-
負荷テスト
判定するには静かすぎるポート向けに、そのポートのブリッジテーブルにすでにある隣接機器へ上限付きの ICMP トラフィックを送り、カウンタを比較します。実行中はリンクを埋め尽くします。
-
メールは一度だけ
warn と fail は 2 ウィンドウ後にメールされ、ポートごとにクールダウン（既定 6 時間）あたり 1 回、ポートが悪化したときは即座に、回復したときにも再度送られます。送信には OPNsense が Monit 用に持つメール設定を使います。
-
トランシーバのデータ
ドライバが提供する場合は、種類、ベンダー、部品番号とシリアル番号、温度、電圧、受信パワー。参考の理由であり、判定には使いません。
インストールと更新
Sophos XGS アプライアンスでは xgs-image-builder のイメージに含まれ、初回起動後に有効になっています。新しいリリースは XGS: Updates の Plugins タブから手動でインストールします。自動では何も更新されません。それ以外の環境では、リリースに添付されたパッケージ、またはファイアウォール上で tools/make-package.sh でビルドしたパッケージを pkg add でインストールします。install/install.sh はパッケージなしで同じことを行います。その後 Interfaces: Link Health、os-xgs-npu がインストールされていれば XGS: Link Health を開き、2 分待ってください。最初の実行はベースラインを記録するだけです。
制限と、まだテストされていないこと
- しきい値はすべて igb と ix ポートを持つ 1 台のアプライアンスから得たものです。その他のドライバのカウンタ対応表はドライバのソースから書かれ、実機では動かしていません。
- 識別は基準機の igb と ix ポートでテストしました。その他のドライバはテストしておらず、ボタンが表示されない場合があります。
- ベンダーのファイルから生成したボードの項目は未検証と記されています。ソケットごとに確認したのは XGS 3300、XGS 136、XG 330 だけです。
- ケーブル長や障害までの距離、対向側の測定値、em・igb・igc ポートでのトランシーバのデータは得られません。
リポジトリ
最初のリリース: 2026-10-16