HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: Procinsh – Linuxプロセスを3Dでインスペクトするツール

Show HN: Procinsh – A 3D Linux process inspector (github.com)

31 pointsby a_kawashiro6 コメント

要約

Procinshは、Linuxのプロセスをシェル上で3D表示するWebベースのインスペクターです。Rustで開発されており、プロセスの階層や詳細情報を視覚的に探索できます。インストールにはRustやBPF関連のツールが必要ですが、ソースからのビルドが推奨されています。

全文翻訳

ProcInSh - プロセスをシェルで

ProcInSh(「プロック・イン・シェル」と発音)は、Linux向けのWebベースのプロセスインスペクターです。「Ghost in the Shell」のように、ゴースト(プロセス)を漂わせながらプロセス空間を探索できます。

ブログ記事も参照してください。

インタラクティブデモを試してみてください。

質問やディスカッションは、Discordサーバーにご参加ください。

スクリーンショット

[画像: ProcInShのデモ]

[画像: スペースビューのスクリーンショット]

[画像: 3Dでのプロセスのスクリーンショット]

[画像: プロセスの詳細のスクリーンショット]

[画像: プロセスリストのスクリーンショット]

使用方法

Linux x86-64が必要です。どちらのインストール方法もネイティブコードをコンパイルするため、Rust、Cコンパイラ、BPFバックエンドを持つclang、bpftool、pkg-config、libelfおよびzlibの開発ファイル、そして/sys/kernel/btf/vmlinuxにあるBTF情報が必要です。

WSL2でのサポートは非常に限定的です。crates.ioからインストールするのではなく、ソースからProcInShをビルドすることを推奨します。

crates.ioからインストール

crates.ioからProcInShをインストールして実行してください:

(申し訳ありませんが、Ubuntuを使用していると仮定しています。それ以外の場合は適宜解釈してください)

sudo apt-get install --yes --no-install-recommends \
         build-essential clang llvm pkg-config libelf-dev zlib1g-dev python3 \
         linux-tools-common linux-tools-generic
cargo install procinsh --locked

その後、実行してブラウザでhttp://127.0.0.1:9090を開いてください。リモートアクセスを許可するには--allow-non-loopbackを使用しますが、注意してください。これは認証なしにプロセスメモリと環境変数を公開します。

sudo "$HOME/.cargo/bin/procinsh" --listen 127.0.0.1:9090

sudoを使いたくない場合は、代わりにsetcapを使用してください。

sudo setcap \
  cap_sys_ptrace,cap_bpf,cap_perfmon,cap_dac_read_search,cap_sys_admin=ep \
  "$HOME/.cargo/bin/procinsh"
"$HOME/.cargo/bin/procinsh" --listen 127.0.0.1:9090

CAP_SYS_ADMINは、他のネットワーク名前空間でのUNIXソケットピア診断を有効にします。これがない場合、ProcInShは利用可能なソケット情報を保持し、欠落しているピア診断を警告として報告します。不明なピアは、接続されていないソケットを意味するわけではありません。

Linuxでのセルフビルド
Ubuntu

Node.js 22.12以降(npm付き)と、rustup経由のRustも必要です。Rustのバージョンとコンポーネントはrust-toolchain.tomlでピン留めされており、必要に応じてrustupが自動的にインストールします。

このリポジトリをクローンし、ルートディレクトリから以下を実行してください:

sudo apt-get install --yes --no-install-recommends \
         build-essential clang llvm pkg-config libelf-dev zlib1g-dev python3 \
         linux-tools-common linux-tools-generic
npm --prefix web ci
npm --prefix web run build
cargo build --release --locked

その後、実行します:

sudo ./target/release/procinsh --listen 127.0.0.1:9090
NixOS

rustup経由でRustをインストールした場合、リポジトリのルートにshell.nixを作成します:

{ pkgs ? import <nixpkgs> { } }:
pkgs.mkShell {
  packages = with pkgs; [ nodejs_22 clang llvm pkg-config elfutils zlib bpftools gnumake ];
  hardeningDisable = [ "all" ];
}

Nixシェル内でWebアセットとバイナリをビルドします:

nix-shell --run 'npm --prefix web ci --no-audit --no-fund && npm --prefix web run build && cargo build --release --locked'

バイナリは/nix/storeなどのライブラリにリンクします。これらの依存関係がnix-collect-garbageによって削除されないように、GCルートを作成します:

nix-build shell.nix -A inputDerivation -o .nix-gcroot

バイナリを使用中は.nix-gcrootを保持してください。その後、実行します:

sudo ./target/release/procinsh --listen 127.0.0.1:9090
WSL2(Ubuntu)でのビルド

Ubuntuのbpftoolラッパーは、WSL2カーネルのバージョンがUbuntuツールパッケージのバージョンと異なるため、bpftool not found for kernel ...というエラーが発生する場合があります。ラッパーをバイパスして、パッケージ化された実行可能ファイルにBPFTOOLを設定してください:

sudo apt-get update
sudo apt-get install --yes --no-install-recommends \
         build-essential clang llvm pkg-config libelf-dev zlib1g-dev python3 \
         linux-tools-common linux-tools-generic
for tool in /usr/lib/linux-tools/*/bpftool; do
    if [ -x "$tool" ]; then
        export BPFTOOL="$tool"
        break
    fi
done
"${BPFTOOL:?No packaged bpftool found; install linux-tools-generic}" version
"$BPFTOOL" btf dump file /sys/kernel/btf/vmlinux format c >/tmp/procinsh-vmlinux.h
npm --prefix web ci
npm --prefix web run build
cargo build --release --locked

その後、実行します:

sudo ./target/release/procinsh --listen 127.0.0.1:9090

さて、どこへ行こうか?プロセス空間は広大だ。