Skip to content

USAGE.ja.md

Latest commit

 

History

History
139 lines (105 loc) · 12.1 KB

USAGE.ja.md

File metadata and controls

139 lines (105 loc) · 12.1 KB
Raw

English | 简体中文 | 日本語

使用ガイド

main の文書には未リリース機能も含まれます。rustnet --version と rustnet --help で インストール済みバージョンと利用可能なオプションを確認してください。 全オプション、フィルター、無画面モード、エクスポートは詳細ガイド（英語）を参照してください。

基本操作

権限の設定はインストールガイド（英語）を参照してください。 rustnet で起動し、必要なら -i <interface> でキャプチャ対象を指定します。

  • 1～5 または Tab / Shift+Tab：Overview、Details、Activity、Graph、Host の切り替え。
  • /：接続の絞り込み。Enter：選択した接続の詳細。Esc：戻る。
  • h：現在の画面のヘルプ。q：終了。

小さい端末での表示

全体が収まらない場合は v / Shift+v または見出しのクリックでセクションを切り替えます。 Host では常に同じ操作で Sockets、Interfaces、DNS を選択します。 Details では長いセクションのページも切り替え、j / k とマウスホイールで接続を選びます。 端末のサイズ変更や接続の切り替え後も選択中のセクションを保ちます。

Host の Sockets と Interfaces は表が収まらない場合に折り返し表示を使います。 j / k、矢印キー、Page Up/Down、g / G、ホイールでスクロールできます。 小さい Overview では Esc で System から Connections に戻り、広い端末では i で System サイドバーを切り替えます。各画面の操作は h で確認できます。

転送グラフ

Graph は選択したキャプチャ対象のカウンターを使います。any と macOS 標準の pktap は 全インターフェースの合計で、同じ通信を複数回数える場合があります。 カウンターが取得できない間は RX/TX グラフを停止し、サンプルの取得後に再開します。

Graph と Details は観測したバーストを保持し、RX/TX 別の自動線形目盛りを使います。 単位はバイト/秒（KiB/MiB/GiB は二進単位）なので、方向間の比較は数値で行ってください。 余裕があれば現在値、期間内のピーク、2s avg を表示します。0 B/s は観測したアイドル状態、 プレースホルダーはデータなしを示します。Details と Top Processes は平滑化した接続速度、 Graph はインターフェース速度を使います。

Activity は s で 2s Avg TX/RX 順、d で TX/RX を選択します。 割合の棒は直近 60 秒が対象で、仮想/VPN インターフェースの割合は重複する場合があります。 Overview のフィルターと履歴切り替えは Activity を制限しません。DNS 解決が有効な場合、 両画面とも --show-ptr-lookups を指定しない限り PTR 通信を非表示にします。

Host とネットワークイベント

Host > Sockets は OS の TCP 状態、UDP バインド、待受端点と所属プロセスを表示し、 5 秒ごとに更新します。パケットを観測していないソケットも表示します。 Linux ではサンドボックス適用後も、同一ソケットの起動時の所属情報を保持します。 共有ソケット、終了したプロセス、識別情報の変化、権限不足では所属不明になる場合があり、 新規ソケットの所属取得には引き続き procfs へのアクセスが必要です。

観測したネットワークイベント（未リリース）

Host > Sockets は TCP リセットと ICMPv4/v6 エラーの送信/受信数を表示します。 対象は到達不能、禁止、パケット過大/フラグメント化要求、時間超過、パラメーター異常です。 起動またはクリア以降の捕獲した通信を集計し、表示フィルターや接続保持期間には依存しません。 ファイアウォール判定や OS 全体のカウンターではなく、MTU や traceroute の応答は正常な場合もあります。

Details > Health は件数と最新エラーのタイプ/コード、報告元、方向、経過時間、取得できた通知 MTU を表示します。 引用された端点で TCP/UDP 接続に対応付け、接続状態や通信量は変更しません。 不完全な引用、フラグメント、IPv6 拡張、NAT、接続の不在や再利用で対応付け不能・誤対応になる場合があります。 未対応のエラーも Host で集計し、個別のエラーレコードは保持しません。

--json-log の受信 new_connection には local_port_status も含まれます（未リリース）。 キャッシュ内の TCP 待受/UDP バインドに一致すれば opened、観測されなければ closed、 取得・更新失敗や曖昧なワイルドカードは unknown です。既知の TCP 握手方向を優先し、 不明なら最初のパケットの方向を使います。5 秒の更新間隔と OS の可視範囲に制限され、ファイアウォール判定ではありません。

開発版： TCP/UDP 接続は、プロセス終了やソケットの情報に基づいて早く終了できます。 Details の Exit Cleanup に状態を表示します。共有ソケットや情報不足では通常の タイムアウトを使います。macOS は root の可視範囲、FreeBSD はさらに jail 外での実行が必要です。

Host の期間選択（開発版）

Host の各セクションで w を押すと 60s / 5m / 1h / since startup を切り替えます。Sockets、Interfaces、DNS で選択を共有し、ソケット一覧とインターフェース速度は引き続き現在値を表示します。

  • ネットワークイベント： 送受信件数は選択期間と Rustnet の起動またはクリア以降の累積値を並べて表示します。選択期間内がゼロでも累積値のある種類を表示します。
  • インターフェース： エラー、ドロップ、衝突は 選択期間/OS 累積値 と表示します。初回サンプル後に観測した増分のみを期間内に集計し、既存の OS エラーは新しいエラーに含めません。OS 累積値とパケット総数を保持し、強調表示は選択期間に従います。
  • x は Rustnet の履歴と累積件数をクリアし、セッション表示を since clear に変更します。クリア後の次のポーリングで新しい基準値を設定し、クリア前に採取したサンプルは無視します。OS 累積値は変更しません。OS カウンターの減少はリセットとして扱います。消えたインターフェースの履歴は削除し、再出現時は基準値を設定し直します。

イベントとインターフェース履歴は有界の 1 秒バケットを使い、期間の境界付近では最大 1 秒長く表示されることがあります。インターフェース増分は観測したポーリング時刻に集計するため、ポーリング間隔内の正確な発生時刻は不明です。起動以降の表示は実際に観測したデータが対象で、途中から現れたインターフェースも含みます。

DNS 診断（未リリース）

Host > DNS は既定で直近 60 秒の単播 UDP DNS を解析器ごとに表示します。 w で 60 秒、5 分間、1 時間、起動以降を順に切り替えます。結果、遅延、解析器、問い合わせ名は選択した期間を使います。 Overview の健康状態は常に 60 秒です。切り替えてもデータは消去されません。 3 つのローリング期間では完了した最大 8,192 件と待機中の最大 4,096 件を共有し、容量による欠落は sampled と表示します。 大量の問い合わせでは 選択した期間の詳細をすべて保持できない場合があります。捕獲中のデータだけが対象です。 解析器の状態、失敗数/完了数、待機中（wait）、再送（retry）、最も古い待機時間または p95 を確認できます。 問題のある解析器を先に表示し、高さに応じて 2～3 行と省略数を表示します。 一部の解析器が degraded、failing、no replies の場合、全体が responsive でも degraded に変更し、 正常なサーバーの大量の応答で障害が隠れないようにします。NXDOMAIN は正常な否定応答です。

起動以降は追跡した全取引の累積件数を保持し、ローリング明細が期限切れや容量制限で消えても失われません。 累積明細は最初の 128 解析器と 1,024 問い合わせ名/種類の組み合わせに制限します。 details limited は追加明細の省略を示し、総計は継続します。セッション全体の p50/p95 と各明細の p95 は 有界ヒストグラムによる推定値で、~ を付けます。追跡した取引の件数、最大遅延、4 つの遅延区間は正確で、 健康状態も正確な遅延しきい値の件数から判定します。sampled は追跡制限による欠落を示します。 x で累積値を消去すると since clear と表示します。これは履歴であり、Overview の健康状態は直近 60 秒のままです。

タイムアウト、SERVFAIL、REFUSED、その他のエラー、500 ms 以上の遅い応答を最大 64 件、15 分間保持します。 最近の問題は解析器と原因でまとめ、保持件数、最後の観測からの経過時間、最新の問い合わせ名を表示します。 見出しに表示中のグループ数を示します。60 秒の集計から消えても履歴は残り、障害の継続を意味しません。 x で集計と履歴を消去します。再送は同じ問い合わせとして 10 秒の無応答タイマーを更新しますが、 分析の待機時間と応答時間は最初の観測から測定し、再試行の遅延を含みます。

Linux では sudo rustnet -i any --no-resolve-dns でネットワークインターフェースとループバックの両方を観測できます。 127.0.0.53:53 は一般に systemd-resolved のローカルスタブです。 127.0.0.1:53 と [::1]:53 も対応します。物理インターフェースだけではスタブ通信が見えません。 スタブと上流の通信は別々に数えられるため、合計はアプリケーションの問い合わせ数と一致しません。 systemd-resolved 利用時の設定は resolvectl status で確認できます。RustNet は観測した端点だけを表示し、 設定変更や能動的な探査は行いません。

応答が見えない場合は捕獲範囲、Host > Sockets の ICMP エラー、Host > Interfaces のエラーやドロップも確認してください。 捕獲停止時の状態は unknown です。TCP フォールバック、暗号化 DNS、キャッシュ、/etc/hosts、 DNS パケットを出さない NSS/D-Bus 呼び出しの成功は判断できません。 macOS もキャッシュや mDNSResponder によりアプリケーションの特定が制限されますが、 観測できた単播 UDP DNS の解析器別の証拠は表示します。

表示設定

設定ファイルは ~/.config/rustnet/config.toml（XDG_CONFIG_HOME 指定時はその配下）、 Windows は %APPDATA%\rustnet\config.toml です。以下はどちらも任意で、既定値は false です。

[ui]
popup_shadow = true

[view]
group_by_process = true

popup_shadow はヘルプの影を有効にします。NO_COLOR または --no-color で無効になります。 group_by_process は Overview を折りたたんだプロセス別グループで開始します。 a で一時的に切り替え、Space で展開し、r で設定値に戻します。無画面出力には影響しません。