Agent skill · data analytics · affaan-m
network-interface-health
ルーター、スイッチ、Linuxホスト上のインターフェースエラー、ドロップ、CRC、デュプレックス不一致、フラッピング、速度ネゴシエーション問題、カウンタートレンドを診断する。
Why this skill is useful
Provides specific commands and diagnostic procedures for troubleshooting network interface issues that the AI wouldn't reliably generate on its own.
What it needs
About 1k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
ネットワークインターフェースヘルス ネットワークの症状が物理リンク、スイッチポート、ケーブル、トランシーバー、デュプレックス設定、または輻輳したインターフェースによって引き起こされている可能性がある場合にこのスキルを使用する。 使用するタイミング ホストまたはVLANにパケットロス、レイテンシスパイク、または断続的な到達不能がある。 スイッチまたはルーターのインターフェースにCRC、ランツ、ジャイアント、ドロップ、リセット、またはフラップが表示されている。 ハードウェアを交換する前にリンクの両端を比較する必要がある。 変更ウィンドウでインターフェースカウンターの前後の証拠が必要。 監視がifInErrors、ifOutErrors、またはifOutDiscardsの増加を報告している。 仕組み インターフェースカウンターは証拠だが、絶対値よりもトレンドの方が重要である。ベースラインを取得し、測定間隔を待ち、再度取得してから増分を比較する。 Linuxホストの場合: カウンターリファレンス カウンター 意味 一般的な原因 --- --- --- CRC 受信フレームのチェックサムが失敗 不良ケーブル、汚れたファイバー、不良オプティック、デュプレックス不一致 input errors 受信側エラーの集計 結論を出す前にサブカウンターを確認 runts 最小イーサネットサイズ未満のフレーム デュプレックス不一致、コリジョンドメイン、不良NIC giants 期待されるMTUより大きいフレーム MTU不一致またはジャンボフレーム境界 input drops デバイスがインバウンドパケットを受け入れられなかった バースト、オーバーサブスクリプション、CPUパス、キュー圧迫 output drops 送信キューがパケットを廃棄した 輻輳、QoSポリシー、サイズ不足のアップリンク resets インターフェースハードウェアリセット フラッピング、キープアライブ、ドライバー、オプティック、電源 collisions イーサネットコリジョンカウンター ハーフデュプレックスまたはネゴシエーション不一致 診断フロー CRCまたは入力エラー 1. カウンターが増加していることを確認する（歴史的なものだけでなく）。 2. リンクの両端を確認する。受信側エラーは通常、エラーを報告しているポートではなく、その側に到着する信号を指す。 3. パッチケーブルを交換するか、ファイバーとオプティクスを清掃/交換する。 4. 両側で速度/デュプレックス設定が一致していることを確認する。 5. 同じタイムスタンプ前後のフラップイベントのログを確認する。 ドロップ 1. 入力ドロップと出力ドロップを分離する。 2. インターフェースレートを容量と比較する。 3. QoSポリシー、キューカウンター、リンクがオーバーサブスクリプションのアップリンクかどうかを確認する。 4. キューチューニングは二次的な処置として扱う。まずリンクが輻輳しているかどうかを証明する。 デュプレックスと速度 両側がサポートしている場合、最新のイーサネットリンクではオートネゴシエーションを優先する。一方の側を固定する必要がある場合は、両側を明示的に設定し、理由を文書化する。一方をfixed speed/duplexに設定し、もう一方をautoにすることは絶対にしてはならない。 安全なパーサーの例 各インターフェースブロックを1つのヘッダーから次のヘッダーまでスライスする。任意の文字ウィンドウを使用しないこと。大きなインターフェースブロックはカウンターが欠落したり、誤ったポートに割り当てられたりする可能性がある。 例 1つのスイッチポートのCRC 1. ローカルポートのカウンターを取得する。 2. 接続されたリモートポートのカウンターを取得する。 3. ルーティングやファイアウォールルールを変更する前にケーブルまたはオプティクスを交換する。 4. ベースラインを記録した後にのみカウンターをクリアする。 5. 一定間隔後に再確認する。 インターネットは遅いがLANは正常 1. WANインターフェースのドロップ/エラーを確認する。 2. LANアップリンクの利用率と出力ドロップを確認する。 3. WANリンクがクリーンでもスループットが低い場合はゲートウェイCPUを確認する。 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/network-interface-health--cf79d5